Organizing Folders

Group worlds into folders and pin the ones you use most.

To keep the world navigator clean, worlds can be organized inside virtual directories called Folders and highlighted using Pinned Worlds.

---

Folders or Categories?

Both group worlds, which makes them easy to confuse. The difference is who decides membership.

	Folder	Category
Membership	You put worlds in by hand	The world's status decides, automatically
A world can be in	One folder	Every category that lists its status
Appears as	A clickable directory inside a tab	A tab in the navigator itself
Managed with	/worlds folder … or the navigator	/setup → Navigator Layout
Good for	"The 2024 spawn project", "Adam's builds"	"Everything still in progress", "Everything archived"

A short way to hold it: a category answers a question about a world's state, and a folder is a box you chose to put something in.

They nest. A folder lives inside exactly one category, so a folder in the Archive tab holds archived worlds. If you change a world's status so it no longer belongs in that category, it stops appearing there even though it is still in the folder.

Deleting a category re-homes its folders to the default category rather than deleting them, so the worlds inside stay reachable. See Custom Statuses & Categories.

---

World Folders

Folders categorize worlds within the Navigator (Public, Private, or Archive tabs).

World Navigator Folders

Creating a Folder

1. Open the Navigator (/worlds).

2. Navigate to the desired category tab.

3. Click the Birch Wood Skull button (requires permission buildsystem.create.folder).

4. Type the folder name in chat and press Enter.

Managing Folders via Commands

Operation	Command	Permission	Description
Add World	/worlds folder <folder> add <world>	buildsystem.folder.add	Places a world inside a folder. A world can only reside in one folder at a time.
Remove World	/worlds folder <folder> remove <world>	buildsystem.folder.remove	Removes a world from its folder.
Delete Folder	/worlds folder <folder> delete	buildsystem.folder.delete	Deletes the folder. Can only be done if the folder is empty of worlds and subfolders.
Set Permission	/worlds folder <folder> setPermission <permission>	buildsystem.folder.setpermission	Restricts access to all worlds inside this folder.
Set Project	/worlds folder <folder> setProject <name>	buildsystem.folder.setproject	Tags all worlds inside this folder with a project name.
Set Display Item	/worlds folder <folder> setItem <Material>	buildsystem.folder.setitem	Sets the item representing the folder in the GUI.

If enabled in config.yml (override-permissions and override-projects), worlds automatically inherit their parent folder's permissions and project names. Once removed, they revert to their previous standalone values.

---

Pinned Worlds (New in 4.0.0)

Pinned Worlds allow administrators to force specific worlds to always display at the top of navigator lists, bypassing the player's active sorting configuration.

Behavior

• Priority Sorting: Pinned worlds are sorted above all unpinned worlds in the navigator, regardless of whether the active sort is alphabetical, by project, status, or date.

• Prefix Indicator: Pinned worlds display a configurable prefix before their names in menus.

• Management: Can be toggled on or off from the world's Edit Menu (right-click the world in /worlds or use /worlds edit).

Requirements

• Permission: buildsystem.edit.pin (Default: OP)