Commands and Permissions

The main command of EmakiGem is /emakigem, with /egem and /eg as aliases. Commands are used to open gem GUIs, inspect gem state, clear debugging state, reload configuration, and print debug information.

Command	Permission	Description
/emakigem help	none	Print the command help list. Also shown when running /emakigem with no arguments.
/emakigem gui <inlay|upgrade|extract|reroll|recalibrate|open>	emakigem.use or emakigem.admin	Open the selected gem GUI mode. The mode argument is required by the current command router; an unknown mode is treated as an argument error.
/emakigem reload	emakigem.reload or emakigem.admin	Reload config, gems, socket item definitions, resonances, conditions, GUI files, and language files.
/emakigem inspect [player]	emakigem.use or emakigem.admin	Inspect gem state on the held item of the target player or yourself.
/emakigem reroll <full|value|confirm|cancel|status>	emakigem.use or emakigem.admin	Generate or accept a reroll candidate for the gem in the main hand. See Reroll commands.
/emakigem clearstate	emakigem.admin	Clear gem layer state from the held item. Useful for debugging or repairing abnormal items.
/emakigem convert-legacy [confirm]	emakigem.admin	Convert the deprecated match block in items/*.yml into matcher plus a top-level slot_groups. Gem has no key-rename targets left beyond that. Without an argument it only previews; confirm (or --apply) rewrites the files and leaves a .bak backup each. The converted matcher still needs a manual pass, see Socket item definitions.
/emakigem debug	emakigem.debug or emakigem.admin	Print runtime debug information.

GUI modes

Mode	Purpose
inlay	Inlay gems. Extraction can be toggled from inside the view.
extract	Open directly in extract mode.
upgrade	Upgrade gems using EmakiStrengthen recipe materials.
reroll	Full reroll: re-roll the affixes of the main-hand gem.
recalibrate	Value reroll: re-roll only the values of existing affixes.
open	Open locked socket slots with socket openers.

Reroll commands

The reroll subcommands act on the gem in the main hand and require emakigem.use or emakigem.admin:

Subcommand	Purpose
full	Generate a full reroll candidate (re-rolls the affixes themselves) and charge full_cost immediately.
value	Generate a value reroll candidate (values only) and charge value_cost immediately.
confirm	Confirm the candidate and write it to the main-hand gem.
cancel	Abandon the candidate and refund the charge.
status	Show the current candidate's type, original affix count, candidate affix count, and remaining seconds.

When an unfinished candidate session already exists, running full or value again returns that session without charging again or regenerating the candidate. Candidate lifetime is controlled by reroll.session_ttl_seconds in config.yml. Configuration and settlement rules are in Gem Definitions.

Examples

/emakigem gui inlay
/emakigem gui open
/emakigem gui upgrade
/emakigem reroll full
/emakigem reroll confirm
/emakigem inspect Steve
/emakigem reload

Gem items should be distributed through item sources, shops, rewards, or other server-side systems.