# Creating a Folder

## Creating a new folder

Before stating, make sure you have the permission `buildsystem.create.folder`. Then, to create a folder, head to the navigator and click the birch wood skull:

<figure><img src="/files/XV6GXh46VgYIpjn8WYog" alt="" width="375"><figcaption><p>Button for creating a folder</p></figcaption></figure>

***

Then you will be prompted to enter a folder name into the chat (similarly to when creating a world):

<figure><img src="/files/ThBOXTK2DRceBiYWBdYG" alt="" width="375"><figcaption><p>Prompt for entering folder name</p></figcaption></figure>

***

Easy as that. The folder has now been added to the category (public/private/archive) in which the button was clicked

<figure><img src="/files/uanNhKx3DJvkZff8KjHx" alt="" width="375"><figcaption><p>The newly created folder</p></figcaption></figure>

## Managing a folder

There are now a few commands which can be performed by players that have the necessary permissions:

### Adding worlds to a folder

{% hint style="warning" %}
A world can only be in one folder at a time.
{% endhint %}

* Command: `/worlds folder <folder> add <world>`
* Permission: `buildsystem.folder.add`

When a world is in a folder, it will inherit the folder's **permission** and **project** as long as the config options (`folder.override-permissions` and `folder.override-projects` respectively) are enabled.

### Removing worlds from a folder

* Command: `/worlds folder <folder> remove <world>`
* Permission: `buildsystem.folder.remove`

When a world is removed from a folder, it will regain its previous permission and project.

### Deleting a folder

{% hint style="warning" %}
A folder can only be deleted after all contained worlds & subfolders have been removed.
{% endhint %}

* Command: `/worlds folder <folder> delete`
* Permission: `buildsystem.folder.delete`

### Other commands

#### **Setting a folder's permission**

* Command: `/worlds folder <folder> setPermission`
* Permission: `buildsystem.folder.setpermission`

#### **Setting a folder's project**

* Command: `/worlds folder <folder> setProject`
* Permission: `buildsystem.folder.setproject`

#### **Setting a folder's navigator icon**

* Command: `/worlds folder <folder> setItem`
* Permission: `buildsystem.folder.setitem`


---

# Agent Instructions: 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/getting-started/creating-a-folder.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.