Commands and Permissions

The main command of EmakiForge is /emakiforge, with /eforge and /ef as aliases. Players use it to open the forge GUI or the recipe book; admins use it to reload configuration, list recipes, and check status

The root command requires emakiforge.use (default true). Additional subcommand permissions are listed below

Command	Permission	Description
/ef help	Root permission only	Show command help. Running the root command with no arguments also shows help
/ef forge	Root permission only	Open the forge GUI. Players only (console senders see the player-only message)
/ef book	emakiforge.book or emakiforge.admin	Open the recipe book. Players only (console senders see the player-only message)
/ef list <type>	emakiforge.admin	List loaded definitions with display names. Only recipe is implemented (recipes is also accepted) and tab completion only suggests recipe; any other value reports invalid arguments
/ef reload	emakiforge.reload or emakiforge.admin	Reload config, language, GUI templates, and recipes, reporting the reloaded recipe and GUI template counts plus the elapsed time
/ef convert-legacy [confirm]	emakiforge.admin	Migrates legacy item_sources under materials[], blueprint_requirements[], and result.*.outputs[] in recipes/; material entries keep the legacy key by spec. Without an argument it performs a dry run; confirm (or --apply) writes files and leaves a .bak backup
/ef debug stats	emakiforge.debug or emakiforge.admin	Print runtime metrics and the recipe load report (status is equivalent)
/ef debug on / off	emakiforge.debug or emakiforge.admin	Toggle debug output globally
/ef debug player <player>	emakiforge.debug or emakiforge.admin	Track debug output for one player
/ef debug module <module>	emakiforge.debug or emakiforge.admin	Enable debug output for one submodule

Available debug submodules: recipe, forge, gui, pdc. Any other /ef debug argument is handled by the CoreLib debug command

The aliases eforge and ef behave exactly like the root command

Permissions

Permission	Default	Description
emakiforge.use	true	Allows use of the root command and forge GUI
emakiforge.book	true	Allows opening the recipe book
emakiforge.reload	op	Allows reloading configuration
emakiforge.debug	op	Allows debug output
emakiforge.admin	op	Allows administrative operations

Which command first

Situation	Run first	Purpose
A player wants to forge	/ef forge	Open the forge GUI
A player cannot find a recipe	/ef book	Check whether the recipe is loaded
An admin changed recipes or GUI files	/ef reload	Reload recipes/, gui/, language, and runtime resources
Unsure whether a recipe loaded	/ef list recipe	Inspect the loaded recipe list
Recipe load warnings or errors	/ef debug stats	Inspect runtime metrics and the recipe load report
Unexpected forge results	/ef debug module forge	Turn on debug output for the forge submodule

After editing recipes/, gui/, or the language files, run /ef reload; it reports the reloaded recipe and GUI template counts. When debugging a recipe, back up the recipe file you are editing before reloading