Skip to content

Getting Started

This guide will walk you through installing and configuring the Achievement & Title System.

Download the latest version from CurseForge.

Place the JAR file in your server’s plugins/ directory:

your-server/
├── plugins/
│ └── KyuubiSoftAchievements-X.X.X.jar ← Place here
├── worlds/
└── ...

Start or restart your Hytale server. The plugin will automatically generate the config folder:

plugins/KyuubiAchievements/
├── config.json # Main configuration
├── configs/ # Standard achievements
│ ├── achievements.json
│ ├── mmo_achievements.json
│ └── rpg_leveling_achievements.json
└── custom/ # Your custom achievements
└── *.example templates

Check the server console for:

[KyuubiSoft Achievements] Achievement system loaded with 487 achievements
[KyuubiSoft Achievements] Loaded language: en-US

As a player, type /achievements (or /ac) to open the achievement gallery.

Type /titles (or /title) to see your unlocked titles.

If you have admin permissions, test the system:

Terminal window
# Grant yourself an achievement
/achievementadmin grant YourName first_blood
# List your achievements
/achievementadmin list YourName

The main configuration file is config.json. Here’s a minimal example:

{
"language": "en-US",
"display": {
"displayMode": "both",
"titlePosition": "prefix",
"titleColor": "#FFD700"
},
"notifications": {
"enabled": true,
"displayMode": "both",
"displayDurationMs": 5000
}
}

See Configuration for detailed options.