> ## 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.

# Player commands

> Full reference for all player-facing commands in the Skills plugin.

All player commands require the player to be online and in-game. Console execution is not supported.

## Skills management

### /skills

<ParamField path="/skills" type="command">
  Display your full skill list, grouped by category, with current values and lock mode indicators.
</ParamField>

| Field      | Value        |
| ---------- | ------------ |
| Permission | `skills.use` |
| Alias      | `/skill`     |
| Usage      | `/skills`    |

**Example**

```
/skills
```

Shows all 37 skills organized by category (Combat, Magic, Crafting, Gathering, Thief, Taming, Survival, Other), colour-coded by value, with lock mode symbols (▲/▼/🔒) and your total skill points out of the cap.

***

### /skills list

Identical to `/skills`. Lists all skills with values and lock modes.

| Field      | Value          |
| ---------- | -------------- |
| Permission | `skills.use`   |
| Usage      | `/skills list` |

**Example**

```
/skills list
```

***

### /skills lock \<skill>

Cycle the lock mode for a skill through three states:

| Mode   | Symbol | Effect                                 |
| ------ | ------ | -------------------------------------- |
| UP     | ▲      | Skill can increase; decreases normally |
| DOWN   | ▼      | Skill can decrease; cannot increase    |
| LOCKED | 🔒     | Skill neither increases nor decreases  |

Each call cycles to the next mode in order: UP → DOWN → LOCKED → UP.

| Field      | Value                       |
| ---------- | --------------------------- |
| Permission | `skills.use`                |
| Usage      | `/skills lock <skill name>` |

**Example**

```
/skills lock Swordsmanship
/skills lock Mace Fighting
```

<Tip>
  Tab completion works for skill names, including multi-word names like "Mace Fighting".
</Tip>

***

### /skills guide

Receive the in-game guide book item. If your inventory is full, the book drops at your feet.

| Field      | Value           |
| ---------- | --------------- |
| Permission | `skills.use`    |
| Usage      | `/skills guide` |

**Example**

```
/skills guide
```

***

### /skills sb

Toggle the sidebar scoreboard on or off. The scoreboard displays HP, Mana, Stamina, and your STR/DEX/INT stats.

| Field      | Value        |
| ---------- | ------------ |
| Permission | `skills.use` |
| Usage      | `/skills sb` |

<Note>
  If the server admin has disabled scoreboard toggling (`scoreboard.allow_player_toggle: false`), this command will return an error.
</Note>

**Example**

```
/skills sb
```

***

### /skills language

View or change your display language.

| Field      | Value                              |
| ---------- | ---------------------------------- |
| Permission | `skills.use`                       |
| Usage      | `/skills language [en\|ja\|reset]` |

| Subcommand      | Effect                                                |
| --------------- | ----------------------------------------------------- |
| *(no argument)* | Show your current language and list available options |
| `en`            | Switch to English                                     |
| `ja`            | Switch to Japanese                                    |
| `reset`         | Revert to your Minecraft client's locale setting      |

**Examples**

```
/skills language
/skills language ja
/skills language reset
```

<Note>
  Language switching can be disabled server-wide via `language.allow_player_change: false` in `config.yml`.
</Note>

***

## Stats

### /stats

Display your internal stats: HP, Mana, and the three derived attributes STR, DEX, and INT, along with their effects.

| Field      | Value        |
| ---------- | ------------ |
| Permission | `skills.use` |
| Usage      | `/stats`     |

**Example**

```
/stats
```

**Sample output**

```
=== Your Stats ===
❤ HP: 156 / 180
✨ Mana: 15 / 20
────────────────
Stats: 225 / 300
STR: 80 ▲  (+80 HP, +8% mining, +8% lumber)
DEX: 45 ▼  (+22% attack, +4% move)
INT: 60 🔒  (-30% mana cost, +12% cast)
────────────────
Skills: 540.0 / 700
```

You can also lock individual stats using `/stats lock <str|dex|int> [up|down|locked]`.

***

### /arms

Inspect the weapon or armour you are currently holding. Displays base damage or armor rating, quality tier, durability, and crafter name (for Exceptional items). Requires the Arms Lore skill — higher skill reveals more detail.

| Field      | Value        |
| ---------- | ------------ |
| Permission | `skills.use` |
| Usage      | `/arms`      |
| Alias      | `/armslore`  |

**Example**

```
/arms
```

***

## Magic

### /rune \<Power Words>

Cast a spell using the traditional Ultima Online Power Words incantation instead of the spell's display name. Useful for players who have memorised the incantations.

| Field      | Value                 |
| ---------- | --------------------- |
| Permission | `skills.magic`        |
| Alias      | `/powerwords`, `/pw`  |
| Usage      | `/rune <Power Words>` |

**Examples**

```
/rune In Por Ylem
/rune Vas Flam
/rune Kal Ort Por
```

<Note>
  When two spells share the same Power Words (e.g. "Kal Vas Flam" maps to both Fire Wall and Flamestrike), the lower-circle spell takes priority.
</Note>

***

### /cast \<spellname>

Cast a spell from your spellbook. You must be holding a spellbook in your main hand or off-hand, have the required reagents, and have enough mana.

Casting is a two-phase process:

1. **Casting phase** — a blue boss bar counts down. Moving more than 0.5 blocks cancels the cast.
2. **Targeting phase** — a red boss bar appears. Left-click a target to fire; right-click to cancel.

| Field      | Value                |
| ---------- | -------------------- |
| Permission | `skills.magic`       |
| Usage      | `/cast <spell name>` |

**Examples**

```
/cast fireball
/cast Magic Arrow
/cast Greater Heal
/cast gate travel
```

<Tip>
  Tab completion suggests spell names from your spellbook. Spell names are not case-sensitive.
</Tip>

***

### /cast cancel

Cancel an in-progress cast or targeting phase. No mana or reagents are consumed on cancel.

| Field      | Value          |
| ---------- | -------------- |
| Permission | `skills.magic` |
| Usage      | `/cast cancel` |

**Example**

```
/cast cancel
```

***

### /scribe \<spellname>

Create a spell scroll using the Inscription skill. You must have paper and the required reagents in your inventory. Consumes paper on failure; reagents are only consumed on success.

| Field      | Value                  |
| ---------- | ---------------------- |
| Permission | `skills.magic`         |
| Usage      | `/scribe <spell name>` |
| Alias      | `/inscribe`            |

**Example**

```
/scribe fireball
/scribe Magic Arrow
```

***

### /scribe list

List all spells you can attempt to scribe, along with their required reagents.

| Field      | Value          |
| ---------- | -------------- |
| Permission | `skills.magic` |
| Usage      | `/scribe list` |

**Example**

```
/scribe list
```

***

### /spellbook \[spellname]

Receive a spellbook item. Without arguments, gives an empty spellbook. With a spell name, gives a spellbook containing that single spell.

| Field      | Value                     |
| ---------- | ------------------------- |
| Permission | `skills.magic`            |
| Usage      | `/spellbook [spell name]` |

**Examples**

```
/spellbook
/spellbook fireball
```

***

### /spellbook all

Receive a spellbook containing all spells.

| Field      | Value            |
| ---------- | ---------------- |
| Permission | `skills.magic`   |
| Usage      | `/spellbook all` |

**Example**

```
/spellbook all
```

***

### /spellbook list

List all available spell names.

| Field      | Value             |
| ---------- | ----------------- |
| Permission | `skills.magic`    |
| Usage      | `/spellbook list` |

**Example**

```
/spellbook list
```

***

### /evaluate

Enter targeting mode and click a player to check their current mana and maximum mana. Requires the Evaluating Intelligence skill. Lower skill values introduce measurement error (up to ±20% at skill 0; exact at skill 100).

| Field      | Value          |
| ---------- | -------------- |
| Permission | `skills.magic` |
| Usage      | `/evaluate`    |

**Example**

```
/evaluate
```

***

## Thief

### /hide

Attempt to turn invisible. Success rate equals your Hiding skill value as a percentage. Invisibility is broken by attacking, breaking blocks, using items, taking damage, or sprinting.

| Field      | Value          |
| ---------- | -------------- |
| Permission | `skills.thief` |
| Usage      | `/hide`        |

**Example**

```
/hide
```

***

### /detect

Scan nearby players who are hidden. Detection range equals your Detecting Hidden skill ÷ 10 blocks (up to 10 blocks). A successful detect reveals the hidden player and shows their location with particles.

| Field      | Value          |
| ---------- | -------------- |
| Permission | `skills.thief` |
| Usage      | `/detect`      |

**Example**

```
/detect
```

***

### /snoop

Enter targeting mode and click a player to attempt to view their inventory. On failure, the target receives a notification. If you succeed, clicking an item in the opened inventory triggers a Stealing attempt.

| Field      | Value          |
| ---------- | -------------- |
| Permission | `skills.thief` |
| Usage      | `/snoop`       |

**Example**

```
/snoop
```

***

### /poison

Apply poison from a poison potion in your inventory to the weapon you are holding. The weapon gains a poison charge. Each successful hit against a target consumes one charge and inflicts a 5-second poison effect.

| Field      | Value          |
| ---------- | -------------- |
| Permission | `skills.thief` |
| Usage      | `/poison`      |

**Example**

```
/poison
```

***

### /dragoninfo

View the current status of the Ender Dragon, including how many times it has been defeated on this server, its current HP scaling, and the time until the next respawn.

| Field      | Value         |
| ---------- | ------------- |
| Permission | `skills.use`  |
| Alias      | `/dinfo`      |
| Usage      | `/dragoninfo` |

**Example**

```
/dragoninfo
```

***

### /sleep

Count your character as sleeping without actually lying in a bed. Useful when you are far from a bed but want to contribute to the vote-to-skip-night mechanic if the server has it enabled.

| Field      | Value        |
| ---------- | ------------ |
| Permission | `skills.use` |
| Usage      | `/sleep`     |

**Example**

```
/sleep
```

***

## Taming

### /tame

Enter taming mode. Left-click a tameable mob to attempt to tame it. Right-click to cancel. The taming attempt times out after 10 seconds. Holding the mob's favourite food gives a +20% success bonus.

| Field      | Value           |
| ---------- | --------------- |
| Permission | `skills.taming` |
| Usage      | `/tame`         |

**Example**

```
/tame
```

***

### /lore

Enter targeting mode and click a mob to view its HP, status, owner, and tame state. Requires the Animal Lore skill. Higher skill reveals additional detail such as attack power and drops for wild mobs.

| Field      | Value           |
| ---------- | --------------- |
| Permission | `skills.taming` |
| Usage      | `/lore`         |

**Example**

```
/lore
```

***

## Permissions reference

| Permission      | Description                                                              | Default |
| --------------- | ------------------------------------------------------------------------ | ------- |
| `skills.use`    | Access to basic skill commands (`/skills`, `/stats`, `/arms`)            | `true`  |
| `skills.magic`  | Access to magic commands (`/cast`, `/scribe`, `/spellbook`, `/evaluate`) | `true`  |
| `skills.thief`  | Access to thief commands (`/hide`, `/detect`, `/snoop`, `/poison`)       | `true`  |
| `skills.taming` | Access to taming commands (`/tame`, `/lore`)                             | `true`  |
| `skills.admin`  | Access to all admin commands                                             | `op`    |
| `skills.*`      | All of the above                                                         | —       |

<Note>
  `skills.use`, `skills.magic`, `skills.thief`, and `skills.taming` default to `true`, meaning all players have access unless a permissions plugin explicitly denies them.
</Note>