Command Reference

Command Description Permission
/ls help Show command overview and version info lumensmith.admin
/ls list List all blocked outputs and custom recipes lumensmith.admin
/ls reload Reload configuration and recipes instantly lumensmith.admin
/ls rescan Force all online players' recipe books to update lumensmith.admin
/ls fixbook Remove duplicate adjacent-pair entries from recipe books lumensmith.admin
/ls recipes Open the in-game recipe browser GUI lumensmith.gui
/ls create <key> Open the in-game recipe creator lumensmith.create
/ls delete <key> Delete a custom recipe from config lumensmith.admin

Command Details

/ls help

Displays the full command overview along with the current plugin version. Useful for quickly checking which commands are available and what version you're running.

/ls list

Shows a summary of all currently blocked vanilla outputs (from remove_by_output) and all registered custom recipes with their keys and types.

/ls reload

Reloads the config.yml and re-registers all recipes without restarting the server. Existing recipes are removed from all players' recipe books first, then the new recipes are loaded.

After editing config.yml manually, always run /ls reload to apply changes.

/ls rescan

Scans all online players' inventories and unlocks any recipes they should have based on the auto_unlock_on triggers. Useful after a reload or when players report missing recipes in their recipe book.

/ls fixbook

Removes duplicate recipe book entries caused by adjacent-pair recipes. Adjacent-pair recipes register multiple internal placements, which can sometimes cause duplicate entries in the recipe book. This command cleans those up.

/ls recipes

Opens a paginated GUI that displays all custom recipes. Click any recipe to see its full details (ingredients, result, settings). From the detail view, you can edit or delete the recipe.

The recipe browser is available to all players by default (permission: lumensmith.gui, default: true).

/ls create <key>

Opens the in-game recipe creator GUI. The <key> must be a unique identifier using only letters, numbers, and underscores (e.g., my_custom_sword).

In the creator you can:

When you confirm, the recipe is saved directly to config.yml and loaded instantly.

/ls delete <key>

Removes the recipe with the given key from config.yml and reloads. You can also delete recipes from the recipe browser GUI by clicking the TNT icon in the detail view.

Deleting a recipe is permanent and cannot be undone. The recipe entry is removed from config.yml.