# Title System

# Title System

> **Mod:** `kyuubisoft-achievements.jar` | **Config:** `mods/kyuubisoft_achievements/config.json`

The Title System lets players unlock and display titles earned from achievements and quests. Titles appear next to the player's name and can be customized with colors.

## Features

- **Unlockable Titles** — Earned through achievements
- **Color Customization** — Titles support color formatting
- **Title Selection** — Players can choose which unlocked title to display
- **Reward Integration** — Titles can be rewards for achievements and quests

## Quick Start

1. Titles are part of the Achievement mod — install it in `mods/`
2. Title definitions are included in achievement configs
3. Players use `/kstitles` to open the titles tab of the achievement book and pick a title
4. Add title rewards to achievements or quests in their JSON configs

## Commands

| Command | Alias | Description | Permission |
|---------|-------|-------------|------------|
| `/kstitles` | `/title` | Open the titles tab of the achievement book | `ks.achievements.user.titles` (allowed by default) |

There is no separate command to give a title. A title comes with its achievement: to hand one out, grant the achievement with `/ksachievementadmin grant <player> <achievementId>` (needs `ks.achievements.admin`), or use the [Achievements admin window](https://wiki.kyuubisoft.com/hytale/achievement-system/admin-panel/).

## Documentation

<DocCardList />