> For the complete documentation index, see [llms.txt](https://edelweiss-network.gitbook.io/practicebot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edelweiss-network.gitbook.io/practicebot/server-owner-guide/commands.md).

# commands

Complete PracticeBot 1.9.18-spearmace-beta command reference.

### Commands

Complete PracticeBot 1.9.18-spearmace-beta command reference. `/pbadmin` and its help output are hidden from users who do not have an administrator permission.

#### Player commands

```
/spawnbot [normal|crystal|mace|spear-mace|cart|uhc]
/bot [normal|crystal|mace|spear-mace|cart|uhc]
/pb spawn
/pb info
/pb help
```

`/bot` is an alias of `/spawnbot`. Cart aliases `cartpvp` and `cart_pvp` are accepted; UHC aliases `uhcpvp` and `uhc_pvp` are accepted.

#### Admin entry points

```
/pbadmin help
/pbadmin status
/pbadmin trim
/pbadmin inventory
/pbadmin egui
/pbadmin config
/pbadmin reload <all|config|guis|templates|messages>
/pbadmin cleanup [world]
/pbadmin cleanup [world] confirm
/pbadmin despawn <bot>
```

`trim` and `inventory` open the administrator inventory/armor-trim editor. `egui` opens the GUI editor.

#### License administration

```
/pbadmin license
/pbadmin license status
/pbadmin license refresh
/pbadmin license set <key>
/pbadmin license request
/pbadmin license import <token>
```

`request` creates a manual offline activation request. `import` installs the signed offline lease returned by the activation service. Existing legacy offline keys remain accepted according to the plugin's compatibility rules.

#### Live configuration

```
/pbadmin config list [category]
/pbadmin config get <path>
/pbadmin config set <path> <value>
/pbadmin config reset <path>
```

Only supported, validated paths can be changed. Successful edits apply live without a plugin reload.

#### Bot management

```
/pbadmin bot help
/pbadmin bot list [page] [filters]
/pbadmin bot nearby [radius]
/pbadmin bot total
/pbadmin bot info <id>
/pbadmin bot debug <id>
/pbadmin bot inventory <id>
/pbadmin bot move <id|*> <x> <y> <z> [world]
/pbadmin bot move_here <id|*>
/pbadmin bot teleport <id>
/pbadmin bot stop <id|*>
/pbadmin bot continue <id|*>
/pbadmin bot freeze <id|*>
/pbadmin bot unfreeze <id|*>
/pbadmin bot heal <id|*>
/pbadmin bot restart <id|*>
/pbadmin bot kill <id|*>
/pbadmin bot target <id|*> <player>
/pbadmin bot target_clear <id|*>
/pbadmin bot give_effect <id|*> <effect> [seconds|infinite] [level]
/pbadmin bot remove_effect <id|*> <effect|all>
/pbadmin bot despawn <id|*>
```

Bot completion and lists use `ID (name)`. `*` selects every active bot only on commands that support bulk actions. Inventory viewing is read-only.

**Movement semantics**

* `move` directly teleports the selected bot or bots to the coordinates.
* `move_here` directly teleports the selected bot or bots to the command sender.
* `teleport` teleports the command sender to one bot.

These are teleport operations, not pathfinding or goto commands. Coordinates accept absolute or relative values such as `~` and `~2.5`.

**Bot list filters**

```
--type <normal|crystal|mace|spear-mace|cart|uhc|dummy>
--template <template>
--world <world>
--state <state>
--target <player|none>
--page <page>
```

#### Kill statistics

```
/pbadmin stats get <player> [template]
/pbadmin stats set <player> <template> <amount>
/pbadmin stats reset <player> [template|*]
/pbadmin stats reset * [template|*] confirm
```

The matching PlaceholderAPI value for a player's template kills is `%practicebot_player_kill_<template>%`.

#### Template management

```
/pbadmin template list [page]
/pbadmin template info <template>
/pbadmin template create <template>
/pbadmin template edit <template>
/pbadmin template cancel
/pbadmin template delete <template>
/pbadmin template clone <source> <new-template>
/pbadmin template validate <template|*>
/pbadmin template despawn <template>
/pbadmin template spawn <template> [amount]
/pbadmin template spawn <template> [target] <world> <x> <y> <z> <yaw> <pitch>
```

Bulk template spawning is bounded to 500 bots and schedules the work safely instead of creating every bot in one tick.

#### Spear-Mace aliases

```
/bot spear-mace
/spawnbot spear-mace
```

spear\_mace and spearmace are accepted aliases. The default template can be tested with /pbadmin template spawn spearmace.