@serenityjs/block NPM

Introduction

This package contains the Minecraft Bedrock Edition BlockTypes, BlockPermutations, and BlockIdentifiers. The classes are developed in a way to resemble the official Bedrock Edition Scripting API. This choice was to bring familiarity to the SerenityJS ecosystem for developers making the switch from the official Bedrock Dedicated Server.

BlockType

BlockType represents a block type in the game, which hold all possible permutations the block can have.

import { BlockType, BlockIdentifier } from "@serenityjs/block"

// Get the block type for dirt
const dirtType = BlockType.get(BlockIdentifier.Dirt)

// Get the identifier of the type
dirtType.identifier // Expected to be "minecraft:dirt"

BlockPermutation

BlockPermutation represents a current state of a block, for example dirt has a single state "dirt_type". This state can be changed to "coarse" or "normal" to represent a different state of dirt. This means dirt has a total of 2 permutations, one for "coarse" and one for "normal".

import { BlockPermutation, BlockIdentifier } from "@serenityjs/block"

// Get the block permutation for coarse dirt
const coarseDirtPermutation = BlockPermutation.resolve(BlockIdentifier.Dirt, { dirt_type: "coarse" })

// Get the block type for coarse dirt permutation
// Which is expected to be "minecraft:dirt"
const blockType = coarseDirtPermutation.type // Equivalent to BlockType.get(BlockIdentifier.Dirt)

// Get the block state for coarse dirt permutation
coarseDirtPermutation.state // Expected to be { dirt_type: "coarse" }

CustomBlockType

Registering a Custom Block

CustomBlockType allows developers to create and register custom blocks to SerenityJS. Custom blocks can also be registered with permutations, which allows developers to create multiple variations of a block.

import { CustomBlockType, BlockPermutation } from "@serenityjs/block"

// Creates a custom block type with the identifier "serenity:ruby_block"
// Second parameter is indicates if the block can be waterlogged
const rubyBlockType = new CustomBlockType("serenity:ruby_block", false)

// Create a permutation for the block type
// Blank object indicates that the block has no additional permutations
const rubyBlockPermutation = BlockPermutation.create(rubyBlockType, {})

// The permutation now must be registered with the block type
rubyBlockType.register(rubyBlockPermutation)

Resolving a Custom Block

import { CustomBlockType } from "@serenityjs/block"

// Get the custom block previously registered
const rubyBlockType = CustomBlockType.get("serenity:ruby_block")

// Get the block type identifier
rubyBlockType.identifier // Expected to be "serenity:ruby_block"

// Get the permutation of the block type
rubyBlockType.permutations // Expected to be an array with a length of 1

@serenityjs/nbt @serenityjs/data @serenityjs/binarystream

@sanctumterra/client @serenityjs/serenity @serenityjs/world @serenityjs/item

0.6.0-beta-20241002232459

9 months ago

0.6.0-beta-20241005152757

9 months ago

0.6.0-beta-20241003211448

9 months ago

0.6.0-beta-20241004044157

9 months ago

0.6.0-beta-20241004204942

9 months ago

0.6.0-beta-20241004212448

9 months ago

0.6.0-beta-20241004211405

9 months ago

0.6.0-beta-20241002205944

9 months ago

0.5.2-beta-20240924154401

9 months ago

0.5.2

9 months ago

0.5.2-beta-20240924164734

9 months ago

0.5.2-beta-20240925011541

9 months ago

0.5.2-beta-20240924181805

9 months ago

0.5.1-beta-20240919231515

9 months ago

0.3.6-beta-20240625210047

12 months ago

0.2.4-beta-20240528033553

1 year ago

0.4.4-beta-20240824174822

10 months ago

0.3.6-beta-20240707053334

12 months ago

0.5.0-beta-20240901052149

10 months ago

0.4.3-beta-20240820041423

10 months ago

0.4.0-beta-20240711203821

12 months ago

0.2.3-beta-20240527004246

1 year ago

0.3.4-beta-20240612041552

1 year ago

0.4.1-beta-20240731201322

11 months ago

0.3.6-beta-20240621191500

1 year ago

0.4.3-beta-20240818191831

10 months ago

0.4.0-beta-20240716213805

11 months ago

0.2.4-beta-20240601050055

1 year ago

0.3.2-beta-20240609054606

1 year ago

0.3.6-beta-20240626211136

12 months ago

0.5.0-beta-20240830035447

10 months ago

0.3.4-beta-20240611221835

1 year ago

0.4.1-beta-20240722040841

11 months ago

0.4.1-beta-20240722204640

11 months ago

0.5.0-beta-20240829230104

10 months ago

0.4.4-beta-20240827211831

10 months ago

0.4.3-beta-20240814075643

10 months ago

0.5.1-beta-20240918010653

9 months ago

0.3.0-beta-20240604012528

1 year ago

0.4.0-beta-20240710012218

12 months ago

0.5.1-beta-20240920235820

9 months ago

0.2.4-beta-20240531034203

1 year ago

0.5.0-beta-20240903035918

10 months ago

0.5.0-beta-20240901034521

10 months ago

0.2.3-beta-20240522190240

1 year ago

0.3.1-beta-20240606051915

1 year ago

0.5.0-beta-20240831000452

10 months ago

0.3.1-beta-20240604185231

1 year ago

0.5.0-beta-20240902220626

10 months ago

0.4.4-beta-20240823232612

10 months ago

0.4.2-beta-20240810174319

11 months ago

0.3.1-beta-20240606184221

1 year ago

0.3.1-beta-20240609032019

1 year ago

0.3.6-beta-20240620192754

1 year ago

0.5.1-beta-20240920024412

9 months ago

0.4.0-beta-20240708033436

12 months ago

0.3.6-beta-20240630061324

12 months ago

0.5.1-beta-20240916023948

9 months ago

0.5.0-beta-20240904091825

10 months ago

0.3.6-beta-20240627221339

12 months ago

0.5.1-beta-20240915195437

9 months ago

0.5.2-beta-20240922061320

9 months ago

0.4.4-beta-20240822221510

10 months ago

0.4.2-beta-20240810215515

11 months ago

0.4.1-beta-20240722203603

11 months ago

0.4.1-beta-20240810034645

11 months ago

0.4.3-beta-20240820182507

10 months ago

0.5.0-beta-20240828234542

10 months ago

0.4.1-beta-20240722210137

11 months ago

0.5.0-beta-20240831075155

10 months ago

0.5.0

10 months ago

0.5.1

9 months ago

0.5.0-beta-20240903000912

10 months ago

0.5.1-beta-20240921045345

9 months ago

0.5.0-beta-20240904095058

10 months ago

0.4.1-beta-20240717051407

11 months ago

0.2.3-beta-20240526235018

1 year ago

0.4.3-beta-20240815052641

10 months ago

0.3.6-beta-20240617034149

1 year ago

0.4.1-beta-20240806063352

11 months ago

0.4.1-beta-20240807000541

11 months ago

0.4.0-beta-20240715211512

11 months ago

0.2.3-beta-20240524041737

1 year ago

0.2.4-beta-20240601145215

1 year ago

0.5.1-beta-20240915233340

9 months ago

0.4.4-beta-20240825044235

10 months ago

0.4.2-beta-20240811033355

11 months ago

0.5.1-beta-20240916024949

9 months ago

0.4.1-beta-20240806002741

11 months ago

0.4.1-beta-20240809180235

11 months ago

0.4.1-beta-20240722213549

11 months ago

0.3.4-beta-20240613185708

1 year ago

0.3.6-beta-20240617024208

1 year ago

0.4.1-beta-20240801210011

11 months ago

0.2.3-beta-20240526234347

1 year ago

0.5.1-beta-20240918205549

9 months ago

0.4.1-beta-20240807023416

11 months ago

0.4.1-beta-20240806034430

11 months ago

0.2.4-beta-20240602051650

1 year ago

0.5.0-beta-20240829214050

10 months ago

0.2.4-beta-20240529224507

1 year ago

0.4.4-beta-20240827212052

10 months ago

0.4.1-beta-20240801224533

11 months ago

0.2.3-beta-20240527011718

1 year ago

0.3.5-beta-20240615210159

1 year ago

0.3.5-beta-20240615173145

1 year ago

0.3.5-beta-20240614031224

1 year ago

0.3.1-beta-20240607193905

1 year ago

0.4.3-beta-20240821150613

10 months ago

0.4.2-beta-20240811032915

11 months ago

0.4.4-beta-20240825221233

10 months ago

0.4.1-beta-20240806192054

11 months ago

0.4.0-beta-20240711225416

12 months ago

0.3.5-beta-20240615174127

1 year ago

0.2.4-beta-20240527221036

1 year ago

0.4.4-beta-20240823221008

10 months ago

0.4.4-beta-20240825045228

10 months ago

0.2.4-beta-20240527052243

1 year ago

0.5.0-beta-20240903234741

10 months ago

0.3.3-beta-20240610230957

1 year ago

0.4.1-beta-20240717053624

11 months ago

0.5.0-beta-20240903220312

10 months ago

0.4.1-beta-20240808225110

11 months ago

0.2.4-beta-20240527234340

1 year ago

0.4.3-beta-20240817235525

10 months ago

0.4.3-beta-20240820201805

10 months ago

0.3.6-beta-20240617194124

1 year ago

0.5.2-beta-20240923020825

9 months ago

0.3.5-beta-20240613224119

1 year ago

0.3.4-beta-20240613001837

1 year ago

0.3.2-beta-20240609052055

1 year ago

0.5.0-beta-20240831042810

10 months ago

0.4.0-beta-20240709215043

12 months ago

0.5.2-beta-20240922050841

9 months ago

0.5.1-beta-20240919031711

9 months ago

0.5.0-beta-20240903230003

10 months ago

0.4.1-beta-20240717170823

11 months ago

0.4.0-beta-20240709205231

12 months ago

0.4.4-beta-20240827191051

10 months ago

0.4.1-beta-20240729204032

11 months ago

0.4.3-beta-20240820153244

10 months ago

0.3.4-beta-20240613044622

1 year ago

0.4.1-beta-20240808223115

11 months ago

0.4.1-beta-20240731192105

11 months ago

0.4.0-beta-20240714051237

12 months ago

0.5.0-beta-20240902061821

10 months ago

0.3.4-beta-20240611215331

1 year ago

0.4.1-beta-20240806201251

11 months ago

0.4.1-beta-20240717023703

11 months ago

0.3.6-beta-20240624190519

12 months ago

0.5.1-beta-20240919175014

9 months ago

0.5.1-beta-20240915214413

9 months ago

0.5.0-beta-20240904091544

10 months ago

0.4.2-beta-20240810193104

11 months ago

0.4.1-beta-20240720011918

11 months ago

0.4.1-beta-20240806012611

11 months ago

0.4.1-beta-20240718184110

11 months ago

0.5.1-beta-20240921171632

9 months ago

0.2.3-beta-20240526234658

1 year ago

0.4.1-beta-20240805233112

11 months ago

0.5.0-beta-20240828143012

10 months ago

0.4.0-beta-20240707233623

12 months ago

0.4.1-beta-20240722211620

11 months ago

0.4.3-beta-20240820040544

10 months ago

0.3.6-beta-20240702043826

12 months ago

0.4.0-beta-20240709195404

12 months ago

0.4.1-beta-20240730002449

11 months ago

0.4.3-beta-20240819015204

10 months ago

0.5.1-beta-20240917181729

9 months ago

0.3.0-beta-20240602214627

1 year ago

0.5.2-beta-20240923211313

9 months ago

0.3.5-beta-20240614042048

1 year ago

0.5.1-beta-20240917192725

9 months ago

0.3.4-beta-20240612013029

1 year ago

0.4.0-beta-20240708212326

12 months ago

0.4.1-beta-20240801005028

11 months ago

0.5.0-beta-20240904235039

10 months ago

0.2.3-beta-20240525015937

1 year ago

0.5.1-beta-20240915201114

9 months ago

0.5.0-beta-20240901040459

10 months ago

0.4.3-beta-20240819042923

10 months ago

0.4.1-beta-20240730232323

11 months ago

0.4.0-beta-20240708030531

12 months ago

0.4.2-beta-20240812021503

11 months ago

0.5.0-beta-20240903013343

10 months ago

0.4.1-beta-20240808215817

11 months ago

0.4.4-beta-20240821214111

10 months ago

0.4.0-beta-20240714021921

12 months ago

0.2.3-beta-20240525233544

1 year ago

0.5.1-beta-20240918152239

9 months ago

0.5.0-beta-20240831074557

10 months ago

0.2.3-beta-20240525161226

1 year ago

0.5.1-beta-20240915205623

9 months ago

0.2.3-beta-20240522233103

1 year ago

0.3.1-beta-20240606220619

1 year ago

0.5.0-beta-20240831005005

10 months ago

0.5.0-beta-20240829163035

10 months ago

0.3.6-beta-20240630055544

12 months ago

0.2.3-beta-20240527001525

1 year ago

0.4.1-beta-20240808210024

11 months ago

0.5.0-beta-20240904151326

10 months ago

0.3.6-beta-20240617024945

1 year ago

0.4.1-beta-20240718045717

11 months ago

0.2.3-beta-20240526233557

1 year ago

0.4.0-beta-20240715031808

11 months ago

0.3.6-beta-20240619030040

1 year ago

0.4.4-beta-20240824042705

10 months ago

0.4.0-beta-20240711040448

12 months ago

0.4.1-beta-20240808224418

11 months ago

0.5.0-beta-20240903234430

10 months ago

0.2.3-beta-20240526222759

1 year ago

0.3.6-beta-20240628231617

12 months ago

0.4.2-beta-20240810045614

11 months ago

0.4.3-beta-20240814090345

10 months ago

0.4.4-beta-20240824211155

10 months ago

0.3.1-beta-20240605210615

1 year ago

0.3.1-beta-20240606191021

1 year ago

0.5.0-beta-20240904203750

10 months ago

0.4.0-beta-20240715032912

11 months ago

0.3.6-beta-20240617183403

1 year ago

0.5.2-beta-20240922044730

9 months ago

0.4.2-beta-20240810040238

11 months ago

0.5.0-beta-20240903034108

10 months ago

0.4.4-beta-20240821225153

10 months ago

0.3.6-beta-20240703201344

12 months ago

0.4.4-beta-20240825051412

10 months ago

0.5.0-beta-20240903035422

10 months ago

0.2.3-beta-20240526233842

1 year ago

0.4.1-beta-20240717055334

11 months ago

0.2.3-beta-20240527004725

1 year ago

0.4.4-beta-20240824165234

10 months ago

0.4.0-beta-20240708201247

12 months ago

0.4.4-beta-20240825083734

10 months ago

0.5.1-beta-20240915204446

9 months ago

0.4.1-beta-20240805224233

11 months ago

0.4.1-beta-20240805165718

11 months ago

0.4.1-beta-20240805215511

11 months ago

0.4.1-beta-20240723185758

11 months ago

0.4.0-beta-20240716035110

11 months ago

0.2.3-beta-20240526040806

1 year ago

0.4.4-beta-20240828003527

10 months ago

0.3.6-beta-20240630055312

12 months ago

0.5.0-beta-20240904213741

10 months ago

0.5.0-beta-20240903235320

10 months ago

0.4.1-beta-20240725173828

11 months ago

0.4.3-beta-20240820184355

10 months ago

0.5.0-beta-20240902062844

10 months ago

0.3.1-beta-20240604183653

1 year ago

0.2.3-beta-20240526190926

1 year ago

0.4.2-beta-20240810064204

11 months ago

0.4.3-beta-20240814025852

10 months ago

0.4.3-beta-20240817023140

10 months ago

0.3.1-beta-20240608063625

1 year ago

0.5.0-beta-20240830194647

10 months ago

0.2.3-beta-20240526232724

1 year ago

0.4.4-beta-20240823204019

10 months ago

0.3.6-beta-20240628213244

12 months ago

0.4.0-beta-20240715195802

11 months ago

0.5.2-beta-20240923231917

9 months ago

0.4.3-beta-20240815103552

10 months ago

0.4.0-beta-20240716000707

11 months ago

0.4.1-beta-20240723003603

11 months ago

0.4.4-beta-20240828002602

10 months ago

0.3.0

1 year ago

0.4.1-beta-20240719205425

11 months ago

0.4.2-beta-20240814010331

10 months ago

0.3.6

12 months ago

0.3.5

1 year ago

0.3.4-beta-20240611235828

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

0.3.3-beta-20240611195516

1 year ago

0.4.2-beta-20240813200021

10 months ago

0.2.4-beta-20240527232841

1 year ago

0.2.4-beta-20240530210858

1 year ago

0.2.4-beta-20240528032638

1 year ago

0.3.4-beta-20240611234747

1 year ago

0.5.0-beta-20240829213423

10 months ago

0.4.0-beta-20240711211058

12 months ago

0.4.1-beta-20240717163620

11 months ago

0.3.6-beta-20240630061811

12 months ago

0.4.1-beta-20240808193015

11 months ago

0.5.2-beta-20240922055855

9 months ago

0.5.0-beta-20240904084345

10 months ago

10 months ago

11 months ago

11 months ago

10 months ago

10 months ago

0.4.4-beta-20240821203149

10 months ago

0.5.0-beta-20240903013943

10 months ago

0.5.2-beta-20240923023649

9 months ago

0.4.3-beta-20240819021300

10 months ago

0.3.6-beta-20240624180050

1 year ago

0.5.0-beta-20240905154132

10 months ago

0.5.0-beta-20240903031220

10 months ago

0.5.1-beta-20240917162659

9 months ago

0.5.0-beta-20240902055942

10 months ago

0.5.0-beta-20240831023513

10 months ago

0.4.1-beta-20240730020100

11 months ago

0.5.1-beta-20240919231825

9 months ago

0.4.2-beta-20240811184728

11 months ago

0.5.0-beta-20240903172649

10 months ago

0.3.6-beta-20240626202340

12 months ago

0.5.1-beta-20240916215950

9 months ago

0.5.0-beta-20240904075925

10 months ago

0.5.0-beta-20240901035750

10 months ago

0.3.6-beta-20240627172133

12 months ago

0.2.4-beta-20240601202508

1 year ago

0.4.2-beta-20240811055205

11 months ago

0.4.0-beta-20240707213653

12 months ago

0.4.3-beta-20240820174829

10 months ago

0.5.1-beta-20240917032028

9 months ago

0.4.3-beta-20240818225958

10 months ago

0.5.1-beta-20240921175107

9 months ago

0.4.4-beta-20240825055525

10 months ago

0.5.0-beta-20240903235042

10 months ago

0.5.1-beta-20240921024146

9 months ago

0.4.1-beta-20240725000348

11 months ago

0.5.1-beta-20240917024529

9 months ago

0.3.5-beta-20240615173833

1 year ago

0.3.1-beta-20240606042832

1 year ago

0.4.1-beta-20240723000255

11 months ago

0.4.1-beta-20240717174202

11 months ago

0.4.0-beta-20240713215515

12 months ago

0.3.6-beta-20240622024315

1 year ago

0.3.6-beta-20240618191158

1 year ago

0.3.6-beta-20240615212113

1 year ago

0.5.2-beta-20240923012620

9 months ago

0.2.3-beta-20240525232041

1 year ago

0.2.3

1 year ago

0.4.1-beta-20240717162208

11 months ago

0.2.4

1 year ago

0.2.3-beta-20240521011808

1 year ago

0.2.3-beta-20240516062224

1 year ago

0.2.3-beta-20240516061409

1 year ago

0.2.3-beta-20240516053539

1 year ago

0.2.3-beta-20240516143349

1 year ago

0.2.2-beta-20240513211404

1 year ago

0.2.3-beta-20240514035802

1 year ago

0.2.3-beta-20240513213858

1 year ago

0.2.2

1 year ago

0.2.3-beta-20240513232537

1 year ago

0.2.2-beta-20240513033717

1 year ago

0.2.2-beta-20240512222837

1 year ago

0.2.2-beta-20240511202622

1 year ago

0.2.2-beta-20240505025701

1 year ago

0.2.2-beta-20240502180459

1 year ago

0.2.2-beta-20240501203139

1 year ago

0.2.2-beta-20240501035814

1 year ago

0.2.2-beta-20240430195009

1 year ago

0.2.2-beta-20240430005134

1 year ago

0.2.2-beta-20240429214513

1 year ago

0.2.2-beta-20240428205839

1 year ago

0.2.1-beta-20240427151951

1 year ago

0.2.1-beta-20240427153651

1 year ago

0.2.1-beta-20240427152301

1 year ago

0.2.1

1 year ago

0.2.2-beta-20240427171137

1 year ago

0.2.1-beta-20240426045829

1 year ago

0.2.1-beta-20240425011843

1 year ago

0.2.1-beta-20240424204755

1 year ago

0.2.1-beta-20240424194656

1 year ago

0.2.1-beta-20240423171356

1 year ago

0.2.1-beta-20240423045438

1 year ago

0.1.0-beta-20240422171939

1 year ago

0.1.4-beta-20240422215829

1 year ago

0.2.1-beta-20240422222350

1 year ago

0.1.4-beta-20240422220259

1 year ago

0.1.3-beta-20240422202710

1 year ago

0.1.3-beta-20240422202413

1 year ago

0.1.1-beta-20240422191309

1 year ago

0.1.2-beta-20240422200120

1 year ago

0.1.0

1 year ago

0.2.1-beta-20240422231811

1 year ago

0.1.2

1 year ago

0.2.0

1 year ago

0.1.1

1 year ago

0.2.0-beta-20240422221449

1 year ago

0.1.4

1 year ago

0.1.3

1 year ago

0.0.1-beta-20240415201734

1 year ago

0.0.1-beta-20240416023801

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago