# Commands & permissions

Join games, manage parties and use the arena, weapon and moderation tools.

## Main commands

`/zombiesurvival` has the aliases `/zs`, `/zombie` and `/zombies`. `/party` also has `/zsparty`, `/zsp` and `/p`; `/game` has `/g`. `/leave` also accepts `/hub`, `/lobby` and `/quit`.

Aliases can overlap with other plugins. Prefer the full command when diagnosing a conflict.

## Player commands

| Command | Purpose |
| --- | --- |
| `/zs join <arena>` | Join an arena |
| `/zs autojoin` | Join an available game automatically |
| `/zs about` | Show plugin information |
| `/leave` | Leave the game and return to the lobby |
| `/party create` | Create a party |
| `/party invite <player>` | Invite a player |
| `/party join <leader>` | Accept a party invitation |
| `/party leave` | Leave your party |

Ordinary join/about subcommands do not require the administrator permission. Party size limits and invitations depend on your configuration.

## Administrator tools

The current handlers check `zombiesurvival.admin` for these tools:

| Command | Purpose |
| --- | --- |
| `/zs setup` | Open the world-specific arena setup menu |
| `/zs arena` | Show arena creation, room, spawn and template commands |
| `/zs station` | Show station creation options |
| `/zs station cancel` | Cancel the current station flow |
| `/zs machine <place\|remove\|list> [type] [cost]` | Manage custom machine blocks |
| `/zs weapons install` | Install bundled WeaponMechanics definitions and pack assets |
| `/zs weapons list` | List configured weapons |
| `/zs setlobby` | Set the main lobby location |
| `/zs lobby` | Teleport to the main lobby while outside a game |
| `/zs editmode` | Toggle the editing mode |
| `/zs teleport <world>` | Teleport to a world |
| `/zs reload` | Reload plugin configuration |

Most setup tools must be used in-game. Weapon installation and listing can also run from the console. Use `/zs arena` and `/zs station` for their detailed argument help.

## Game moderation

`/game start`, `/game stop` and `/game mod` require `zombiesurvival.game` and operate on the game you are in. `/game` is a moderation command, not a player joining interface.

## Declared permission nodes

| Node | Declared default | Meaning |
| --- | --- | --- |
| `zombiesurvival.admin` | Operator | Administrative tools; declares setup, reload and game children |
| `zombiesurvival.setup` | Operator | Declared setup permission |
| `zombiesurvival.reload` | Operator | Declared reload permission |
| `zombiesurvival.game` | Operator | Force-start, stop and moderate games |
| `zombiesurvival.bonus` | False | Configurable bonus end-of-game reward |

The descriptor declares separate setup and reload nodes, but the current setup/reload handlers check `zombiesurvival.admin`. Granting only the narrower declared node does not unlock those handlers in this build.