How to create a custom item in Minecraft 1.20.5+ without JSON

The problem with JSON and modern Minecraft

For years, creating custom items meant digging through NBT tags and JSON files. With the release of Minecraft 1.20.5 and the transition to 1.21.4+, the game shifted from NBT to Data Components. While this makes the game run better, it has left many server admins confused by the new syntax. Before 1.20.5, item data was a loose dictionary of tags. Now, components act as rigid, structured arrays. This means that a single typo or misplaced bracket completely invalidates your command block or server plugin script.

Why Components scare creators

Old NBT looked like this: {CustomModelData:1}. The new component system looks like this: [minecraft:custom_model_data=1]. It seems simple at first glance. However, when you start adding custom lore, specific item names, and custom states, the brackets and quotes become an absolute nightmare to format manually. For example, assigning a colored name now requires escaping JSON strings inside a component array.

Creating items visually with our tools

Instead of guessing where a comma goes, you can use our Custom Item Builder. You just type your item name, paste your lore, and set your Custom Model Data. The tool automatically generates the exact /give command for the version you select.

• No syntax errors: The builder ensures your quotes and brackets are perfectly balanced, eliminating chat errors.
• Version switching: Easily toggle between legacy NBT (1.20.4 and below) and modern Components (1.20.5+) to see how the command changes.
• Fast iteration: Tweak your item and copy the new command instantly without opening a code editor.

Stop wasting hours debugging JSON arrays. Use the visual builder and get back to actually playing and managing your server!

Frequently Asked Questions