For the complete documentation index, see llms.txt. This page is also available as Markdown.

Organizing Folders

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


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)

Last updated