> For the complete documentation index, see [llms.txt](https://buildsystem.eintosti.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://buildsystem.eintosti.de/permissions-and-access/commands.md).

# Commands

Every command node, its default, and the .self and .other suffixes.

This reference lists all default command permission nodes and explains the `.self` vs `.other` modifier rules.

***

## Command Suffix Rules (`.self` / `.other`)

For commands that modify worlds (e.g. changing time, toggling physics, editing status), BuildSystem supports ownership modifiers.

* **Default Suffix**: If no suffix is provided, the permission defaults to `.self`.
  * *Example*: `buildsystem.day` behaves identically to `buildsystem.day.self`.
* **`.self` Permission**: Allows players to run the command **only** inside worlds they created (where they are the registered owner).
  * *Example*: A player with `buildsystem.day.self` can change the time to day only in their own worlds.
* **`.other` Permission**: Allows players to run the command inside worlds created by **someone else**, including worlds with no registered creator.
  * *Example*: A player with `buildsystem.day.other` can change the time in other players' worlds. To cover every world, grant both `buildsystem.day` (or `.self`) and `buildsystem.day.other`.
* **`buildsystem.admin`** passes every one of these checks, whatever the suffixes say.

The suffixes apply to the time and toggle commands (`/day`, `/night`, `/physics`, `/explosions`, `/noai`) and to every `/worlds` subcommand that acts on one world: `addBuilder`, `removeBuilder`, `backup`, `builders`, `delete`, `download`, `edit`, `info`, `rename`, `saveTemplate`, `setCreator`, `setItem`, `setPermission`, `setProject`, `setStatus`, `setSpawn`, `removeSpawn` and `unimport`. Other commands check the bare node only. `/day` and `/night` in a world BuildSystem does not manage also check the bare node.

The bare node also decides whether a `/worlds` subcommand is offered in tab completion.

***

## Global Command Permissions

| Command                        | Permission Node                     | Default (Bukkit) | Description                                                                                                 |
| ------------------------------ | ----------------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------- |
| `/back`                        | `buildsystem.back`                  | `OP`             | Teleport back to the previous location.                                                                     |
| `/blocks`                      | `buildsystem.blocks`                | `OP`             | Opens the custom blocks library GUI.                                                                        |
| `/build`                       | `buildsystem.build`                 | `OP`             | Toggle Build Mode for yourself.                                                                             |
| `/build [player]`              | `buildsystem.build.other`           | `OP`             | Toggle Build Mode for another online player.                                                                |
| `/buildsystem`                 | `buildsystem.help.buildsystem`      | `TRUE`           | Display help pages.                                                                                         |
| `/buildsystem storage migrate` | `buildsystem.storage.migrate`       | `OP`             | Move worlds, folders and players to another storage type.                                                   |
| `/config <reload>`             | `buildsystem.config`                | `OP`             | Reloads `config.yml` and `messages.yml`.                                                                    |
| `/day`                         | `buildsystem.day`                   | `OP`             | Set world time to day (supports `.self` / `.other`).                                                        |
| `/night`                       | `buildsystem.night`                 | `OP`             | Set world time to night (supports `.self` / `.other`).                                                      |
| `/noai`                        | `buildsystem.noai`                  | `OP`             | Toggle Mob AI (supports `.self` / `.other`).                                                                |
| `/physics`                     | `buildsystem.physics`               | `OP`             | Toggle physics simulation (supports `.self` / `.other`).                                                    |
| `/explosions`                  | `buildsystem.explosions`            | `OP`             | Toggle explosions (supports `.self` / `.other`).                                                            |
| `/gm <mode>`                   | `buildsystem.gamemode.<mode>`       | `OP`             | Change your own gamemode. `buildsystem.gamemode` grants all four modes.                                     |
| `/gm <mode> <player>`          | `buildsystem.gamemode.<mode>.other` | `OP`             | Change another player's gamemode. `buildsystem.gamemode.other` grants all four modes.                       |
| `/settings`                    | `buildsystem.settings`              | `OP`             | Open the personal settings panel. Not declared in `plugin.yml`, so grant it to let players use `/settings`. |
| `/setup`                       | `buildsystem.setup`                 | `OP`             | Opens the interactive wizard config menu.                                                                   |
| `/skull <name>`                | `buildsystem.skull`                 | `OP`             | Spawns a custom player head.                                                                                |
| `/speed <val>`                 | `buildsystem.speed`                 | `OP`             | Adjust flight/walk speed.                                                                                   |
| `/spawn`                       | *None*                              | `TRUE`           | Teleport to global spawn point.                                                                             |
| `/spawn [set/remove]`          | `buildsystem.spawn`                 | `OP`             | Modify global spawn point.                                                                                  |
| `/top`                         | `buildsystem.top`                   | `OP`             | Teleport to the highest block above you.                                                                    |

***

## `/worlds` Subcommand Permissions

| Subcommand                         | Permission Node                               | Default (Bukkit) | Description                                                                                                    |
| ---------------------------------- | --------------------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------- |
| `/worlds`                          | `buildsystem.navigator`                       | `TRUE`           | Opens the world navigator menu.                                                                                |
| `/worlds <category>`               | `buildsystem.navigator.category.<categoryId>` | `TRUE`           | Open a category tab directly (one shortcut per category; the same node also gates the tab's visibility).       |
| `/worlds addBuilder`               | `buildsystem.addbuilder`                      | `OP`             | Add a player to the builder whitelist of a world you own.                                                      |
| `/worlds removeBuilder`            | `buildsystem.removebuilder`                   | `OP`             | Remove a player from the builder whitelist.                                                                    |
| `/worlds builders`                 | `buildsystem.builders`                        | `OP`             | Open the builder list of a world.                                                                              |
| `/worlds backup`                   | `buildsystem.backup`                          | `OP`             | View the backup history GUI.                                                                                   |
| `/worlds backup create`            | `buildsystem.backup.create`                   | `OP`             | Force a manual backup creation.                                                                                |
| `/worlds delete`                   | `buildsystem.delete`                          | `OP`             | Permanently delete a world directory.                                                                          |
| `/worlds download`                 | `buildsystem.download`                        | `OP`             | Download a world as a single-player save (supports `.self` / `.other`).                                        |
| `/worlds edit`                     | `buildsystem.edit`                            | `OP`             | Opens the World Editor GUI (supports `.self` / `.other`).                                                      |
| `/worlds edit (Pin)`               | `buildsystem.edit.pin`                        | `OP`             | Toggle Pin status for a world.                                                                                 |
| `/worlds edit (Icon)`              | `buildsystem.edit.icon`                       | `OP`             | Change a world's icon material or, for a player head, its skull texture.                                       |
| `/worlds folder`                   | `buildsystem.folder`                          | `OP`             | Only shows `folder` in tab completion. Each folder operation checks its own node below.                        |
| `/worlds folder ... add`           | `buildsystem.folder.add`                      | `OP`             | Add a world to a folder.                                                                                       |
| `/worlds folder ... remove`        | `buildsystem.folder.remove`                   | `OP`             | Remove a world from a folder.                                                                                  |
| `/worlds folder ... delete`        | `buildsystem.folder.delete`                   | `OP`             | Delete an empty folder.                                                                                        |
| `/worlds folder ... setPermission` | `buildsystem.folder.setpermission`            | `OP`             | Modify parent folder group permissions.                                                                        |
| `/worlds folder ... setProject`    | `buildsystem.folder.setproject`               | `OP`             | Set a folder's project.                                                                                        |
| `/worlds folder ... setItem`       | `buildsystem.folder.setitem`                  | `OP`             | Set a folder's icon to the held item.                                                                          |
| `/worlds help`                     | `buildsystem.help.worlds`                     | `TRUE`           | List the `/worlds` subcommands.                                                                                |
| `/worlds import`                   | `buildsystem.import`                          | `OP`             | Import a single world directory.                                                                               |
| `/worlds importAll`                | `buildsystem.import.all`                      | `OP`             | Run batch directory imports.                                                                                   |
| `/worlds info`                     | `buildsystem.info`                            | `OP`             | Display metadata of a world.                                                                                   |
| `/worlds item`                     | `buildsystem.navigator.item`                  | `TRUE`           | Receive the navigator clock item.                                                                              |
| `/worlds rename`                   | `buildsystem.rename`                          | `OP`             | Rename an existing world.                                                                                      |
| `/worlds setCreator`               | `buildsystem.setcreator`                      | `OP`             | Change registered owner of a world.                                                                            |
| `/worlds setItem`                  | `buildsystem.setitem`                         | `OP`             | Set a world's display icon to the held item.                                                                   |
| `/worlds setProject`               | `buildsystem.setproject`                      | `OP`             | Change project tag of a world (supports `.self` / `.other`).                                                   |
| `/worlds setPermission`            | `buildsystem.setpermission`                   | `OP`             | Change access permission of a world (supports `.self` / `.other`).                                             |
| `/worlds saveTemplate`             | `buildsystem.savetemplate`                    | `OP`             | Save a world into the templates directory at runtime.                                                          |
| `/worlds setSpawn`                 | `buildsystem.setspawn`                        | `OP`             | Set the world's spawn point to the player's current position.                                                  |
| `/worlds removeSpawn`              | `buildsystem.removespawn`                     | `OP`             | Remove the world's custom spawn point.                                                                         |
| `/worlds setStatus`                | `buildsystem.setstatus`                       | `OP`             | Modify world status (supports `.self` / `.other`, and checks dynamic node `buildsystem.setstatus.<statusId>`). |
| `/worlds tp <world>`               | `buildsystem.worldtp`                         | `OP`             | Teleport to a world's spawn location.                                                                          |
| `/worlds unimport`                 | `buildsystem.unimport`                        | `OP`             | Unimport a world directory without deleting files.                                                             |

{% hint style="info" %}
In version 4.0.0, world statuses and navigator categories are fully dynamic. The system enforces dynamic permissions depending on the status or category being manipulated:

* **Assign Status**: Requires `buildsystem.setstatus.<statusId>`. Built-in statuses strip underscores (e.g. `in_progress` → `buildsystem.setstatus.inprogress`); custom statuses use their full id (e.g. `my_status` → `buildsystem.setstatus.my_status`).
* **Create World in Category**: Requires `buildsystem.create.category.<categoryId>` (e.g., `buildsystem.create.category.public` or a custom category `buildsystem.create.category.administration`).
* **View Category / Use Shortcut**: Requires `buildsystem.navigator.category.<categoryId>` (granted by default). Denying it hides the category from the navigator and disables its `/worlds <categoryId>` command together.
  {% endhint %}
