minecraft-data 3.30.0 → 3.32.0

package/.github/workflows/npm-publish.yml

@@ -3,6 +3,7 @@ on:
   push:
     branches:
       - master
+      - dependabot/npm_and_yarn/json-schema-to-typescript-12.0.0
   workflow_dispatch:
 jobs:
   npm-publish:

package/data.js

@@ -1203,8 +1203,8 @@ module.exports =
     '1.16.201': {
       get protocol () { return require("./minecraft-data/data/bedrock/1.16.201/protocol.json") },
       get steve () { return require("./minecraft-data/data/bedrock/1.16.201/steve.json") },
-      proto: __dirname + '/minecraft-data/data/bedrock/1.17.0/proto.yml',
-      types: __dirname + '/minecraft-data/data/bedrock/1.17.0/types.yml',
+      proto: __dirname + '/minecraft-data/data/bedrock/1.16.201/proto.yml',
+      types: __dirname + '/minecraft-data/data/bedrock/1.16.201/types.yml',
       get windows () { return require("./minecraft-data/data/bedrock/1.16.201/windows.json") },
       get enchantments () { return require("./minecraft-data/data/bedrock/1.16.201/enchantments.json") },
       get version () { return require("./minecraft-data/data/bedrock/1.16.201/version.json") }
@@ -1212,8 +1212,8 @@ module.exports =
     '1.16.210': {
       get protocol () { return require("./minecraft-data/data/bedrock/1.16.210/protocol.json") },
       get steve () { return require("./minecraft-data/data/bedrock/1.16.201/steve.json") },
-      proto: __dirname + '/minecraft-data/data/bedrock/1.17.0/proto.yml',
-      types: __dirname + '/minecraft-data/data/bedrock/1.17.0/types.yml',
+      proto: __dirname + '/minecraft-data/data/bedrock/1.16.210/proto.yml',
+      types: __dirname + '/minecraft-data/data/bedrock/1.16.210/types.yml',
       get enchantments () { return require("./minecraft-data/data/bedrock/1.16.201/enchantments.json") },
       get version () { return require("./minecraft-data/data/bedrock/1.16.210/version.json") }
     },
@@ -1225,8 +1225,8 @@ module.exports =
       get enchantments () { return require("./minecraft-data/data/bedrock/1.16.201/enchantments.json") },
       get steve () { return require("./minecraft-data/data/bedrock/1.16.201/steve.json") },
       get protocol () { return require("./minecraft-data/data/bedrock/1.16.220/protocol.json") },
-      proto: __dirname + '/minecraft-data/data/bedrock/1.17.0/proto.yml',
-      types: __dirname + '/minecraft-data/data/bedrock/1.17.0/types.yml',
+      proto: __dirname + '/minecraft-data/data/bedrock/1.16.220/proto.yml',
+      types: __dirname + '/minecraft-data/data/bedrock/1.16.220/types.yml',
       get version () { return require("./minecraft-data/data/bedrock/1.16.220/version.json") }
     },
     '1.17.0': {
@@ -1562,8 +1562,8 @@ module.exports =
       get steve () { return require("./minecraft-data/data/bedrock/1.16.201/steve.json") },
       get blocksB2J () { return require("./minecraft-data/data/bedrock/1.19.1/blocksB2J.json") },
       get blocksJ2B () { return require("./minecraft-data/data/bedrock/1.19.1/blocksJ2B.json") },
-      proto: __dirname + '/minecraft-data/data/bedrock/latest/proto.yml',
-      types: __dirname + '/minecraft-data/data/bedrock/latest/types.yml',
+      proto: __dirname + '/minecraft-data/data/bedrock/1.19.62/proto.yml',
+      types: __dirname + '/minecraft-data/data/bedrock/1.19.62/types.yml',
       get version () { return require("./minecraft-data/data/bedrock/1.19.62/version.json") }
     },
     '1.19.63': {
@@ -1583,9 +1583,51 @@ module.exports =
       get steve () { return require("./minecraft-data/data/bedrock/1.16.201/steve.json") },
       get blocksB2J () { return require("./minecraft-data/data/bedrock/1.19.1/blocksB2J.json") },
       get blocksJ2B () { return require("./minecraft-data/data/bedrock/1.19.1/blocksJ2B.json") },
+      proto: __dirname + '/minecraft-data/data/bedrock/1.19.62/proto.yml',
+      types: __dirname + '/minecraft-data/data/bedrock/1.19.62/types.yml',
+      get version () { return require("./minecraft-data/data/bedrock/1.19.63/version.json") }
+    },
+    '1.19.70': {
+      get blocks () { return require("./minecraft-data/data/bedrock/1.19.1/blocks.json") },
+      get blockStates () { return require("./minecraft-data/data/bedrock/1.19.1/blockStates.json") },
+      get blockCollisionShapes () { return require("./minecraft-data/data/bedrock/1.19.1/blockCollisionShapes.json") },
+      get biomes () { return require("./minecraft-data/data/bedrock/1.19.1/biomes.json") },
+      get entities () { return require("./minecraft-data/data/bedrock/1.19.1/entities.json") },
+      get items () { return require("./minecraft-data/data/bedrock/1.19.10/items.json") },
+      get recipes () { return require("./minecraft-data/data/bedrock/1.19.10/recipes.json") },
+      get instruments () { return require("./minecraft-data/data/bedrock/1.17.0/instruments.json") },
+      get materials () { return require("./minecraft-data/data/pc/1.17/materials.json") },
+      get enchantments () { return require("./minecraft-data/data/bedrock/1.19.1/enchantments.json") },
+      get effects () { return require("./minecraft-data/data/pc/1.17/effects.json") },
+      get protocol () { return require("./minecraft-data/data/bedrock/1.19.70/protocol.json") },
+      get windows () { return require("./minecraft-data/data/bedrock/1.16.201/windows.json") },
+      get steve () { return require("./minecraft-data/data/bedrock/1.16.201/steve.json") },
+      get blocksB2J () { return require("./minecraft-data/data/bedrock/1.19.1/blocksB2J.json") },
+      get blocksJ2B () { return require("./minecraft-data/data/bedrock/1.19.1/blocksJ2B.json") },
+      proto: __dirname + '/minecraft-data/data/bedrock/1.19.70/proto.yml',
+      types: __dirname + '/minecraft-data/data/bedrock/1.19.70/types.yml',
+      get version () { return require("./minecraft-data/data/bedrock/1.19.70/version.json") }
+    },
+    '1.19.80': {
+      get blocks () { return require("./minecraft-data/data/bedrock/1.19.1/blocks.json") },
+      get blockStates () { return require("./minecraft-data/data/bedrock/1.19.1/blockStates.json") },
+      get blockCollisionShapes () { return require("./minecraft-data/data/bedrock/1.19.1/blockCollisionShapes.json") },
+      get biomes () { return require("./minecraft-data/data/bedrock/1.19.1/biomes.json") },
+      get entities () { return require("./minecraft-data/data/bedrock/1.19.1/entities.json") },
+      get items () { return require("./minecraft-data/data/bedrock/1.19.10/items.json") },
+      get recipes () { return require("./minecraft-data/data/bedrock/1.19.10/recipes.json") },
+      get instruments () { return require("./minecraft-data/data/bedrock/1.17.0/instruments.json") },
+      get materials () { return require("./minecraft-data/data/pc/1.17/materials.json") },
+      get enchantments () { return require("./minecraft-data/data/bedrock/1.19.1/enchantments.json") },
+      get effects () { return require("./minecraft-data/data/pc/1.17/effects.json") },
+      get protocol () { return require("./minecraft-data/data/bedrock/1.19.80/protocol.json") },
+      get windows () { return require("./minecraft-data/data/bedrock/1.16.201/windows.json") },
+      get steve () { return require("./minecraft-data/data/bedrock/1.16.201/steve.json") },
+      get blocksB2J () { return require("./minecraft-data/data/bedrock/1.19.1/blocksB2J.json") },
+      get blocksJ2B () { return require("./minecraft-data/data/bedrock/1.19.1/blocksJ2B.json") },
       proto: __dirname + '/minecraft-data/data/bedrock/latest/proto.yml',
       types: __dirname + '/minecraft-data/data/bedrock/latest/types.yml',
-      get version () { return require("./minecraft-data/data/bedrock/1.19.63/version.json") }
+      get version () { return require("./minecraft-data/data/bedrock/1.19.80/version.json") }
     }
   }
 }

package/doc/api.md

@@ -54,6 +54,10 @@ Example:
 console.log(mcData.blocksByStateId[100]) // Object containing information for "Lava" (as Lava has a state range from 91 to 106)
 ```
 
+### mcData.blockMappings
+
+Contains a list of block mappings between pc/bedrock edition for the current Minecraft version
+
 ### mcData.blockStates
 
 **_Bedrock edition only_**

package/doc/history.md

@@ -1,5 +1,13 @@
 # History
 
+## 3.32.0
+
+* update `minecraft-data`
+
+## 3.31.0
+
+* update `minecraft-data`
+
 ## 3.30.0
 
 * update `minecraft-data`

package/index.d.ts

@@ -992,11 +992,15 @@ declare namespace MinecraftData {
   export interface IndexedData {
     isOlderThan(version: string): boolean
     isNewerOrEqualTo(version: string): boolean
-    
+  
     blocks: { [id: number]: Block }
     blocksByName: { [name: string]: Block }
     blocksByStateId: { [id: number]: Block }
     blocksArray: Block[]
+    blockMappings: {
+      pc: { name: string, states: Record<string, string | number> },
+      pe: { name: string, states: Record<string, string | number> }
+    }[]
     /**
      * Bedrock edition only
      */

package/lib/loader.js

@@ -7,7 +7,7 @@ function mcDataToNode (mcData) {
     blocksByName: indexes.blocksByName,
     blocksArray: mcData.blocks,
     blocksByStateId: indexes.blocksByStateId,
-
+    blockMappings: mcData.blockMappings,
     blockStates: mcData.blockStates, // bedrock
 
     blockCollisionShapes: mcData.blockCollisionShapes,

package/minecraft-data/README.md

@@ -10,7 +10,7 @@ Language independent module providing minecraft data for minecraft clients, serv
 Supports
 * Minecraft PC version 0.30c (classic), 1.7.10, 1.8.8, 1.9 (15w40b, 1.9, 1.9.1-pre2, 1.9.2, 1.9.4),
  1.10 (16w20a, 1.10-pre1, 1.10, 1.10.1, 1.10.2), 1.11 (16w35a, 1.11, 1.11.2), 1.12 (17w15a, 17w18b, 1.12-pre4, 1.12, 1.12.1, 1.12.2), 1.13 (17w50a, 1.13, 1.13.1, 1.13.2-pre1, 1.13.2-pre2, 1.13.2), 1.14 (1.14, 1.14.1, 1.14.3, 1.14.4), 1.15 (1.15, 1.15.1, 1.15.2), 1.16 (20w13b, 20w14a, 1.16-rc1, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5), 1.17, 1.17.1, 1.18 (1.18, 1.18.1, 1.18.2), 1.19 (1.19, 1.19.2, 1.19.3)
-* Minecraft bedrock version 0.14, 0.15, 1.0, 1.16.201, 1.16.210, 1.16.220, 1.17.0, 1.17.10, 1.17.30, 1.17.40, 1.18.0, 1.18.11, 1.18.30, 1.19.1, 1.19.10, 1.19.20, 1.19.21, 1.19.30, 1.19.40, 1.19.50, 1.19.60, 1.19.62, 1.19.63
+* Minecraft bedrock version 0.14, 0.15, 1.0, 1.16.201, 1.16.210, 1.16.220, 1.17.0, 1.17.10, 1.17.30, 1.17.40, 1.18.0, 1.18.11, 1.18.30, 1.19.1, 1.19.10, 1.19.20, 1.19.21, 1.19.30, 1.19.40, 1.19.50, 1.19.60, 1.19.62, 1.19.63, 1.19.70, 1.19.80
 
 ## Wrappers
 

package/minecraft-data/data/bedrock/1.16.201/proto.yml

@@ -1725,13 +1725,22 @@ packet_set_score:
    !bound: client
    entries: ScoreEntries
 
+# LabTable is sent by the client to let the server know it started a chemical reaction in Education Edition,
+# and is sent by the server to other clients to show the effects.
+# The packet is only functional if Education features are enabled.
 packet_lab_table:
    !id: 0x6d
    !bound: both
-   useless_byte: u8
-   lab_table_x: varint
-   lab_table_y: varint
-   lab_table_z: varint
+   # ActionType is the type of the action that was executed. It is one of the constants above. Typically,
+   # only LabTableActionCombine is sent by the client, whereas LabTableActionReact is sent by the server.
+   action_type: u8 =>
+      0: combine
+      1: react
+   # Position is the position at which the lab table used was located.
+   position: vec3i
+   # ReactionType is the type of the reaction that took place as a result of the items put into the lab
+   # table. The reaction type can be either that of an item or a particle, depending on whatever the result
+   # was of the reaction.
    reaction_type: u8
 
 packet_update_block_synced:

package/minecraft-data/data/bedrock/1.16.201/protocol.json

@@ -6194,20 +6194,21 @@
       "container",
       [
         {
-          "name": "useless_byte",
-          "type": "u8"
-        },
-        {
-          "name": "lab_table_x",
-          "type": "varint"
-        },
-        {
-          "name": "lab_table_y",
-          "type": "varint"
+          "name": "action_type",
+          "type": [
+            "mapper",
+            {
+              "type": "u8",
+              "mappings": {
+                "0": "combine",
+                "1": "react"
+              }
+            }
+          ]
         },
         {
-          "name": "lab_table_z",
-          "type": "varint"
+          "name": "position",
+          "type": "vec3i"
         },
         {
           "name": "reaction_type",

package/minecraft-data/data/bedrock/1.16.210/proto.yml

@@ -1793,13 +1793,22 @@ packet_set_score:
    !bound: client
    entries: ScoreEntries
 
+# LabTable is sent by the client to let the server know it started a chemical reaction in Education Edition,
+# and is sent by the server to other clients to show the effects.
+# The packet is only functional if Education features are enabled.
 packet_lab_table:
    !id: 0x6d
    !bound: both
-   useless_byte: u8
-   lab_table_x: varint
-   lab_table_y: varint
-   lab_table_z: varint
+   # ActionType is the type of the action that was executed. It is one of the constants above. Typically,
+   # only LabTableActionCombine is sent by the client, whereas LabTableActionReact is sent by the server.
+   action_type: u8 =>
+      0: combine
+      1: react
+   # Position is the position at which the lab table used was located.
+   position: vec3i
+   # ReactionType is the type of the reaction that took place as a result of the items put into the lab
+   # table. The reaction type can be either that of an item or a particle, depending on whatever the result
+   # was of the reaction.
    reaction_type: u8
 
 # UpdateBlockSynced is sent by the server to synchronise the falling of a falling block entity with the

package/minecraft-data/data/bedrock/1.16.210/protocol.json

@@ -6405,20 +6405,21 @@
       "container",
       [
         {
-          "name": "useless_byte",
-          "type": "u8"
-        },
-        {
-          "name": "lab_table_x",
-          "type": "varint"
-        },
-        {
-          "name": "lab_table_y",
-          "type": "varint"
+          "name": "action_type",
+          "type": [
+            "mapper",
+            {
+              "type": "u8",
+              "mappings": {
+                "0": "combine",
+                "1": "react"
+              }
+            }
+          ]
         },
         {
-          "name": "lab_table_z",
-          "type": "varint"
+          "name": "position",
+          "type": "vec3i"
         },
         {
           "name": "reaction_type",

package/minecraft-data/data/bedrock/1.16.220/proto.yml

@@ -9,6 +9,7 @@ ByteArray: ["buffer",{"countType":"varint"}]
 SignedByteArray: ["buffer",{"countType":"zigzag32"}]
 LittleString: ["pstring",{"countType":"li32"}]
 ShortArray: ["buffer",{"countType":"li16"}]
+ShortString: ["pstring",{"countType":"li16"}]
 varint64: native                                      # Some primitives
 zigzag32: native
 zigzag64: native
@@ -2140,7 +2141,7 @@ packet_lab_table:
       0: combine
       1: react
    # Position is the position at which the lab table used was located.
-   position: vec3u
+   position: vec3i
    # ReactionType is the type of the reaction that took place as a result of the items put into the lab
    # table. The reaction type can be either that of an item or a particle, depending on whatever the result
    # was of the reaction.

package/minecraft-data/data/bedrock/1.16.220/protocol.json

@@ -306,7 +306,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -316,7 +316,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -373,7 +373,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -383,7 +383,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         }
@@ -7167,7 +7167,7 @@
         },
         {
           "name": "position",
-          "type": "vec3u"
+          "type": "vec3i"
         },
         {
           "name": "reaction_type",
@@ -8595,6 +8595,12 @@
         "countType": "li16"
       }
     ],
+    "ShortString": [
+      "pstring",
+      {
+        "countType": "li16"
+      }
+    ],
     "MetadataFlags1": [
       "bitflags",
       {

package/minecraft-data/data/bedrock/1.16.220/types.yml

@@ -86,8 +86,8 @@ ItemExtraDataWithBlockingTick:
          version: u8
          nbt: lnbt
       default: void
-   can_place_on: ShortArray[]li32
-   can_destroy: ShortArray[]li32
+   can_place_on: ShortString[]li32
+   can_destroy: ShortString[]li32
    blocking_tick: li64
 
 ItemExtraDataWithoutBlockingTick:
@@ -99,8 +99,8 @@ ItemExtraDataWithoutBlockingTick:
          version: u8
          nbt: lnbt
       default: void
-   can_place_on: ShortArray[]li32
-   can_destroy: ShortArray[]li32
+   can_place_on: ShortString[]li32
+   can_destroy: ShortString[]li32
 
 # Same as below but without a "networkStackID" boolean
 ItemLegacy:

package/minecraft-data/data/bedrock/1.17.0/proto.yml

@@ -9,6 +9,7 @@ ByteArray: ["buffer",{"countType":"varint"}]
 SignedByteArray: ["buffer",{"countType":"zigzag32"}]
 LittleString: ["pstring",{"countType":"li32"}]
 ShortArray: ["buffer",{"countType":"li16"}]
+ShortString: ["pstring",{"countType":"li16"}]
 varint64: native                                      # Some primitives
 zigzag32: native
 zigzag64: native
@@ -2142,7 +2143,7 @@ packet_lab_table:
       0: combine
       1: react
    # Position is the position at which the lab table used was located.
-   position: vec3u
+   position: vec3i
    # ReactionType is the type of the reaction that took place as a result of the items put into the lab
    # table. The reaction type can be either that of an item or a particle, depending on whatever the result
    # was of the reaction.

package/minecraft-data/data/bedrock/1.17.0/protocol.json

@@ -310,7 +310,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -320,7 +320,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -377,7 +377,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -387,7 +387,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         }
@@ -7246,7 +7246,7 @@
         },
         {
           "name": "position",
-          "type": "vec3u"
+          "type": "vec3i"
         },
         {
           "name": "reaction_type",
@@ -8705,6 +8705,12 @@
         "countType": "li16"
       }
     ],
+    "ShortString": [
+      "pstring",
+      {
+        "countType": "li16"
+      }
+    ],
     "MetadataFlags1": [
       "bitflags",
       {

package/minecraft-data/data/bedrock/1.17.0/types.yml

@@ -87,8 +87,8 @@ ItemExtraDataWithBlockingTick:
          version: u8
          nbt: lnbt
       default: void
-   can_place_on: ShortArray[]li32
-   can_destroy: ShortArray[]li32
+   can_place_on: ShortString[]li32
+   can_destroy: ShortString[]li32
    blocking_tick: li64
 
 ItemExtraDataWithoutBlockingTick:
@@ -100,8 +100,8 @@ ItemExtraDataWithoutBlockingTick:
          version: u8
          nbt: lnbt
       default: void
-   can_place_on: ShortArray[]li32
-   can_destroy: ShortArray[]li32
+   can_place_on: ShortString[]li32
+   can_destroy: ShortString[]li32
 
 # Same as below but without a "networkStackID" boolean
 ItemLegacy:

package/minecraft-data/data/bedrock/1.17.10/proto.yml

@@ -9,6 +9,7 @@ ByteArray: ["buffer",{"countType":"varint"}]
 SignedByteArray: ["buffer",{"countType":"zigzag32"}]
 LittleString: ["pstring",{"countType":"li32"}]
 ShortArray: ["buffer",{"countType":"li16"}]
+ShortString: ["pstring",{"countType":"li16"}]
 varint64: native                                      # Some primitives
 zigzag32: native
 zigzag64: native
@@ -2239,7 +2240,7 @@ packet_lab_table:
       0: combine
       1: react
    # Position is the position at which the lab table used was located.
-   position: vec3u
+   position: vec3i
    # ReactionType is the type of the reaction that took place as a result of the items put into the lab
    # table. The reaction type can be either that of an item or a particle, depending on whatever the result
    # was of the reaction.

package/minecraft-data/data/bedrock/1.17.10/protocol.json

@@ -310,7 +310,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -320,7 +320,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -377,7 +377,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         },
@@ -387,7 +387,7 @@
             "array",
             {
               "countType": "li32",
-              "type": "ShortArray"
+              "type": "ShortString"
             }
           ]
         }
@@ -7362,7 +7362,7 @@
         },
         {
           "name": "position",
-          "type": "vec3u"
+          "type": "vec3i"
         },
         {
           "name": "reaction_type",
@@ -8879,6 +8879,12 @@
         "countType": "li16"
       }
     ],
+    "ShortString": [
+      "pstring",
+      {
+        "countType": "li16"
+      }
+    ],
     "MetadataFlags1": [
       "bitflags",
       {

package/minecraft-data/data/bedrock/1.17.10/types.yml

@@ -87,8 +87,8 @@ ItemExtraDataWithBlockingTick:
          version: u8
          nbt: lnbt
       default: void
-   can_place_on: ShortArray[]li32
-   can_destroy: ShortArray[]li32
+   can_place_on: ShortString[]li32
+   can_destroy: ShortString[]li32
    blocking_tick: li64
 
 ItemExtraDataWithoutBlockingTick:
@@ -100,8 +100,8 @@ ItemExtraDataWithoutBlockingTick:
          version: u8
          nbt: lnbt
       default: void
-   can_place_on: ShortArray[]li32
-   can_destroy: ShortArray[]li32
+   can_place_on: ShortString[]li32
+   can_destroy: ShortString[]li32
 
 # Same as below but without a "networkStackID" boolean
 ItemLegacy:

package/minecraft-data/data/bedrock/1.17.30/proto.yml

@@ -9,6 +9,7 @@ ByteArray: ["buffer",{"countType":"varint"}]
 SignedByteArray: ["buffer",{"countType":"zigzag32"}]
 LittleString: ["pstring",{"countType":"li32"}]
 ShortArray: ["buffer",{"countType":"li16"}]
+ShortString: ["pstring",{"countType":"li16"}]
 varint64: native                                      # Some primitives
 zigzag32: native
 zigzag64: native
@@ -2260,7 +2261,7 @@ packet_lab_table:
       0: combine
       1: react
    # Position is the position at which the lab table used was located.
-   position: vec3u
+   position: vec3i
    # ReactionType is the type of the reaction that took place as a result of the items put into the lab
    # table. The reaction type can be either that of an item or a particle, depending on whatever the result
    # was of the reaction.