Editor Workflow (Step-by-Step, Hands-On)
Belongs to: Editor GUI · Related: Item Editor · Slot Cheat Sheet
Subpages like Item Editor explain "what the interface is", and the Slot Cheat Sheet tells you "which slot to click". This page gives the complete step-by-step workflows for common tasks—just follow along to get them done.
The
qinhitems.editorpermission is required throughout. Each step notes which button to click, what pops up, and what to enter.
Workflow 1: Create a weapon from scratch
1. Enter /qi editor
→ Opens the type browser
2. Click the "Weapon" type cell
→ Opens the item browser for weapons
3. Click "Create item" (WRITABLE_BOOK, slot 49)
→ Inventory closes, chat prompts you to enter an ID
4. Type the item ID in chat (e.g. my_sword)
→ Enters the item editor main screen
5. Click the "Material" field → type diamond_sword in chat
6. Click the "Display Name" field → type <gold>Blade of Trials</gold> in chat
7. Click the "Rarity" field → type EPIC in chat
8. Click the "Lore Add" field → type A sword of trials in chat
9. Click "Save to YAML" (EMERALD, slot 53)
→ Validation passes, shows save success + anvil sound effect
10. After exiting, run /qi give my_sword to claim and view it🖼️ [Image placeholder] Step-by-step screenshot collage of creating a weapon · suggested
assets/flow-create-weapon.png
Workflow 2: Add attributes to an item
1. In the item editor, click the "Attributes" field
→ Opens the attribute editor
2. Click "Add attribute" (LIME_DYE, slot 49)
→ Type an attribute key in chat (e.g. attack_damage), or pick from the AP catalog
3. Type the value in chat
· Single value: 18
· Range: 10-20 (rolled randomly per item, see Variables)
4. Repeat 2–3 to add more attributes (crit_rate, etc.)
5. (Optional) Click "Base Attributes" (NETHERITE_INGOT, slot 47)
→ Enters the base value editor, set base_attack_damage / base_health / base_defense
6. Return to the item editor → Save (slot 53)For attribute mechanics see Attributes & Values. AttributePlus must be installed for them to actually apply.
Workflow 3: Configure a left-click skill on an item
1. Item editor → click the "Actions/Skills" field
→ Opens the action editor
2. In the trigger tabs at the top, select "left_click" (one of slots 0–5)
3. Click "Add ref" (LIME_DYE, slot 19)
→ Opens the handler selector
4. Pick a handler, e.g. qi:title
→ If the handler has a payload schema: opens the payload form
· Click each field one by one → type in chat
· Click "Confirm and write" (EMERALD, slot 49)
→ If no schema: type the raw payload directly in chat
5. Repeat 3–4 to add more handlers like qi:sound
6. Click "Cooldown" (CLOCK, slot 21): left-click +1s to set it to 3s
7. Click "Save actions" (EMERALD, slot 49)
→ Writes back to the item and hot-reloads the action table, effective immediatelyTip: In the action editor, the handler list supports left-click to move up, right-click to delete, Shift+right-click to edit the payload. For slots see Slot Cheat Sheet.
Workflow 4: Swap the skill for a QinhSkills skill
1. Action editor → click "Add skill" (NETHER_STAR, slot 20)
→ Opens the skill binding screen
2. Select a trigger tab (left_click, etc.)
3. Click a QinhSkills skill from the skill list
(or click "Manually enter skill ID" ANVIL slot 37 and type it in chat)
4. (Optional) Click "JSON form" (slot 38) to set skill + level
5. Click "Save to item" (EMERALD, slot 49)This is equivalent to adding qinhskills:cast to the refs of left_click. Requires QinhSkills, see Integration.
Workflow 5: Create and arrange a set
1. First build all the set-piece items (Workflow 1), naming them with a shared prefix (e.g. warrior_helmet, warrior_sword)
2. Open the item editor of any set piece → click "Set"
→ Set hub
3. Click "Create new set" (NETHERITE_CHESTPLATE, slot 20)
→ Type the set ID and display name in chat
4. Click "Edit this set" (WRITABLE_BOOK, slot 20) → set editor screen
5. Click "Member items" (CHEST, slot 23) → add warrior_helmet, warrior_sword …
(you can also add just the prefix warrior to match all warrior_xxx)
6. Click "Tier Bonuses" (BEACON, slot 25) → create new tiers
· "2 pieces" → attribute physical_damage=5
· "4 pieces" → attribute physical_damage=10, potion effect SPEED=1, skill right_click→burst
7. Done (the set is saved automatically to sets/setID.yml)For set mechanics see Sets, and for button slots see Slot Cheat Sheet.
Workflow 6: Open gem sockets on equipment
1. Item editor → click "Gem Sockets" (or the AMETHYST_SHARD in the editor Hub)
→ Gem socket editor
2. Click "Add socket" (AMETHYST_SHARD, slot 40)
→ Type the socket type ID in chat (e.g. green / qi_weapon, see gem_socket_types.yml)
3. Repeat to add more sockets; the right-click add button deletes the last one
4. (Optional) Click "Legendinlay metadata" (slot 6) → enter set,slot,piece
5. Click "Save" (EMERALD, slot 53)For socket type definitions see Gem Sockets.
Workflow 7: Set as soulbound
Binding usually relies on the item's bind_on_acquire + pickup, or a command. On the GUI side:
1. Item editor → click "Restrictions" → restriction editor
2. Click "Bind on acquire" (CHAIN/TRIPWIRE_HOOK, slot 48) to toggle bind_on_acquire
3. SaveOr hold the item and run /qi soulbind [level] to bind it directly to yourself. See Soulbinding.
Workflow 8: Edit an existing item
1. /qi editor → select type → item browser
2. Right-click the target item → goes straight into the item editor
(left-click is "get into inventory", not edit)
3. Change fields → saveOr run /qi editor <itemID> directly in one step.
General Notes
- Closing the inventory = discarding unsaved changes (the working copy is not auto-persisted).
- To cancel midway through chat input, type
cancel. - If there are validation errors on save, you'll be prompted and the save rejected (see Validation Error Cheat Sheet).
- What the GUI configures is just YAML; after saving you can see it in
items/*.yml; and after writing by hand,/qi reloadlets you open it in the GUI too.
Next Steps
- Item Editor / Action Editor / Set Editor
- Slot Cheat Sheet: exact slot numbers