> 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/restricting-worlds.md).

# World Access

Configure entry restrictions, builder list requirements, and builder overrides to control player actions in specific worlds.

***

## 1. Entry Permissions

Every world can be assigned a required permission node that players must hold to teleport into or enter the world:

* **Assigning a Permission**: In the World Editor GUI or via `/worlds setPermission <world> <permission_node>`.
* **Disabling Entry Lock**: Set the permission to `-` to allow unrestricted entry.
* **Default Setup**: Configured in `config.yml` under `world.defaults.permission` (defaults to `-` for public worlds and `worlds.%world%` for private worlds).
* **Bypass Permission**: A player can bypass entry locks if they have:
  * `buildsystem.bypass.permission.public` (for public worlds)
  * `buildsystem.bypass.permission.private` (for private worlds)
  * `buildsystem.bypass.permission.archive` (for archived worlds)
  * `buildsystem.admin` (all-access override)

***

## 2. Modification & Builder Rules

To restrict blocks from being broken, placed, or interacted with:

### The Builder Whitelist (`builders-enabled`)

If builders-enabled is toggled to `true` (default: `true` for private worlds, `false` for public worlds):

* **Owner/Creator**: The world's registered creator is automatically allowed to build.
* **Whitelisted Builders**: Only players added via `/worlds addBuilder <player>` can modify blocks.
* **Restricting Non-Builders**: Non-builders are blocked from:
  * Placing or breaking blocks.
  * Interacting with containers (if `settings.builder.block-worldedit-non-builder` is enabled in `config.yml`, this includes WorldEdit and brush commands).

### Modification Override

A player who is not a builder can modify the world if they hold:

* `buildsystem.bypass.builders`
* `buildsystem.admin`
* Or have toggled on Build Mode (`/build`) if they have permission to do so.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://buildsystem.eintosti.de/v4/permissions-and-access/restricting-worlds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.