Item Editor

Belongs to: Editor GUI　·　Related: Action Editor · Item Definition

The item editor (ItemEditionGui) is the main editing interface for a single item. Enter it via Type Browser → item browser → right-click an item / create new, or jump directly with /qi editor <itemId>.

---

1. Main Interface Structure

The interface is a dynamic inventory of 6 rows and 54 slots, displaying clickable "field rows" across pages. Each field is one of the following three types:

Type	Interaction	Examples
Toggle	Click to switch instantly	Unbreakable, glow, hide attributes, hide enchantments
Chat Input	Click then type in the chat box	Material, quality, type, display name, item name, lore, max stack size, CMD, enchant total cap
Sub-editor	Click to open a new interface	Action, gem socket, attribute, permanent effect, enchantment, restriction, set, template, Provider

• Save: Slot 53 (emerald) → validate and write back to YAML.
• Editor Hub: Slot 50 → return to the editor Hub.

🖼️ [Image placeholder] Item editor main interface, with each field button position labeled　·　suggested assets/editor-item-main.png

---

2. Where Each Field Is Written

GUI Field	Written to QinhItemDefinition
Material	material
Quality	tier
Type	type
Display name	displayName
Item name	itemName
Lore (add / clear)	lore
Unbreakable / glow / hide attributes / hide enchantments	options.*
Max stack size	options.maxStackSize
CustomModelData	options.customModelData / resourcePack.customModelData
Enchant total cap	enchantMaxTotalLevel
Bind on acquire	options.bindOnAcquire
Restrictions	options.restrictions

See Item Definition for the corresponding YAML field descriptions.

---

3. Sub-editor Entries

Attribute Editor (AttributeEditorGui)

Edits the item's providers.ap attributes.

• Attribute list: sorted by key name, displaying key value + category + hint.
• Left-click: edit value (chat input).
• Shift + right-click: delete that attribute.
• Add attribute: chat-input a key (or select from the AP catalog) → enter a value (supports a single value 10 or a range 10-20). Written to the JSON blob of providers.ap.
• Base values (BaseValueEditorGui): edit ICVM core keys (base_attack_damage / base_defense / base_health).
• Clear all: remove the entire ap provider.

See Attributes and Stats for the attribute mechanics.

Permanent Effect Editor (PermEffectEditorGui)

Edits providers.perm_effects. To add: enter an effect name → enter an amplifier level. See Attributes and Stats → Permanent Potion Effects.

Enchantment Editor (EnchantmentEditorGui)

Edits enchantments. To add: enter an enchantment key → enter a level (validated 0–255). See Enchant Cap.

Restriction Editor (RestrictionEditorGui)

Edits options.restrictions. To add: chat-input one restriction (e.g. level:20). See Item Definition → restrictions.

Provider Browser (ProviderBrowserGui)

Edits any providers.*. To add: enter a provider ID → enter the Provider Blob editor to input the carrier + payload. For developer-oriented details see Providers and Bridges.

Gem Socket Editor (GemSocketEditionGui)

Edits gem-sockets.

• Left-click to add a socket (chat-input a socket type ID) / right-click to remove the last one.
• Legendinlay metadata button: enter set,slot[,piece].
• Clear / save.

See Gem Sockets.

---

4. Other Entries

• Action / Skill → Action Editor
• Set → Set Editor
• Template / Resource Pack / Model → Other Editors

---

5. Typical Workflow

/qi editor
→ click Weapon
→ create new item → chat-input ID
→ [Material] enter diamond_sword
→ [Quality] enter EPIC
→ [Display name] enter <gold>Blade of Trial</gold>
→ [Attribute] add attack_damage = 18
→ [Action/Skill] add qi:title / qi:sound
→ [Save] (slot 53) → success message

---

Next Steps

• Action / Skill Editor
• Set Editor
• Other Editors