# 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="https://497964470-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV2RuUggaaq5upHxVqTiN%2Fuploads%2F3VmIk9a3KXfrNBL72OvW%2F458276007-6d830a19-d8b7-42c3-b7cc-93af626dc751.png?alt=media&#x26;token=2d963746-c589-44fc-8091-fb32484ecffd" 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="https://497964470-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV2RuUggaaq5upHxVqTiN%2Fuploads%2FbjRoFVxxxjW6vYHtfA4P%2F458276752-d55464f5-0d8b-4523-a5ab-3b3259b6e395.png?alt=media&#x26;token=2c66c1fa-30b4-4c9d-99e9-65cade8892ce" 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="https://497964470-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV2RuUggaaq5upHxVqTiN%2Fuploads%2FJeyYn2pnJDji6tRul03O%2F458277896-a2b5f795-7751-4545-a657-0307d3512737.png?alt=media&#x26;token=e2fd8227-f1ad-43d6-ae7b-0252c572061e" 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`