minecraft-blocks-itemslisted
Install: claude install-skill ibrohim1234567881717/game-dev-ai-skills
# Minecraft Blocks and Items
## Purpose
Blocks and items are the first thing every mod adds and the first place the
loader/version/mappings triple bites. A block is not one object: it is a
registered `Block`, usually a registered `BlockItem`, a blockstate JSON, one or
more model JSONs, textures, a translation key, a creative tab insertion, and
often loot and recipe data. Miss any link in that chain and you get silent
failure — an invisible block, a purple-and-black model, or an item that exists
but cannot be obtained. This skill covers the whole chain on each loader
separately.
## When to use
- Adding a block, an item, a block with a block entity, or a block with states.
- A block or item is registered but does not appear in the creative menu.
- The model renders as the missing-texture checkerboard, or the item shows as a
purple-and-black square in the hand.
- The name shows as `block.examplemod.ruby_block` instead of "Ruby Block".
- Migrating item NBT code to data components after a 1.20.5+ version bump.
- A block entity does not save its contents across a world reload.
## When NOT to use
- The loader, Minecraft version and mappings are unresolved. Run
`minecraft-project-conventions` first.
- The question is *where* registration classes live and when they run. That is
`minecraft-mod-architecture`.
- The block opens a GUI — the menu and screen half is `minecraft-gui-screens`.
- Custom block rendering beyond the JSON model system (block entity renderers,
render l