Achievement & Title System

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

• /achievementadmin grant <player> <achievement> - Grant achievements
• /achievementadmin revoke <player> <achievement> - Revoke achievements
• /achievementadmin list <player> - View player achievements
• /achievementadmin simulate <trigger> - Test trigger conditions

---

Commands

Command	Description
/achievements /ac	Open the Achievement Gallery UI
/titles	Open the Title Selection UI
/title clear	Remove your active title
/rewards	View and collect pending rewards

---

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 blocks
blocks_placed	Place 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
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
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
damage_dealt	Total damage dealt
damage_taken	Total damage taken
jumps	Player jumps
sprinting_distance	Sprinting distance
swimming_distance	Swimming distance
fishing_catches	Fishing catches
endless_xp	Endless Leveling cumulative XP
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