Admin Panel
The Achievement Admin Panel is an in-game configuration UI that lets server administrators edit every setting without touching config files. Changes are made on a working copy and only applied when you press Save.
Opening the Panel
/ksachievementadmin panel
/acadmin panel # Alias
Permission: achievements.admin
Navigation
The panel uses a sidebar with four sections containing seven tabs:
| Section | Tabs |
|---|---|
| Settings | General, Display |
| Features | Notifications, Tracking |
| Management | Admin, Group Prefixes |
| Content | Achievements Browser |
General Tab
Configure language and which achievement packs are loaded.
| Setting | Type | Description |
|---|---|---|
| Language | Dropdown | Display language (en-US, de-DE) |
| Load Default Achievements | Checkbox | Load achievements from configs/achievements.json |
| Load MMO Achievements | Checkbox | Load MMO Skill Tree achievements (requires MMO plugin) |
| Load RPG Leveling Achievements | Checkbox | Load RPG Leveling achievements (requires RPGLeveling plugin) |
Display Tab
Control how titles and RPG levels appear on nametags and in chat.
| Setting | Type | Description |
|---|---|---|
| Display Mode | Dropdown | Where to show titles: nametag, chat, or both |
| Title Position | Dropdown | Position of title: prefix, above, or below |
| Nametag Format | Text | Format string using {title} and {name} placeholders |
| Chat Format | Text | Format string using {title}, {name}, and {message} placeholders |
| Title Color | Text | Default title color as hex (e.g. #FFD700) |
| Show RPG Level | Checkbox | Display player level from the RPGLeveling plugin |
| RPG Level Format | Text | Format using {level} placeholder (e.g. Lv.{level}) |
| RPG Level Color | Text | Level display color as hex (e.g. #55FFFF) |
| RPG Level Position | Dropdown | before_name, after_name, or after_title |
Notifications Tab
Configure how players are notified when they unlock achievements.
| Setting | Type | Description |
|---|---|---|
| Notifications Enabled | Checkbox | Master toggle for unlock notifications |
| Display Mode | Dropdown | Notification method: chat, banner, or both |
| Display Duration | Slider | How long the banner stays visible (1000-15000 ms) |
| Show Rewards in Banner | Checkbox | Display the reward list inside the notification banner |
| Broadcast to Chat | Checkbox | Announce unlocks to all online players |
| Broadcast Format | Text | Format using {player} and {achievement} placeholders |
Tracking Tab
Enable or disable tracking modules and set the auto-save interval.
| Setting | Type | Description |
|---|---|---|
| Save Interval | Slider | How often player data is saved (seconds) |
| Exploration | Checkbox | Track zone discoveries and distance walked |
| Combat | Checkbox | Track kills, damage dealt, and damage taken |
| Progression | Checkbox | Track blocks mined, placed, and items crafted |
| Social | Checkbox | Track chat messages and social interactions |
| Ignore Creative Mode | Checkbox | Do not count progress while in Creative mode |
Admin Tab
Settings for administrative operations and the statistics export system.
| Setting | Type | Description |
|---|---|---|
| Cascade Revoke | Checkbox | When revoking, also revoke all dependent achievements |
| Cascade Warning | Checkbox | Show a warning before cascade revoking |
| Bypass Prerequisites | Checkbox | Allow granting achievements without prerequisites met |
| Export Enabled | Checkbox | Enable periodic statistics export to JSON |
| Export Interval | Slider | Export frequency (seconds) |
| Export Global Stats | Checkbox | Include server-wide achievement statistics |
| Export Leaderboards | Checkbox | Include top-player leaderboards |
| Export Recent Unlocks | Checkbox | Include recently unlocked achievements |
| Leaderboard Size | Slider | Number of entries per leaderboard |
| Recent Unlocks Size | Slider | Number of recent unlock entries |
| Include Player Totals | Checkbox | Include per-player achievement totals |
Group Prefixes Tab
Manage LuckPerms group prefixes that appear alongside titles. Each prefix has a name, display text, color, and priority (higher priority wins).
- Click a prefix to select it, then click again to open the editor overlay
- Add -- create a new group prefix; Delete -- remove the selected prefix (with confirmation)
The editor lets you change the group name, display prefix, hex color, and priority.
Group prefixes map to LuckPerms groups. See LuckPerms Integration for setup details.
Achievements Browser Tab
Browse, inspect, and manage all loaded achievements directly in-game.
Filtering by category (combat, progression, exploration, social, mmo_skills, rpg_leveling) and source (default, custom) via dropdown menus. The list shows 12 achievements per page with icon, ID, category, difficulty, trigger info, and a CUSTOM badge. Selecting an entry opens a detail panel with trigger, prerequisites, rewards, and localized texts.
CRUD operations (custom achievements only):
- Add -- create a new custom achievement via the editor overlay
- Edit -- modify the selected custom achievement
- Copy -- duplicate an achievement as a starting point
- Delete -- remove a custom achievement (with confirmation)
Only custom achievements can be edited or deleted through the browser. Default achievements are read-only.
Save, Cancel, and Reload
The footer bar at the bottom of every tab provides three actions:
| Button | Description |
|---|---|
| Save | Write all changes to config.json and reload the plugin. The label changes when there are unsaved edits. |
| Cancel | Discard all pending changes and revert to the last saved state. |
| Reload | Re-read config.json from disk. Useful after manual file edits. |
The admin panel uses a working-copy system. Nothing takes effect until you press Save. Press Cancel to revert instantly.
Permissions
| Permission | Description |
|---|---|
achievements.admin | Required to open the admin panel and use all admin commands |