# Commands & Permissions

---

## Commands

### /spells

Opens the Spell Menu where you can view all spells, configure options, and set up your hotbar.

| Permission | For |
|------------|-----|
| *(none)* | Opens your own spell menu |
| `alkatraz.command.spells.other` | `/spells <player>` to view another player's spells |

### /recipes

Opens the **Recipe Manager** -- a category-based GUI for browsing, searching, editing, and crafting magic item recipes. See [Recipes](Recipes.md) for full details.

With no arguments, opens the Recipe Manager GUI (players only).

| Subcommand | Syntax | Permission | Description |
|------------|--------|------------|-------------|
| `unlock` | `/recipes unlock <id> [player]` | `alkatraz.recipe.unlock` | Unlock a recipe for a player |
| `lock` | `/recipes lock <id> [player]` | `alkatraz.recipe.lock` | Lock a recipe for a player |
| `give` | `/recipes give <id> [player]` | `alkatraz.recipe.give` | Grant a recipe to a player |
| `check` | `/recipes check <player> <id>` | `alkatraz.recipe.check` | Check a player's unlock status |
| `reload` | `/recipes reload` | `alkatraz.recipe.reload` | Reload recipe definitions from disk |

| Permission | For |
|------------|-----|
| `alkatraz.recipes.view` | Open the Recipe Manager (default: true) |
| `alkatraz.recipebook` | Legacy recipe book access (default: true) |
| `alkatraz.recipes.edit` | Edit any recipe (default: op) |
| `alkatraz.recipes.edit.<category>` | Edit recipes in one category (`crafting`, `furnace`, `blast_furnace`, `smoker`, `campfire`, `brewing`, `smithing`, `stonecutter`, `other`; default: false) |
| `alkatraz.recipes.delete` | Delete recipes (default: op) |
| `alkatraz.recipes.create` | Create and duplicate recipes (default: op) |

### /cast

Casts a spell from an open grimoire lectern. Requires a cast token from the lectern interaction.

| Permission | For |
|------------|-----|
| *(none)* | Casts from an open grimoire |

### /alkatraz

The main admin command with several subcommands.

| Subcommand | Syntax | Permission | Description |
|------------|--------|------------|-------------|
| `discoverspell` | `/alkatraz discoverspell <spell> [player]` | `alkatraz.command.discoverspell` | Unlocks a spell for a player |
| `undiscoverspell` | `/alkatraz undiscoverspell <spell> [player]` | `alkatraz.command.undiscoverspell` | Removes a spell from a player |
| `give` | `/alkatraz give <item> [count] [player]` | `alkatraz.command.give` | Gives a magic item or engraving to a player (drops overflow items) |
| `arcaneknowledge` | `/alkatraz arcaneknowledge set\|add <amount> [player]` | `alkatraz.command.experience` | Sets or adds arcane knowledge |
| `ak` | Alias for `arcaneknowledge` | `alkatraz.command.experience` | -- |
| `experience` | Alias for `arcaneknowledge` | `alkatraz.command.experience` | -- |
| `circle` | `/alkatraz circle set\|add <level> [player]` | `alkatraz.command.cirlce` | Sets or adds circle level (0-9) |
| `mastery` | `/alkatraz mastery <spell> set\|add <amount> [player]` | `alkatraz.command.mastery` | Sets or adds spell mastery |
| `stats` | `/alkatraz stats [player]` | `alkatraz.command.stats.other` (for others) | Opens stats GUI |
| `reload` | `/alkatraz reload` | `alkatraz.command.reload` | Reloads all configuration |
| `summon` | `/alkatraz summon <mob> [count] [location\|player]` | `alkatraz.command.summon` | Spawns magic mobs; `location` is `x,y,z` coordinates |
| `castmode` | `/alkatraz castmode code\|hotbar` | *(none)* | Switches casting mode |
| `mode` | Alias for `castmode` | *(none)* | -- |
| `equipment` | `/alkatraz equipment [player]` | `alkatraz.command.equipment` | Opens the Equipment Menu |
| `eq` | Alias for `equipment` | `alkatraz.command.equipment` | -- |
| `editor` | `/alkatraz editor` | `alkatraz.command.editor` | Opens the Item Editor GUI |
| `convert` | `/alkatraz convert [player]` | `alkatraz.command.convert` | Converts legacy NBT wands to new magic item system |
| `profile` | `/alkatraz profile [player]` | `alkatraz.command.profile` | Views a player's full profile |
| `test` | `/alkatraz test` | *(none)* | Debug: spawns a grimoire lectern |

---

## Permissions

All permissions default to **false** (not granted to anyone unless explicitly given).

| Permission Node | Description |
|----------------|-------------|
| `alkatraz.allspells` | Bypass discovery requirement -- cast any spell |
| `alkatraz.nocooldown` | Bypass spell cooldowns |
| `alkatraz.recipebook` | Legacy: Open the Recipe Book |
| `alkatraz.recipes.view` | Open the Recipe Manager GUI |
| `alkatraz.recipes.edit` | Edit any recipe in the Recipe Manager |
| `alkatraz.recipes.edit.<category>` | Edit recipes in a single category |
| `alkatraz.recipes.delete` | Delete recipes in the Recipe Manager |
| `alkatraz.recipes.create` | Create and duplicate recipes |
| `alkatraz.recipe.unlock` | Unlock recipes via command |
| `alkatraz.recipe.lock` | Lock recipes via command |
| `alkatraz.recipe.give` | Grant recipes via command |
| `alkatraz.recipe.check` | Check recipe unlock status |
| `alkatraz.recipe.reload` | Reload recipe definitions |
| `alkatraz.command.spells.other` | View another player's spell menu |
| `alkatraz.command.give` | Give items via /alkatraz give |
| `alkatraz.command.mastery` | Modify spell mastery |
| `alkatraz.command.experience` | Modify arcane knowledge |
| `alkatraz.command.cirlce` | Modify circle level |
| `alkatraz.command.discoverspell` | Unlock spells for players |
| `alkatraz.command.undiscoverspell` | Remove spells from players |
| `alkatraz.command.stats.other` | View another player's stats |
| `alkatraz.command.reload` | Reload plugin configuration |
| `alkatraz.command.summon` | Spawn magic mobs |
| `alkatraz.command.equipment` | Open the Equipment Menu |
| `alkatraz.command.editor` | Open the Item Editor |
| `alkatraz.command.convert` | Convert legacy wands |
| `alkatraz.command.profile` | View player profiles |

---

## Permission Setup Examples

### Grant all commands to admins

```yaml
permissions:
  alkatraz.admin:
    default: op
    children:
      alkatraz.command.give: true
      alkatraz.command.mastery: true
      alkatraz.command.experience: true
      alkatraz.command.cirlce: true
      alkatraz.command.discoverspell: true
      alkatraz.command.undiscoverspell: true
      alkatraz.command.stats.other: true
      alkatraz.command.reload: true
      alkatraz.command.summon: true
      alkatraz.command.spells.other: true
      alkatraz.command.equipment: true
      alkatraz.command.editor: true
      alkatraz.command.convert: true
      alkatraz.command.profile: true
      alkatraz.allspells: true
```

### Grant all spells to donators

```yaml
permissions:
  donor.allspells:
    default: false
    children:
      alkatraz.allspells: true
```