prismarine-block

prismarine-block

Represent a minecraft block with its associated data

Usage

const registry = require('prismarine-registry')('1.8')
const Block = require('prismarine-block')(registry)

const stoneBlock = new Block(registry.blocksByName.stone, registry.biomesByName.plains, /* meta */ 0)

console.log(stoneBlock)

// can you harvest stone with an iron pickaxe?
console.log(stoneBlock.canHarvest(257))

// how many milliseconds does it takes in usual conditions? (on ground, not in water and not in creative mode)
console.log(stoneBlock.digTime(257))

API

See doc/API.md

History

1.23.0

• Update CI to Node 24 (#121) (thanks @rom1504)
• Fix publish condition for npm-publish v4 (#120) (thanks @rom1504)
• Switch to trusted publishing via OIDC (#119) (thanks @rom1504)
• Change boundingBox to an enum (#117) (thanks @linkle69)

1.22.0

• Update sign blockEntity for 1.21.5 (#115) (thanks @extremeheat)
• Bump expect from 29.7.0 to 30.0.5 (#114) (thanks @dependabot[bot])
• node 22 (#108) (thanks @rom1504)
• Issue/102 (#103) (thanks @tabbry)

1.21.0

• Add isWaterlogged to API (#105) (thanks @extremeheat)

1.20.0

• Bump mocha from 10.8.2 to 11.0.1 (#104) (thanks @dependabot[bot])
• Add support for Bedrock edition block hashes (#97) (thanks @FreezeEngine)

1.19.0

• Update npm-publish.yml (thanks @rom1504)

1.18.0

• Fix false value handling in fromProperties for post flatenning versions (#98) (thanks @zardoy)
• fix version used in block entity (#99) (thanks @rom1504)
• Allow two variations of syntax in fromString (#96) (thanks @Flonja)

1.17.1

• Export Block class declaration (#91) (thanks @IceTank)
• Bump standard from 16.0.4 to 17.1.0 (#83) (thanks @dependabot[bot])
• use nmd supportFeature (#60) (thanks @u9g)
• Add command gh workflow allowing to use release command in comments (#90) (thanks @rom1504)

1.17.0

• Support for multi-sided signs (thanks @PondWader)

1.16.3

• really

1.16.2

• correct

1.16.1

• fix mcdata dep

1.15.0

• Effect names were normalized
• Metadata to 0 by default

1.14.1

• Legacy version fixes

1.14.0

• Add .stateId, .fromProperties, .getProps for all versions

1.13.1

• Change blockEntity version handling

1.13.0

• Add sign block entity implementation

1.12.0

• Updated to support prismarine-registry. To use, instead of passing a string to prismarine-biome's default function export, pass an instance of prismarine-registry.
• block entity support

1.11.0

• support bedrock

1.10.3

• use normalized enchant rather than custom format (@u9g #41)

1.10.2

• remove debug code

1.10.1

• Fix ternary operator for bedrock name check

1.10.0

• 1.17.0 support (thanks @Archengius and @the9g)

1.9.0

• added block.getProperties() type definitions.
• added instant breaking support
• added Block.fromProperties() constructor.

1.8.0

• Efficiency fix on versions below 1.13

1.7.3

• Fix effectLevel not working in digTime. (@Naomi-alt)

1.7.2

• add testing for shapes, make it more robust to missing data

1.7.1

• fix canHarvest when no harvestTools required (thanks @Garfield100)

1.7.0

• Add getProperties (thanks @Karang)

1.6.0

• Add enchantments and effects to dig time computation (thanks @Karang)

1.5.1

• Make Block.fromStateId work for all versions

1.5.0

• Fix block metadata for 1.13+

1.4.0

• add block shapes (thanks @Karang)

1.3.0

• add typescript definitions (thanks @IdanHo)

1.2.0

• Prevent data from being shared to avoid conflicts across multiple versions (thanks @hornta)

1.1.1

• use the minStateId if passing the blockType

1.1.0

• add block state id feature (for >= 1.13)

1.0.1

• bump mcdata

1.0.0

• bump dependencies

0.1.0

• Import from mineflayer