Creating Items

Items are objects players can hold, use, and collect. Learn how to create weapons, tools, consumables, and more.

Item Types

Type	Description	Examples
Tools	Used to interact with world	Pickaxes, axes, shovels
Weapons	Used in combat	Swords, bows, staffs
Consumables	Single-use items	Food, potions
Materials	Crafting ingredients	Ores, gems, cloth
Placeable	Items that place blocks	Block items

Getting Started

If you haven’t created content yet, start with the Quick Start tutorial.

Creating an Item

Using the Asset Editor

Open the Asset Editor
Navigate to Items > Create New
Set the item name and properties
Assign an icon
Save your pack

Manual JSON Creation

Create a file in Server/Item/:

{
  "identifier": "mypack:crystal",
  "displayName": "Magic Crystal",
  "category": "materials",
  "maxStackSize": 64,
  "icon": "mypack:crystal",
  "rarity": "uncommon"
}

Item Properties

Key Properties

Property	Description
`identifier`	Unique ID in format `namespace:itemname`
`displayName`	Name shown to players
`category`	Inventory category
`maxStackSize`	How many can stack (usually 1, 16, or 64)
`icon`	2D inventory icon
`model`	3D model when held

Stack Size

Value	Use Case
1	Tools, weapons, armor
16	Eggs, signs, buckets
64	Most materials

Rarity

Affects name color and sorting:

Rarity	Color	Examples
`common`	White	Basic materials
`uncommon`	Green	Crafted items
`rare`	Blue	Special items
`epic`	Purple	Powerful items
`legendary`	Orange	Unique items

Item Categories

Category	Purpose
`weapons`	Combat items
`tools`	World interaction
`armor`	Protective equipment
`consumables`	Food and potions
`materials`	Crafting ingredients
`misc`	Everything else

Creating Item Icons

Icon Specifications

Size: 16x16 pixels (standard) or 32x32 (detailed)
Format: PNG with transparency
Location: Common/Icons/

Icon Tips

Clear silhouette - Item should be recognizable at small size
Consistent style - Match the game’s aesthetic
Use transparency - Don’t fill the whole square
Center the item - Leave padding around edges

Adding a 3D Model

For items visible when dropped or held:

{
  "identifier": "mypack:crystal",
  "displayName": "Magic Crystal",
  "icon": "mypack:crystal",
  "model": "mypack:crystal_item"
}

Create the model in Blockbench and export to Common/Models/.

Item Descriptions

Add flavor text or information:

{
  "description": "A crystal infused with magical energy. Used in advanced crafting."
}

Complete Example

File structure:

MyCrystalPack/
├── manifest.json
├── Common/
│   └── Icons/
│       ├── fire_crystal.png
│       ├── water_crystal.png
│       └── earth_crystal.png
└── Server/
    └── Item/
        ├── fire_crystal.json
        ├── water_crystal.json
        └── earth_crystal.json

fire_crystal.json:

{
  "identifier": "mypack:fire_crystal",
  "displayName": "Fire Crystal",
  "description": "A crystal burning with inner flame.",
  "category": "materials",
  "maxStackSize": 64,
  "icon": "mypack:fire_crystal",
  "rarity": "uncommon"
}

Connecting Items to Blocks

Items can drop from blocks. In your block definition:

{
  "identifier": "mypack:crystal_ore",
  "drops": [
    {
      "item": "mypack:fire_crystal",
      "count": { "min": 1, "max": 3 }
    }
  ]
}

Next Steps

Creating Blocks - Create blocks that drop items
Quick Start - Create your first content