> 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/v4/permissions-and-access/navigator.md).

# Navigator

To control access to the worlds navigator GUI and item assignment, configure the following nodes:

***

## Permission Nodes

### Opening the Navigator

Enables the `/worlds` command to open the navigator inventory.

* **Permission**: `buildsystem.navigator`
* **Default**: Granted to all players (`true`).

### Receiving the Navigator Item

Enables receiving and using the physical clock navigator item specified in `config.yml`. If this node is denied or not held, the item will not be placed in the player's inventory on join, and they cannot interact with it to open the menu.

* **Permission**: `buildsystem.navigator.item`
* **Default**: Granted to all players (`true`).

### Per-Category Access

Controls a single navigator category, by id. This is one node for two things: whether the category's tab shows in the navigator, and whether its `/worlds <categoryId>` command shortcut works. Deny it to hide a category from a player and disable its command at the same time.

* **Permission**: `buildsystem.navigator.category.<categoryId>` (e.g. `buildsystem.navigator.category.public`, `buildsystem.navigator.category.archive`, or a custom `buildsystem.navigator.category.events`)
* **Default**: Allowed unless explicitly set to `false`. The node is consulted only when an admin has set it, so by default every category is visible and every shortcut works, matching how the navigator shows all categories out of the box.
