
Item Editor - Component & NBT
Client-side item, component and NBT editor for Fabric. Customize held items, edit NBT data, and modify item components via an extensible GUI.
- Загрузки
- 8K
- Подписчики
- 30
- Обновлён
- 3 июля 2026 г.
- Лицензия
- GPL-3.0-only
Опубликован 23 марта 2026 г.
Item Editor
A powerful client-side in-game component and NBT editor for Minecraft: Java using the Fabric mod-loader.
Overview
Item Editor opens a comprehensive GUI for the currently held item, allowing you to safely modify item data on a draft before applying changes. Designed as a modern alternative to traditional raw NBT data editors, this mod utilizes Minecraft's modern data component system instead of relying solely on outdated raw-NBT workflows.
It features dynamic custom UI editors for modifying item properties, metadata, and components, including menus for special item types such as books, banners, custom fireworks, containers, signs, potions, and more.
Key Features
- Draft-first Editing - Safe modifications with live preview
- Modern Component System - Native support for Minecraft 1.20.5+ data components
- Dynamic Editors - Specialized UIs for books, banners, fireworks, containers, villager trades, command blocks and more
- Raw NBT Fallback - Full text editor with syntax highlighting and validation
- Built-in Storage - Save, search, and organize items, and import saved items from other mods
- Multiplayer Compatible - Does not require a server-side plugin to function, only requires creative mode.
Installation
Requirements
- Minecraft Fabric (compatible version)
- Fabric API
- owo-lib
Steps
- Install Fabric Loader
- Download the following files:
- Item Editor (this mod)
- Fabric API
- owo-lib
- Place all
.jarfiles into yourmodsfolder - Launch the game
- Open the editor via Controls → Item Editor (default key:
I)
Core Workflow
Item Editor uses a draft-first editing system to ensure safe, predictable modifications:
| Feature | Description |
|---|---|
| Draft Editing | All edits are made on a temporary copy of the held item |
| Live Feedback | Preview updates while editing, with validation shown inline |
| Safe Apply | Save / Apply shows a diff/verification flow before committing |
| Discard Safety | Close/Reset asks for confirmation when needed |
Editor Categories
General
- Custom Name Editing: Styled formatting with presets, gradients, and color picker
- Core Values: Count, Rarity, Durability/Damage, Repair Cost, Unbreakable
- Visual/Model Fields: Glint override, Item Model, Custom Model values
- Adventure Predicates: Can Break / Can Place On with searchable block picking
Components
Always Available
- Name/Stack/Flags: Item Name, Glider, Death Protection
- Food/Consumable: Nutrition, Saturation, Use Behavior
- Combat Behavior: Animation Type & Duration, Hit Sounds with searchable sound picking
- Registry Components: Damage Type, Note Block & Break Sound, Painting Variant
- Equipment / Combat: Equipment Slot, Equip and Shearing Sounds, Asset ID, Camera Overlay, Weapon & Tool settings, Attack Range
- Block Attacks: Block Attacks timings, Damage Reduction, Item Damage
- Custom Data: Raw Editor for Custom Data compounds
Item Specific
- Block State: Block State properties
- Charged Projectiles: Item ID, Count
- Map Metadata: Map Color, Post-Processing (Lock/Scale)
- Advanced Map: Map ID, Decorations, Lodestone Tracker
- Container Metadata: Lock ID, Loot Table, Bee Occupants, Pot Decorations
Display
- Rich multi-line editor with formatting toolbar
- Color/Gradient styling, Head & Sprite insertion and rendering
- Save system for your favorite colors, gradients and shadows
Attributes
- Add, Edit or Remove Attributes
- Menu for each Attribute, with Attribute, Amount, Operation, Slot, and Modifier ID fields
- Summarizes current attribute values and allows resetting to original
Enchantments
- Searchable Enchantment picker and Level adjuster
- Reorder or remove Enchantments
- Allow "unsafe" enchantment levels over the survival limit
Flags
- Hide all or specific components from the tooltip or hide the entire tooltip
Raw Editor
- Full raw text editor for direct control
- Format/Minify tools in editor options
- Syntax-aware editing with inline error targeting and validation
- Collapse components at multiple levels
- Smart suggestions while editing
Special Data
Dynamic category. Sections appear only for compatible items.
- Written Book/Writable Book/Sign: Rich multi-line editor with formatting toolbar, even insertion, and preview
- Potion/Suspicious Stew: Potion ID, Color, Custom Name, Custom Effect with searchable picker
- Firework Explosion: Add Explosions, editing Shape, Material, Colors, Fade Colors, Trail and Twinkle
- Banner/Shield: Creator with Layer Picker, Color Picker, and Preview
- Container/Bundle: Add and Modify Slots of Chests, Shulkers and Bundles
- Spawner/Spawn Egg/Bucket: Add and Modify Entity Data
- Armor Stand: Pose with Presets and Preview, Custom Name, Inventory Locks, Scale
- Item Frame: Custom Name, Flags, Item Rotation, Drop Chance, Facing
- Command Block: Type, Command, Custom Name, Activation, Output / Runtime State
Storage
Save items into a built-in storage menu:
- Browse/Search/Sort: Filter saved items by Item, Name, Lore, Amount, Size, and Modification Date
- Sort Modes: Regular Slot, Saved Time, Alphabetical, Stack Count, or Size
- Page Organization: Set custom page names and orders
- Import: Bring saved items from other mods (NBT Editor, Librarian)
- Access: Open via
/storagecommand, or viaOkeybind (rebindable)
Screenshots
Supported Languages
| Language | Native name | Code |
|---|---|---|
| English | English | en_us |
| Spanish | Español | es_es |
| Russian | Русский | ru_ru |
| Simplified Chinese | 简体中文 | zh_cn |
| Traditional Chinese | 繁體中文 | zh_tw |
| Hindi | हिन्दी | hi_in |
Contributing
Contributions are welcome! Please feel free to:
- Report bugs via GitHub Issues
- Submit feature requests
- Join the Discord for discussion
NBT Library
If you are interested in item making, NBT etc, also check out NBT Library. The NBT Library is focused on a "quality over quantity" approach, providing meticulously curated hotbars full of items, kits, books, and more for your creative servers and single-player worlds.
Also thanks a lot to Kaddicus for his countless helps while developing this mod, without him this mod would be a simple Lore Editor.
License
This project is licensed under the terms of the license specified in the LICENSE file.
Центр версий
33 версийЧенджлог
1.21.11-b18Релиз1.21.11 · 3 июля 2026 г.
build-18
- Added a new Raw Editor autocomplete system with more dynamic registry-aware suggestions, smarter templates, and better raw item data handling.
- Added/expanded editors for missing components:
debug_stick_statedyejukebox_playablepotion_duration_scaleprovides_banner_patternsprovides_trim_material
- Improved Instrument / Audio Data:
- Added picker support for Instrument ID.
- Added editable fields for description, sound event, use duration, and range.
- Improved Combat-related components:
- Moved combat behavior into its own Combat category.
- Added a clearer Kinetic Weapon section.
- Added Tool Rules editing.
- Renamed Block Attacks to Blocks Attacks and shortened its field labels.
- Moved damage-related fields out of Components into the Combat area.
- Improved boolean component controls:
- Consumable Has Consume Particles now supports True / False / Unset.
- Enchantment Glint Override now supports True / False / Unset.
- Equippable Dispensable, Swappable, and Damages on Hurt now support True / False / Unset.
- Piercing Deals Knockback now supports True / False / Unset.
- Potion effect Show Particles and Show Icon now support True / False / Unset.
- Improved item picking:
- Charged Projectiles Projectile Item ID now supports Pick from Storage.
- Container Metadata Lock Item ID now supports Pick from Storage.
- Fixed Pick from Storage returning stale/empty values in editor fields.
- Fixed Container Loot Table picker not returning selected values.
- Improved Potion Data:
- Added potion duration scale editing.
- Renamed Visible to Show Particles.
- Fixed Suspicious Stew “Stew Effect” button text overflow.
- Improved General tab:
- Custom Model Data now supports multiple values.
- Visual Overrides now uses Enchantment Glint Override naming.
- Improved UI and layout:
- Item Editor now respects Minecraft’s own blur option.
- Reduced button overflow across component sections.
- Improved picker/storage button layout.
- Improved compact layouts for repeated list controls.
- Cleanup:
- Removed obsolete hardcoded schema resources.
- Reduced duplicated/dead code in several UI and raw editor paths.
- Kept local tests and plans out of public commits.
- And many other changes which i totally forgot.
26.1-b18Релиз26.1, 26.1.1, 26.1.2 · 3 июля 2026 г.
build-18
- Added a new Raw Editor autocomplete system with more dynamic registry-aware suggestions, smarter templates, and better raw item data handling.
- Added/expanded editors for missing components:
debug_stick_statedyejukebox_playablepotion_duration_scaleprovides_banner_patternsprovides_trim_material
- Improved Instrument / Audio Data:
- Added picker support for Instrument ID.
- Added editable fields for description, sound event, use duration, and range.
- Improved Combat-related components:
- Moved combat behavior into its own Combat category.
- Added a clearer Kinetic Weapon section.
- Added Tool Rules editing.
- Renamed Block Attacks to Blocks Attacks and shortened its field labels.
- Moved damage-related fields out of Components into the Combat area.
- Improved boolean component controls:
- Consumable Has Consume Particles now supports True / False / Unset.
- Enchantment Glint Override now supports True / False / Unset.
- Equippable Dispensable, Swappable, and Damages on Hurt now support True / False / Unset.
- Piercing Deals Knockback now supports True / False / Unset.
- Potion effect Show Particles and Show Icon now support True / False / Unset.
- Improved item picking:
- Charged Projectiles Projectile Item ID now supports Pick from Storage.
- Container Metadata Lock Item ID now supports Pick from Storage.
- Fixed Pick from Storage returning stale/empty values in editor fields.
- Fixed Container Loot Table picker not returning selected values.
- Improved Potion Data:
- Added potion duration scale editing.
- Renamed Visible to Show Particles.
- Fixed Suspicious Stew “Stew Effect” button text overflow.
- Improved General tab:
- Custom Model Data now supports multiple values.
- Visual Overrides now uses Enchantment Glint Override naming.
- Improved UI and layout:
- Item Editor now respects Minecraft’s own blur option.
- Reduced button overflow across component sections.
- Improved picker/storage button layout.
- Improved compact layouts for repeated list controls.
- Cleanup:
- Removed obsolete hardcoded schema resources.
- Reduced duplicated/dead code in several UI and raw editor paths.
- Kept local tests and plans out of public commits.
- And many other changes which i totally forgot.
1.21.11-b17Релиз1.21.11 · 27 июня 2026 г.
build-17
- Fixed a crash that could happen when opening raw item apply/confirmation dialogs on smaller screens or high GUI scale.
- Fixed dialog sizing so it no longer breaks when the screen is too small for the preferred minimum dialog height.
- Fixed raw editor height sizing so it handles small available space safely instead of using invalid size limits.
26.1-b17Релиз26.1, 26.1.1, 26.1.2 · 27 июня 2026 г.
build-17
- Fixed a crash that could happen when opening raw item apply/confirmation dialogs on smaller screens or high GUI scale.
- Fixed dialog sizing so it no longer breaks when the screen is too small for the preferred minimum dialog height.
- Fixed raw editor height sizing so it handles small available space safely instead of using invalid size limits.
1.21.11-b16Релиз1.21.11 · 26 июня 2026 г.
build-16
- Rewrote container editor
- Rewrote bundle editor
- Rewrote villager trading picker
- Improved damage type and tag selection
- Component section is designed as more compact
- Improved Banner Editor
- Rewrote spawner editor
- Rewrote spawn egg editor
- Added command block editor
26.1-b16Релиз26.1, 26.1.1, 26.1.2 · 26 июня 2026 г.
build-16
- Rewrote container editor
- Rewrote bundle editor
- Rewrote villager trading picker
- Improved damage type and tag selection
- Component section is designed as more compact
- Improved Banner Editor
- Rewrote spawner editor
- Rewrote spawn egg editor
- Added command block editor
1.21.11-b15Релиз1.21.11 · 22 июня 2026 г.
build-15
Added full Storage Pages menu
- Now pages supports custom names
- Pages menu has page open, rename, duplicate, backup, export, delete, move up/down actions
- It's possible to export a page as command, chest or shulker box
- Added "O" as a keybind to quickly open up Storage Pages menu
- It's possible to search/filter pages with
page-name'items' and 'size' filters - Also added a subcommand (/storage pages) to open up storage pages menu quickly.
Added
Import from other mods- Supports NBT Editor client chest import
- Supports Librarian hotbar import
- Long Librarian hotbars are split into multiple pages when needed
- Imported storages are saved as new pages
- If an item is fails to import, they are stored in '/itemeditor/backups/storage/import/' folder, also contains logs
Storage item search no longer requires namespace
- as an example;
stonematches withminecraft:stone
- as an example;
Added DFU updating for old stored items while loading pages.
- Old items are updated before decode when needed.
- Successful DFU updates are written back to storage immedietly.
- Even DFU update is succesful, a copy of item is stored in '/itemeditor/backups/storage/item/' folder, also contains logs
- Failed DFU/decode removes the bad item from pagination.
- In such a case, it prints a warning in chat, mentioning problem
- A copy of removed item is stored in '/itemeditor/backups/storage/item/' folder, also contains logs
Added storage backup system under '/itemeditor/backups/storage/'
item/for item DFU backupsimport/for external import backupspages/for page backups- Backups works automatically when an update or import is triggered, but can be triggered manually for pages, from Storage Pages Menu
General Improvements
- Standardized all log messages with
[Item Editor]prefix - Improved attribute/enchantment/general action rows
- Improved raw editor action button layout
- Added colors for some buttons
- Some UI changes where I forgot
- Improved Charged Projectiles layout
- Standardized all log messages with
26.1-b15Релиз26.1, 26.1.1, 26.1.2 · 22 июня 2026 г.
build-15
Added full Storage Pages menu
- Now pages supports custom names
- Pages menu has page open, rename, duplicate, backup, export, delete, move up/down actions
- It's possible to export a page as command, chest or shulker box
- Added "O" as a keybind to quickly open up Storage Pages menu
- It's possible to search/filter pages with
page-name'items' and 'size' filters - Also added a subcommand (/storage pages) to open up storage pages menu quickly.
Added
Import from other mods- Supports NBT Editor client chest import
- Supports Librarian hotbar import
- Long Librarian hotbars are split into multiple pages when needed
- Imported storages are saved as new pages
- If an item is fails to import, they are stored in '/itemeditor/backups/storage/import/' folder, also contains logs
Storage item search no longer requires namespace
- as an example;
stonematches withminecraft:stone
- as an example;
Added DFU updating for old stored items while loading pages.
- Old items are updated before decode when needed.
- Successful DFU updates are written back to storage immedietly.
- Even DFU update is succesful, a copy of item is stored in '/itemeditor/backups/storage/item/' folder, also contains logs
- Failed DFU/decode removes the bad item from pagination.
- In such a case, it prints a warning in chat, mentioning problem
- A copy of removed item is stored in '/itemeditor/backups/storage/item/' folder, also contains logs
Added storage backup system under '/itemeditor/backups/storage/'
item/for item DFU backupsimport/for external import backupspages/for page backups- Backups works automatically when an update or import is triggered, but can be triggered manually for pages, from Storage Pages Menu
General Improvements
- Standardized all log messages with
[Item Editor]prefix - Improved attribute/enchantment/general action rows
- Improved raw editor action button layout
- Added colors for some buttons
- Some UI changes where I forgot
- Improved Charged Projectiles layout
- Standardized all log messages with
Комментарии
Загружаем…