Repository navigation
Setup & Maintenance Commands
Commands used by administrators to configure and maintain the PlotSystem.
These commands should normally only be available to trusted administrators.
Permissions:
plotsystem.admin plotsystem.admin.*
| Command | Permission | Description |
|---|---|---|
/deleteplot <ID> |
plotsystem.admin.deleteplot |
Deletes a plot from the system. |
/setleaderboard <Name> |
plotsystem.admin.setleaderboard |
Sets the position of a leaderboard hologram. |
/preload |
plotsystem.admin.preload |
Reloads the configuration and holograms. |
Permission:
plotsystem.admin.plotmaintenance
| Command | Description |
|---|---|
/plotmaintenance cleanup <amount> [--dry-run] |
Deletes leftover finished one-plot (P-) worlds in batches. Use --dry-run / --dry to preview. |
/plotmaintenance cim <cityId|all> [--dry-run] |
Deletes and recreates City Inspiration Mode worlds, then re-pastes completed plots. Fails if any in-progress CIM plots exist for the target city (would wipe them). |
/plotmaintenance repair <ID> |
Normalizes a completed schematic whose absolute min-Y drifted from the initial schematic, then re-pastes it. |
Only one maintenance job runs at a time.
PlotSystem setup commands use the /pss command.
Wildcard permission:
plotsystem.admin.pss.*
FTP / schematic-sync setup (/pss ftp …) was removed in v5. Schematics are stored in the database.
Permission:
plotsystem.admin.pss.buildteam.*
| Command | Description |
|---|---|
/pss buildteam list |
Lists all build teams. |
/pss buildteam add <Name> |
Creates a new build team. |
/pss buildteam remove <BuildTeam-ID> |
Removes a build team. |
/pss buildteam setname <BuildTeam-ID> <Name> |
Changes the name of a build team. |
/pss buildteam addreviewer <BuildTeam-ID> <Name> |
Adds a reviewer to a build team. |
/pss buildteam removereviewer <BuildTeam-ID> <Name> |
Removes a reviewer from a build team. |
/pss buildteam criteria <BuildTeam-ID> |
Shows or manages the review criteria assigned to a build team. |
/pss buildteam assigncriteria <BuildTeam-ID> <Criteria-Name> |
Assigns review criteria to a build team. |
/pss buildteam removecriteria <BuildTeam-ID> <Criteria-Name> |
Removes review criteria from a build team. |
Permissions:
plotsystem.admin.pss.server plotsystem.admin.pss.server.*
| Command | Description |
|---|---|
/pss server list |
Lists all configured servers. |
/pss server add <Name> <BuildTeam-ID> |
Adds a server and assigns it to a build team. |
/pss server remove <Name> |
Removes a server. |
Permissions:
plotsystem.admin.pss.country plotsystem.admin.pss.country.*
| Command | Description |
|---|---|
/pss country list |
Lists all configured countries. |
/pss country add <Code> <Continent> <Material> <CustomModelData?> |
Adds a country. |
/pss country remove <Country-Code> |
Removes a country. |
/pss country setmaterial <Country-Code> <Material> <CustomModelData?> |
Changes the material used for a country. |
Country display names live in LangLibs language files (database.country.<CODE>.name), not in the database. See Translation.
Permissions:
plotsystem.admin.pss.city plotsystem.admin.pss.city.*
| Command | Description |
|---|---|
/pss city list |
Lists all configured city projects. |
/pss city add <City-Project-Name> <Country-Code> <Server-Name> <Build-Team-ID> |
Creates a new city project. |
/pss city remove <City-ID> |
Removes a city project. |
/pss city setserver <City-ID> <Server-Name> |
Changes the server assigned to a city. |
/pss city setbuildteam <City-ID> <BuildTeam-ID> |
Changes the build team assigned to a city. |
/pss city setvisible <City-ID> <True/False> |
Changes whether a city is visible to players. |
City names/descriptions live in language files (database.city-project.<id>.*), not PSS setname / setdescription (removed in v5).
Permissions:
plotsystem.admin.pss.difficulty plotsystem.admin.pss.difficulty.*
| Command | Description |
|---|---|
/pss difficulty list |
Lists all configured difficulty levels. |
/pss difficulty setmultiplier <Difficulty-ID> <Multiplier> |
Changes the score multiplier of a difficulty. |
/pss difficulty setrequirement <Difficulty-ID> <Score-Requirement> |
Changes the required score for a difficulty. |
Permissions:
plotsystem.admin.pss.review plotsystem.admin.pss.review.*
| Command | Description |
|---|---|
/pss review list |
Lists all review criteria. |
/pss review add <Name> <Is-Optional> |
Creates a new review criterion. |
/pss review remove <Name> |
Removes a review criterion. |
/pss review setoptional <Name> <Is-Optional> |
Changes whether a review criterion is optional. |
Warning
Due to a known quirk, /pss review setoptional currently checks plotsystem.admin.pss.buildteam.setoptional instead of a …pss.review… node. Grant that node (or plotsystem.admin.pss.*) if the command is denied unexpectedly.
See Review System for how criteria affect scores.
Note
When using Sponge-style permissions, only the base permission is required.
For example, instead of:
plotsystem.admin.pss.buildteam.*
you only need:
plotsystem.admin.pss.buildteam
Wildcard permissions can be used to grant access to an entire command group. Full matrix: Permissions.