# Commands

# Commands Reference

:::caution[In development]
This page describes the current development build (4.4.3).
:::

All commands use the `/ksdungeon` prefix. Aliases: `dungeon`, `dg`.

## Player Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/ksdungeon open` | Open the dungeon browser: pick a biome and a difficulty, then start a run. Aliases `menu`, `ui` | `ks.dungeon.user.use` |
| `/ksdungeon play` | Start a quick run in the first biome (Medium, circular, Normal) | `ks.dungeon.user.use` |
| `/ksdungeon leave` | Leave the current dungeon run | `ks.dungeon.user.use` |
| `/ksdungeon party create` | Create a party (inviting players is not available yet) | `ks.dungeon.user.use` |
| `/ksdungeon party leave` | Leave your party | `ks.dungeon.user.use` |
| `/ksdungeon maps` | Open the maps window: map details, apply stones, combine maps | `ks.dungeon.user.map.use` |
| `/ksdungeon mapinfo` | Print the first dungeon map in your inventory to chat (biome, rarity, level, quality, size, shape, modifiers). Alias `inspect` | `ks.dungeon.user.map.use` |

All player permissions are granted by default. Using a map item needs `ks.dungeon.user.map.use`, applying a stone by right-click needs `ks.dungeon.user.stone.use`.

## Admin and Test Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/ksdungeon givemap [size] [rarity] [biome]` | Give yourself a newly rolled map. Missing values are random. Size `small`/`medium`/`large`/`massive`, rarity `common` … `legendary`, biome ID such as `stone_caves` | `ks.dungeons.admin` |
| `/ksdungeon givestone` | Give yourself one of each crafting stone | `ks.dungeons.admin` |
| `/ksdungeon testmap [biome]` | Open a small test dungeon with only a few mobs and a boss, without a map | `ks.dungeons.admin` |
| `/ksdungeon browseprefabs` | Prefab file browser (needs KyuubiSoft Core). Currently unavailable: Core's file browser is switched off and only answers with a chat message | `ks.dungeons.admin` |

Examples:

```
/ksdungeon givemap
/ksdungeon givemap massive epic
/ksdungeon givemap small common stone_caves
```

See [Permissions](./permissions) for the full list of nodes.