@serenityjs/item NPM

Introduction

This package contains the Minecraft Bedrock Edition ItemTypes, CustomItemTypes, CreativeItems, and ItemIdentifiers. 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.

ItemType

ItemType represents a item type in the game, which holds a possible block type. If the item identifier, for example, is "minecraft:diamond", the type is expected to not hold a block type property.

import { ItemType, ItemIdentifier } from "@serenityjs/item"

// Get the ItemType for dirt, which will contain a BlockType
const dirtItemType = ItemType.get(ItemIdentifier.Dirt)

// Get the identifier for the dirt item
dirtItemType.identifier // Expected to be "minecraft:dirt"

// Get the BlockType for the dirt block
dirtItemType.block // Expected to be BlockType.get(BlockIdentifier.Dirt)

// Get the ItemType for diamond, which will not contain a BlockType
const diamondItemType = ItemType.get(ItemIdentifier.Diamond)

// Get the identifier for the diamond item
diamondItemType.identifier // Expected to be "minecraft:diamond"

// Get the BlockType for the diamond block
diamondItemType.block // Expected to be "undefined"

CustomItemType

Registering a Custom Item

CustomItemType allows developers to create and register custom items to SerenityJS. Custom items will also be automatically registered to the CreativeItem registery. Custom items can also be registered with a CustomBlockType.

import { CustomItemType, CreativeItem } from "@serenityjs/item"

// Create a new CustomItemType and register it to the creative inventory
// Without providing a category or a group, the item will not be displayed in the creative inventory
const rubyItemType = new CustomItemType("serenity:ruby")

// Register the custom item to the creative inventory
CreativeItem.register(rubyItemType, 0)

Registering a Custom Item with a Custom Block

import { CustomBlockType } from "@serenityjs/block"
import { CustomItemType } from "@serenityjs/item"

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

// Create a new custom item with the custom block type
// Since a item category was given, the item will be added to the creative inventory
const rubyBlockItemType = new CustomItemType("serenity:ruby_block", rubyBlockType, ItemCategory.Construction, ItemGroup.Ore)

// Get the custom item identifier
rubyBlockItemType.identifier // Expected to be "serenity:ruby_block"

// Get the custom block type
rubyBlockItemType.block // Expected to be CustomBlockType.get("serenity:ruby_block")

Resolving a Custom Item

import { CustomItemType } from "@serenityjs/item"

// Get the custom item previously registered
const rubyItemType = CustomItemType.get("serenity:ruby")

// Get the item type identifier
rubyItemType.identifier // Expected to be "serenity:ruby"

// Get the item type of the item type
rubyItemType.block // Expected to be "undefined"

@serenityjs/nbt @serenityjs/data @serenityjs/block @serenityjs/protocol @serenityjs/binarystream

@serenityjs/serenity @serenityjs/world

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

11 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

12 months 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

11 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

10 months ago

0.3.1-beta-20240606184221

1 year ago

0.3.1-beta-20240609032019

1 year ago

0.3.6-beta-20240620192754

12 months 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

10 months ago

0.4.1-beta-20240722203603

11 months ago

0.4.1-beta-20240810034645

10 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

10 months ago

0.5.1-beta-20240916024949

9 months ago

0.4.1-beta-20240806002741

11 months ago

0.4.1-beta-20240809180235

10 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

10 months ago

0.4.4-beta-20240825221233

10 months ago

0.4.1-beta-20240806192054

11 months ago

0.4.0-beta-20240711225416

11 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

10 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

11 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

11 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

10 months ago

0.4.1-beta-20240731192105

11 months ago

0.4.0-beta-20240714051237

11 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

10 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

11 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

10 months ago

0.5.0-beta-20240903013343

10 months ago

0.4.1-beta-20240808215817

10 months ago

0.4.4-beta-20240821214111

10 months ago

0.4.0-beta-20240714021921

11 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

10 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

11 months ago

0.4.1-beta-20240808224418

10 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

10 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

10 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

10 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

11 months ago

0.4.1-beta-20240717163620

11 months ago

0.3.6-beta-20240630061811

12 months ago

0.4.1-beta-20240808193015

10 months ago

0.5.2-beta-20240922055855

9 months ago

0.5.0-beta-20240904084345

10 months ago

10 months ago

10 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

12 months 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

10 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

10 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

11 months ago

0.3.6-beta-20240622024315

12 months 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