Commands and Permissions

EmakiGem's commands and permission nodes (the identifiers the server checks to decide who may run a command) are listed below, along with the command to reach for first in each common scenario. The main command is /emakigem, with /egem and /eg as aliases. You use it 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

If an unfinished candidate session already exists, running full or value again gives you 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

Give players gem items through item sources, shops, rewards, or other server-side systems