SoapsUniverse
SoapsAdmin
SoapsAdmin

Getting Started

Home

[Home](README.md)

IntroductionGetting StartedModulesConfigurationComparison: EssentialsX · CMI · SoapsAdminCommands IndexCommands: PlayerCommands: ModerationCommands: StaffCommands: EconomyCommands: AdminGUIs and MenusModerationEconomy and ShopSpawnersRecipes and CrucibleItem EditorFake Players / MannequinsMail and Player InfoChat and MessagingCustom CommandsPlayer VaultsTeleportationPermissionsPlaceholdersIntegrationsDefault Config FilesExamplesFAQChangelog

Item Editor

Last updated Jul 27, 2026

Item Editor

Advanced Paper-only item editor for renaming, lore, enchants, flags, attributes, custom model data, and reusable templates.

Module: item-editor. Command: /sa itemeditor.

Requirements

  • Paper 1.21+ (not available on pure Spigot — see FAQ)
  • Permission: soapsadmin.itemeditor (plus tier nodes below)

Opening

  1. Hold the item to edit in your main hand.
  2. Run /sa itemeditor (opens the GUI session).
  3. Edit via GUI clicks or chat/command subcommands.
  4. Finish / cancel / undo as needed.

Drafts can be recovered if you close mid-edit (messages.yml draft notices).

GUI Overview

The editor uses multi-tier panels (simple → advanced → expert) for:

  • Display name (MiniMessage)
  • Lore lines
  • Enchantments
  • Item flags / unbreakable
  • Custom model data
  • Attributes (GUI-only)
  • Templates (save / load / delete / list)

Exact layout is driven by gui/system-gui.yml.

Command Subcommands

Chat subcommands:

Subcommand Example
name /sa itemeditor name <gradient:#ff0:#f00>Blade</gradient>
lore add/set/remove/clear /sa itemeditor lore add <gray>Line</gray>
enchant add/remove/clear /sa itemeditor enchant add sharpness 5
flag /sa itemeditor flag HIDE_ENCHANTS
unbreakable /sa itemeditor unbreakable
modeldata /sa itemeditor modeldata 1001
template save/load/delete/list /sa itemeditor template save my_sword
undo / reset / finish / cancel Session control

Permissions

Node Purpose
soapsadmin.itemeditor Open basic editor
soapsadmin.itemeditor.advanced Advanced options
soapsadmin.itemeditor.expert Expert / attribute depth
soapsadmin.itemeditor.admin Admin overrides
soapsadmin.itemeditor.templates.global Global templates

Exact child nodes are listed in Permissions / plugin.yml.

Templates

Save an edited item as a named template, then load it onto another base item. Templates support shop kits, event rewards, and staff giveaways. Global templates require soapsadmin.itemeditor.templates.global.

Names and lore use MiniMessage (same format as messages.yml).

Paper requirement

The item editor requires Paper. On Spigot it is disabled; use /sa enchant and kit YAML definitions instead. See FAQ.

Goal See
Mythic/Crucible items in recipes Recipes
Display items on mannequins /sa fakeplayer — Commands: Staff
Sell or distribute items Economy and Shop, kits
Inspect item meta /sa iteminfo
Discord