# Commands Observer registers a set of commands for managing events, gameplay systems, and player states. Most staff commands open an interactive GUI menu, while some accept subcommands for direct control. --- ## Main Command | Command | Permission | Description | |---|---|---| | `/observer` | `lodestone.observer.commands.observer` | Opens the main Observer management GUI. | | `/observer version` | `lodestone.observer.commands.observer` | Displays the current Observer version. | | `/observer reload` | `lodestone.observer.commands.observer` | Reloads all configurations, pedestals, and custom recipes. | --- ## Staff Commands All staff commands use configurable namespaces and permissions defined in `config.yml` under `commands.namespaces` and `commands.permissions`. The table below lists the default values. | Command | Default Permission | Description | |---|---|---| | `/settings` | `lodestone.observer.commands.settings` | Opens the game settings GUI for toggling mechanics. | | `/capsules` | `lodestone.observer.commands.capsules` | Opens the capsule management GUI. | | `/enchantments` | `lodestone.observer.commands.enchantments` | Opens the enchantment restrictions GUI. | | `/items` | `lodestone.observer.commands.items` | Opens the item restrictions GUI. | | `/mechanics` | `lodestone.observer.commands.mechanics` | Opens the mechanics configuration GUI. | | `/pedestals` | `lodestone.observer.commands.pedestals` | Opens the pedestal management GUI. | | `/recipes` | `lodestone.observer.commands.recipes` | Opens the custom recipes GUI. | | `/respawn` | `lodestone.observer.commands.respawn` | Opens the respawn management GUI. | | `/lifesteal` | `lodestone.observer.commands.lifesteal` | Opens the lifesteal configuration GUI. | | `/resetallbans` | `lodestone.observer.commands.resetallbans` | Resets all auto-bans issued by the elimination system. | | `/translate <key>` | `lodestone.observer.commands.translate` | Manages translation entries. | | `/translations` | `lodestone.observer.commands.translations` | Opens the translation management GUI. | --- ## Kit Commands The kit system supports saving, loading, importing, exporting, and distributing player state kits. | Command | Default Permission | Description | |---|---|---| | `/kit` | `lodestone.observer.commands.kit` | Opens the global kit management GUI. | | `/kit save <id> [-l]` | `lodestone.observer.commands.kit` | Saves your current inventory as a kit. The `-l` flag also saves your location. | | `/kit save <player> <id> [-l]` | `lodestone.observer.commands.kit` | Saves another player's inventory as a kit. | | `/kit give <kit(s)>` | `lodestone.observer.commands.kit` | Gives kit(s) to yourself. Supports weighted random: `50%kit_a,30%kit_b,20%kit_c`. | | `/kit give <targets> <kit(s)>` | `lodestone.observer.commands.kit` | Gives kit(s) to target players. Works from console. | | `/kit delete <id>` | `lodestone.observer.commands.kit` | Deletes a kit by its ID. | | `/kit export <id>` | `lodestone.observer.commands.kit` | Exports a kit to a shareable code or mclo.gs URL. | | `/kit import <id> <code>` | `lodestone.observer.commands.kit` | Imports a kit from a code or mclo.gs URL and saves it with the given ID. | ### Weighted Kit Distribution The `/kit give` command supports multiple kit distribution modes: - **Single kit:** `/kit give kit_name` - Gives one specific kit. - **Equal weight:** `/kit give kit_a,kit_b,kit_c` - Randomly selects from kits with equal probability. - **Weighted random:** `/kit give 50%kit_a,30%kit_b,20%kit_c` - Selects kits based on specified weight percentages. --- ## World Event Commands | Command | Default Permission | Description | |---|---|---| | `/worldevent` | `lodestone.observer.commands.worldevent` | Opens the world event manager GUI. | | `/worldevent start <event_id>` | `lodestone.observer.commands.worldevent` | Activates a world event and broadcasts its translation. | | `/worldevent end <event_id>` | `lodestone.observer.commands.worldevent` | Deactivates a currently active world event. | | `/worldevent delete <event_id>` | `lodestone.observer.commands.worldevent` | Permanently deletes a world event. Cannot delete active events. | --- ## Player Commands | Command | Permission | Description | |---|---|---| | `/helpop <message>` | None | Submits a help request to online staff. Subject to cooldown. | | `/helpop` | `lodestone.observer.staff` | Opens the HelpOp list GUI (staff only). | | `/withdraw [amount]` | None | Withdraws hearts from your health as items. Requires lifesteal to be enabled with `can_withdraw: true`. Defaults to 1 heart if no amount is specified. | --- ## Late Scatter Commands These are registered as root-level commands (not subcommands of `/latescatter`). | Command | Permission | Description | |---|---|---| | `/save` | `lodestone.observer.commands.latescatter.save` | Saves the current late scatter configuration. | | `/exit` | `lodestone.observer.commands.latescatter.exit` | Exits the late scatter configuration mode. | --- ## Renaming Commands All staff commands (except `/observer`, `/helpop`, and `/withdraw`) can be renamed by changing the corresponding value in `commands.namespaces` in `config.yml`. For example, to rename `/kit` to `/loadout`, set: ```yaml commands: namespaces: kit: "loadout" ``` --- ## Related Pages - [[Observer/Server Owners/Overview]] - Plugin overview and features - [[Observer/Server Owners/Configuration]] - Full configuration reference