> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/0x48lab/skills/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin commands

> Admin commands for managing player skills, giving items, and reloading configuration.

All admin commands use the `/skilladmin` command (alias `/sa`) and require the `skills.admin` permission, which defaults to `op`.

<Tip>
  Tab completion is fully supported for all subcommands, including player names, skill names, spell names, and item types. Start typing and press Tab to see suggestions.
</Tip>

## Command overview

| Subcommand | Usage                                                  | Description                      |
| ---------- | ------------------------------------------------------ | -------------------------------- |
| `check`    | `/skilladmin check <player>`                           | View a player's skill values     |
| `set`      | `/skilladmin set <player> <skill> <value>`             | Set a skill to a specific value  |
| `setstat`  | `/skilladmin setstat <player> <STR\|DEX\|INT> <value>` | Set a derived stat directly      |
| `reset`    | `/skilladmin reset <player>`                           | Reset all skills to 0            |
| `reload`   | `/skilladmin reload`                                   | Reload config and language files |
| `give`     | `/skilladmin give <player> <item> [options]`           | Give a player a plugin item      |

Running `/skilladmin` with no arguments displays the help menu.

***

## /skilladmin check

View a player's skill sheet, including their title, STR/DEX/INT stats, total skill points, and every individual skill value with its lock mode.

Works for both online and offline players.

```
/skilladmin check <player>
```

**Example**

```
/skilladmin check Steve
```

**Sample output**

```
=== Steve's Skills ===
Title: Grandmaster Swordsman

STR: 80  DEX: 45  INT: 60
Total: 540.0 / 700

─── Combat ───
  Swordsmanship: 100.0 ▲
  Tactics: 85.3 ▲
  ...
```

***

## /skilladmin set

Set a single skill to a specific value for an online player. The value must be between 0 and 100.

Skill names support spaces (e.g., `Mace Fighting`) and are not case-sensitive.

```
/skilladmin set <player> <skill name> <value>
```

**Examples**

```
/skilladmin set Steve Swordsmanship 100
/skilladmin set Steve Mace Fighting 50
/skilladmin set Steve magery 75
```

<Note>
  The target player must be online. The value is clamped to 0–100. After setting, the player's total skill points are recalculated immediately.
</Note>

***

## /skilladmin setstat

Directly set a player's STR, DEX, or INT stat value, bypassing the skill-based calculation. Useful for testing or corrective adjustments.

```
/skilladmin setstat <player> <STR|DEX|INT> <value>
```

**Examples**

```
/skilladmin setstat Steve STR 80
/skilladmin setstat Alex DEX 50
```

***

## /skilladmin reset

Reset all skill values for an online player to 0. The player's total skill points return to 0 and all lock modes are cleared.

```
/skilladmin reset <player>
```

**Example**

```
/skilladmin reset Steve
```

<Warning>
  This action is irreversible. All skill progress for the player will be permanently deleted. There is no confirmation prompt.
</Warning>

***

## /skilladmin reload

Reload `config.yml` and all language files from disk without restarting the server. Player data currently in memory is not affected.

```
/skilladmin reload
```

***

## /skilladmin give

Give a plugin item directly to an online player. Supports spellbooks, runebooks, blank runes, reagents, and scrolls.

### Spellbook

```
/skilladmin give <player> spellbook [blank]
```

| Option        | Result                               |
| ------------- | ------------------------------------ |
| *(no option)* | Full spellbook containing all spells |
| `blank`       | Empty spellbook with no spells       |

**Examples**

```
/skilladmin give Steve spellbook
/skilladmin give Steve spellbook blank
```

***

### Scroll

Give one or all spell scrolls.

```
/skilladmin give <player> scroll <spellname|all>
```

**Examples**

```
/skilladmin give Steve scroll fireball
/skilladmin give Steve scroll all
/skilladmin give Steve scroll Magic Arrow
```

***

### Rune

Give a blank rune (unmarked amethyst shard). Players can use `/cast mark` to record a location on it.

```
/skilladmin give <player> rune
```

**Example**

```
/skilladmin give Steve rune
```

***

### Runebook

Give a runebook — a book that holds up to 16 marked runes and allows Recall or Gate Travel directly from a GUI.

```
/skilladmin give <player> runebook
```

**Example**

```
/skilladmin give Steve runebook
```

***

### Reagents

Give one full stack (64) of every reagent material used by any spell. Useful for testing magic without gathering.

```
/skilladmin give <player> reagents
```

**Example**

```
/skilladmin give Steve reagents
```

***

## Legacy command names

In earlier versions of the plugin, admin operations were available as standalone commands (`/skillcheck`, `/skillset`, `/skillreset`). These have been consolidated into `/skilladmin` subcommands. Update any scripts or command blocks to use the new syntax.

| Old command                          | New equivalent                             |
| ------------------------------------ | ------------------------------------------ |
| `/skillcheck <player>`               | `/skilladmin check <player>`               |
| `/skillset <player> <skill> <value>` | `/skilladmin set <player> <skill> <value>` |
| `/skillreset <player>`               | `/skilladmin reset <player>`               |