Items

🗡️ Items

Custom items with models, textures, and behaviors.

Basic Item

ruby_sword:
  type: item
  display:
    name: "<gold>Ruby Sword</gold>"
  model:
    sprite: "item/ruby_sword"

Options

Display

display:
  name: "<gradient:#ff5f6d:#ffc371>Ruby Sword</gradient>"
  lore:
    - "<gray>A powerful blade</gray>"
    - "<dark_gray>Durability: 250</dark_gray>"
  glint: true

Option	Type	Description
name	string	Item name (MiniMessage)
lore	list	Lore lines
glint	boolean	Enchantment glint

Model

model:
  sprite: "item/texture_name"

Model Types:

Type	Description
sprite	Flat texture (auto-generated model)
vanilla	Reuse a vanilla item's appearance
custom	Hand-authored model

Sprite Model

model:
  sprite: "item/ruby_sword"

Vanilla Model

model:
  vanilla: "minecraft:diamond_sword"

Custom Model

model:
  custom: "item/ruby_sword"
  textures:
    layer0: "item/ruby_sword"

Behaviour

behaviour:
  max_stack_size: 1
  durability: 250
  fire_resistant: true

Option	Type	Default	Description
max_stack_size	int	64	Max stack size
durability	int	null	Max durability
fire_resistant	boolean	false	Fire resistant

Java Options

java:
  base_material: NETHERITE_SWORD
  components: {}

Option	Type	Description
base_material	Material	Base vanilla material
components	map	Additional components

Bedrock Options

bedrock:
  enabled: true
  icon: custom_icon

Option	Type	Default	Description
enabled	boolean	true	Enable on Bedrock
icon	string	null	Custom icon name

---

Examples

Simple Item

ruby_dust:
  type: item
  display:
    name: "<gold>Ruby Dust</gold>"
  model:
    sprite: "item/ruby_dust"

Tool with Durability

ruby_pickaxe:
  type: item
  display:
    name: "<gold>Ruby Pickaxe</gold>"
    lore:
      - "<gray>Mines quickly</gray>"
  model:
    sprite: "item/ruby_pickaxe"
  behaviour:
    durability: 500
  java:
    base_material: NETHERITE_PICKAXE

Food

ruby_apple:
  type: item
  display:
    name: "<gold>Ruby Apple</gold>"
  model:
    sprite: "item/ruby_apple"
  behaviour:
    food:
      nutrition: 4
      saturation: 1.2
      always_food: false

---

See Also

• Blocks — Custom blocks
• Furniture — Rotatable furniture
• Configuration — All config options

---

📜 Footer

Kalo — Open Custom Content Engine for Minecraft

GitHub • Issues • Discord (coming soon)

Version: 0.1.0 • License: MIT • Java: 21+ / 25

Build once. Play everywhere.