Achievement & Title System

kyuubisoft

A comprehensive achievement and title system for Hytale servers, featuring 487+ achievements, 80+ unlockable titles, achievement chains with grouped display, and full localization support.

Features

487+ Achievements

Combat: Monster hunting chains, boss kills, PvP milestones, specific creature hunts
Progression: Mining, crafting, building chains with tiered rewards
Exploration: Zone discovery, distance traveled, world exploration
Social: Chat milestones, playtime achievements, community engagement
Husbandry: Animal taming, fishing, farming progression
Secret: Hidden achievements with funny references (Chicken Slayer, Darwin Award, Leeroy Jenkins…)

80+ Titles

Unlock titles by completing achievements
Display titles above your name or as chat prefix
Select your active title via the Title Selection UI
Titles come in various rarities with unique colors

Achievement Chains (Grouped Display)

Achievement chains like “Miner I -> II -> III -> IV” are displayed as a single entry:

Miner [****] 3/4 completed
Next: Mine 10,000 blocks

Progress indicator shows completion at a glance
Shows what’s needed for the next tier
Reduces UI clutter while maintaining full information

Rewards System

Item Rewards: Receive tools, weapons, armor, materials
Lootbag Rewards: Random item pools with weighted chances
Title Rewards: Unlock exclusive titles
Command Rewards: Execute server commands on completion
MMO XP Rewards: Grant skill XP (with MMO Skill Tree integration)
Rewards are automatically granted on achievement completion
Pending rewards can be claimed via /rewards command

Plugin Integrations

LuckPerms: Group prefixes with full color support
MMO Skill Tree: 121 skill-based achievements, 98 skill titles
RPG Leveling: Character level, XP, and mob kill achievements
Showcase: Display achievements in Showcase displays (v2.6.0+)
LevelingCore: Abstraction layer for any leveling plugin (v2.6.0+)

RPG Level Display

Optionally display player levels from RPGLeveling in nametags and chat:

Configurable format and color
Multiple positions: before name, after name, or after title
Example: [Meisterbergmann] Steve [Lv.42]

Stats & Leaderboards

Track individual player statistics
Global server leaderboards
Export stats to JSON for external tools/websites
Recent unlocks feed

Public API

External plugins can interact with the Achievement System:

Query achievement status and progress
Grant/revoke achievements programmatically
Listen for unlock events
Access player statistics

See API Reference for complete documentation.

Admin Tools

/ksachievementadmin panel - Open the admin configuration panel
/ksachievementadmin grant <player> <achievement> - Grant achievements
/ksachievementadmin revoke <player> <achievement> - Revoke achievements
/ksachievementadmin list <player> - View player achievements
/ksachievementadmin simulate <trigger> - Test trigger conditions

Commands

Command	Aliases	Description
`/ksachievements`	`/achievement`, `/ac`	Open the Achievement Gallery UI
`/kstitles`	`/title`	Open the Title Selection UI
`/ksrewards`	`/reward`, `/rw`	View and collect pending rewards
`/kslootbags`	`/lootbag`, `/lb`	Open pending lootbags

Configuration

Starting with v1.6.0, the plugin uses an organized folder structure:

KyuubiAchievements/
├── config.json                    # Main plugin configuration
├── configs/                       # Standard configs (DO NOT MODIFY!)
│   ├── achievements.json
│   ├── mmo_achievements.json
│   └── rpg_leveling_achievements.json
└── custom/                        # Your custom achievements
    ├── custom_achievements.json
    └── *.example templates

All achievements are fully customizable:

{
  "id": "dragon_slayer_fire",
  "category": "combat",
  "iconItem": "Weapon_Sword_Adamantite",
  "difficulty": "epic",
  "title": {"id": "dragonslayer", "color": "#FF0000"},
  "trigger": {"type": "kills", "target": "Dragon_Fire", "count": 1},
  "rewards": [{"type": "item", "itemId": "Ore_Adamantite", "amount": 10}]
}

Trigger Types

Trigger	Description
`kills`	Kill mobs/creatures
`player_kills`	PvP kills
`blocks_mined`	Mine stone/ore blocks
`blocks_chopped`	Chop wood blocks
`blocks_dug`	Dig dirt/sand/gravel blocks
`blocks_broken`	Combined total of mined + chopped + dug
`blocks_placed`	Place blocks
`blocks_harvested`	Harvest crops/harvestable blocks
`flowers_picked`	Pick flower blocks
`items_crafted`	Craft items
`zones_discovered`	Discover zones
`chat_messages`	Send chat messages
`playtime_minutes`	Time played
`distance_walked`	Distance traveled
`full_armor_set`	Wear complete armor set
`equip_item`	Equip a specific item
`damage_dealt`	Total damage dealt
`damage_taken`	Total damage taken
`pvp_damage_dealt`	Damage dealt to players
`pve_damage_dealt`	Damage dealt to mobs
`skill_level`	MMO Skill Tree skill level
`total_skill_level`	Combined level of all MMO skills
`rpg_level`	RPG Leveling character level
`rpg_xp`	RPG Leveling total XP
`endless_level`	Endless Leveling character level
`endless_xp`	Endless Leveling cumulative XP
`endless_skill_level`	Endless Leveling skill attribute level
`endless_race`	Endless Leveling race selection
`endless_class`	Endless Leveling class selection
`leveling_level`	LevelingCore character level
`leveling_xp`	LevelingCore cumulative XP
`weekend_login`	Triggers on weekend (Saturday/Sunday) login
`items_consumed`	Consume food/potions
`items_dropped`	Drop items
`items_picked_up`	Pick up items
`deaths`	Player deaths
`jumps`	Player jumps
`sprinting_distance`	Sprinting distance
`swimming_distance`	Swimming distance
`fishing_catches`	Fishing catches
`emotes_used`	Use emotes
`manual`	Triggered via admin command or script
`auto_on_prerequisites`	Auto-unlock when prerequisites are met

Reward Types

Reward	Description
`item`	Grant specific items
`lootbag`	Random items from weighted pool
`command`	Execute server command
`mmo_xp`	Grant MMO skill XP
`endless_xp`	Grant Endless Leveling XP

Download

Requirements

Hytale Server (compatible version)
Java 17 or higher

Optional Dependencies

LuckPerms - For group prefix integration
MMO Skill Tree - For skill-based achievements
RPG Leveling - For character progression achievements
MHUD - For multiple HUD support

Version

Current Version: 2.6.0

See the Changelog for version history.

Support

Discord: KyuubiSoft Discord

Made with love by KyuubiSoft