/worlds

The /worlds command (aliases: /w) manages world navigation, folders, properties, and whitelists.

---

Navigation & Editor UI

/worlds

• Syntax: /worlds (or /w)

• Permission: buildsystem.navigator

• Description: Opens the World Navigator main dashboard.

/worlds <category>

• Syntax: /worlds <category> (e.g. /worlds public, /worlds private, /worlds archive, or any custom category id)

• Permission: buildsystem.navigator.<categoryId> (granted by default)

• Description: Opens that category's worlds list directly. One shortcut exists per navigator category and is generated from the navigator, so a custom category gets its command automatically and a deleted one loses it. The same permission also controls whether the category appears in the navigator. If a category id matches a real subcommand (e.g. delete), the subcommand takes precedence and the shortcut is dropped.

/worlds edit [world]

• Syntax: /worlds edit [world]

• Permission: buildsystem.edit (supports .self / .other suffixes)

• Description: Opens the interactive World Editor GUI to adjust settings like physics, difficulty, weather, time, and builders. Defaults to the player's current world if no argument is provided. Clicking the world item at the top opens an icon picker — choose a material, or right-click a player-head icon to set its skull texture (buildsystem.edit.icon).

/worlds tp <world>

• Syntax: /worlds tp <world>

• Permission: buildsystem.worldtp

• Description: Teleports the sender directly to the target world's spawn location.

---

Directory Management

/worlds import <world> [-g generator] [-c creator]

• Syntax: /worlds import <world> [-g <generator> | -c <creator>]

• Permission: buildsystem.import

• Description: Imports a folder present under the server's root as an active build world. The optional -g flag specifies a custom chunk generator plugin; -c registers a player UUID as the world's creator.

/worlds importAll

• Syntax: /worlds importAll [-g <generator> | -c <creator>]

• Permission: buildsystem.import.all

• Description: Batch-imports all unregistered world folders in the server directory. Execution is throttled via the config delay to prevent lag spikes. Accepts the same -g and -c flags as /worlds import.

/worlds unimport <world>

• Syntax: /worlds unimport <world>

• Permission: buildsystem.unimport

• Description: Unloads the world from memory and deletes its BuildSystem registry entries without deleting the directory on disk.

/worlds delete <world>

• Syntax: /worlds delete <world>

• Permission: buildsystem.delete

• Description: Unloads the world and permanently deletes its directory from the server disk.

/worlds saveTemplate <world> [templateName] (New in 4.0.0)

• Syntax: /worlds saveTemplate <world> [templateName]

• Permission: buildsystem.savetemplate

• Description: Saves a copy of the target world directory into plugins/BuildSystem/templates/ to make it selectable during new world creation.

---

Property & Access Mutation

/worlds setCreator <world> <creator>

• Syntax: /worlds setCreator <world> <creator>

• Permission: buildsystem.setcreator

• Description: Sets the registered owner/creator of the world.

/worlds setProject <world> <projectName>

• Syntax: /worlds setProject <world> <projectName>

• Permission: buildsystem.setproject (supports .self / .other suffixes)

• Description: Sets the project tag metadata for the world.

/worlds setPermission <world> <permission>

• Syntax: /worlds setPermission <world> <permission>

• Permission: buildsystem.setpermission (supports .self / .other suffixes)

• Description: Sets the permission node required for players to join the world. Use - to clear permission locks. Checks against world-permission-whitelist if configured.

/worlds setStatus <world> <status>

• Syntax: /worlds setStatus <world> <status>

• Permission: buildsystem.setstatus (supports .self / .other suffixes, and requires the dynamic node buildsystem.setstatus.<statusId> — built-in statuses strip underscores, e.g. in_progress → buildsystem.setstatus.inprogress; custom statuses use their full id)

• Description: Sets the progress state of the world (e.g., not_started, in_progress, almost_finished, finished, archive, hidden or any custom status).

---

Spawn Management

/worlds setSpawn

• Syntax: /worlds setSpawn

• Permission: buildsystem.setspawn

• Description: Sets the exact location of the target world's spawn point to the sender's current position.

/worlds removeSpawn

• Syntax: /worlds removeSpawn

• Permission: buildsystem.removespawn

• Description: Deletes the custom spawn point set for the target world.

---

Whitelist Management

/worlds addBuilder <world> <player>

• Syntax: /worlds addBuilder <world> <player>

• Permission: buildsystem.addbuilder

• Description: Adds a player to the target world's builder list. Only the creator or an admin can manage this list.

/worlds removeBuilder <world> <player>

• Syntax: /worlds removeBuilder <world> <player>

• Permission: buildsystem.removebuilder

• Description: Removes a player from the builder list.

/worlds builders [world]

• Syntax: /worlds builders [world]

• Permission: buildsystem.builders

• Description: Opens a GUI displaying all whitelisted builders for the target world.

---

Folder Management

/worlds folder <folder> add <world>

• Syntax: /worlds folder <folder> add <world>

• Permission: buildsystem.folder.add

• Description: Adds the world to the specified folder.

/worlds folder <folder> remove <world>

• Syntax: /worlds folder <folder> remove <world>

• Permission: buildsystem.folder.remove

• Description: Removes the world from the specified folder.

/worlds folder <folder> delete

• Syntax: /worlds folder <folder> delete

• Permission: buildsystem.folder.delete

• Description: Deletes the empty folder directory.

/worlds folder <folder> setPermission <permission>

• Syntax: /worlds folder <folder> setPermission <permission>

• Permission: buildsystem.folder.setpermission

• Description: Configures an access permission for the folder.

/worlds folder <folder> setProject <project>

• Syntax: /worlds folder <folder> setProject <project>

• Permission: buildsystem.folder.setproject

• Description: Configures a project tag for the folder.

/worlds folder <folder> setItem <Material>

• Syntax: /worlds folder <folder> setItem <Material>

• Permission: buildsystem.folder.setitem

• Description: Sets the display material representing the folder in menus.

---

Utility Commands

/worlds help

• Syntax: /worlds help

• Permission: buildsystem.help.worlds

• Description: Displays the help panel index.

/worlds info [world]

• Syntax: /worlds info [world]

• Permission: buildsystem.info

• Description: Prints world metadata (creation date, physics, AI status, visibility) directly to chat.

Worlds Info Chat

/worlds rename <world>

• Syntax: /worlds rename <world>

• Permission: buildsystem.rename

• Description: Renames the specified world. The plugin prompts for the new name via chat input.

/worlds setItem <world>

• Syntax: /worlds setItem <world>

• Permission: buildsystem.setitem

• Description: Sets the display icon for the specified world to the item currently held in the player's main hand.

/worlds item

• Syntax: /worlds item

• Permission: buildsystem.navigator.item

• Description: Spawns the navigator clock item inside the sender's inventory.