Commands & Permissions
Comprehensive command and permission reference for server operators and administrators.
Admin Commands (/mapart admin)
Requires the mapart.admin permission node.
| Command | Description | Required Sub-Permission |
|---|---|---|
/mapart admin | Opens the Admin GUI screen to monitor all leases and retry failed resets. | mapart.admin |
/mapart admin inspect | Displays plot metadata and lease status for the admin's current block position. | mapart.admin.inspect |
/mapart admin project <ID|Name> | Displays complete details for the specified project. | mapart.admin |
/mapart admin lease <Lease-ID> | Shows status, expiration, and location for any lease. | mapart.admin |
/mapart admin plot <Type> <Index> | Displays lease status for a specific plot coordinate (e.g. 128 0). | mapart.admin |
/mapart admin tp <Lease-ID> | Teleports the administrator to the center of the specified lease. | mapart.admin |
/mapart admin force-release <Lease-ID> [confirm] | Forcibly terminates a lease and triggers plot reset. | mapart.admin.reset |
/mapart admin retry-reset <Lease-ID> | Retries a plot reset that ended in a RESET_FAILED state. | mapart.admin.reset |
/mapart admin audit [Limit] | Displays recent audit events (default: 20, max: 100). | mapart.admin |
/mapart admin transactions | Lists unresolved payment transactions requiring reconciliation. | mapart.admin |
/mapart admin transaction resolve <ID> <State> confirm | Records reconciliation resolution (failed, refunded, or review). | mapart.admin |
Permission Nodes
Player Permissions
Granted to all players by default (true).
| Permission | Default | Description |
|---|---|---|
mapart.use | true | Allows running /mapart and opening the main GUI. |
mapart.project.create | true | Allows creating new projects. |
mapart.project.manage | true | Allows managing member lists, archiving, and deleting owned projects. |
mapart.rent | true | Allows renting plots under a project. |
mapart.lease.extend | true | Allows extending lease durations. |
mapart.lease.release | true | Allows releasing owned leases. |
mapart.teleport | true | Allows teleporting to leased plots via /mapart lease tp. |
Administrator Permissions
Granted to server operators (OPs) by default (op).
| Permission | Default | Description |
|---|---|---|
mapart.admin | op | Grants access to /mapart admin commands and the admin GUI. |
mapart.admin.bypass | op | Bypasses plot movement, block, and interaction protections. |
mapart.admin.reset | op | Allows executing force-release and retry-reset. |
mapart.admin.inspect | op | Allows using /mapart admin inspect. |
Restricting OP protection bypass
To prevent accidental modifications while building as an operator, you can explicitly negate mapart.admin.bypass: false in your permissions manager (such as LuckPerms).