Tracker HUD
The Achievement Tracker HUD is a persistent on-screen display that lets you monitor progress on up to 3 achievements at a time. It shows achievement names, progress bars, and difficulty indicators so you always know how close you are to your next unlock.
Overview
- Track up to 3 achievements simultaneously
- Live progress updates as you play (kills, blocks mined, playtime, etc.)
- Color-coded difficulty indicators (Brown = Normal, Gold = Hard, Purple = Epic)
- Progress numbers with context-aware units (e.g., "5/10 Min", "3/5 Kills")
- Auto-hides when the world map is open
- Completed achievements are automatically removed from tracking
- Fully customizable position and visibility settings per player
Tracking and Untracking Achievements
From the Achievement Gallery
- Open the Achievement Gallery with
/ksachievements(or/ac) - Find the achievement you want to track
- Click the Track button next to the achievement entry
- The achievement now appears on your HUD
To stop tracking, click the Untrack button on a tracked achievement.
You can track a maximum of 3 achievements at once. If you try to add a fourth, you will see a message in chat. Untrack one first to make room.
Automatic Tracking Behavior
The tracker has two smart automation features:
- Auto-remove on completion: When you unlock a tracked achievement, it is automatically removed from the tracker.
- Auto-track next in chain: If you complete an achievement that is part of a chain (e.g.,
miner_1->miner_2->miner_3), the next achievement in the chain is automatically tracked for you.
Position Presets
Each player can choose where the tracker HUD appears on their screen. The following presets are available:
| Preset | Position |
|---|---|
top_left | Top-left corner |
top_right | Top-right corner |
middle_left | Center-left |
middle_right | Center-right |
bottom_left | Bottom-left corner (default) |
bottom_right | Bottom-right corner |
custom | Manual X/Y coordinates |
Changing Position
- Open the Achievement Gallery (
/ksachievements) - Click the Settings button (gear icon)
- Select a position preset from the dropdown, or choose Custom and adjust the X/Y sliders
- The live preview shows where the HUD will appear
- Click Apply to save
The settings page shows a real-time preview of the HUD position on your screen. Adjust the sliders and see the preview move before you commit.
HUD Settings
All settings are per-player and persist between sessions.
| Setting | Description | Default |
|---|---|---|
| HUD Enabled | Show or hide the tracker entirely | Enabled |
| Show Progress | Display progress numbers and percentages | Enabled |
| Position Preset | Where the HUD appears on screen | bottom_left |
| X Position | Horizontal position (0-1920) for custom placement | 16 |
| Y Position | Vertical position (0-1080) for custom placement | 700 |
Resetting to Defaults
In the settings page, click Reset to restore all settings to their default values, then click Apply.
Auto-Hide Behavior
The tracker HUD automatically hides in the following situations:
- World map is open -- the HUD reappears when you close the map
- HUD disabled -- if you turn off the HUD via settings
- No tracked achievements -- an empty state message is shown instead
- Player has no data loaded -- during initial login before data loads
MHUD Integration
If the MHUD (Multiple HUD) plugin is installed on the server, the tracker HUD is registered through MHUD. This prevents conflicts with other plugins that use the HUD system.
With MHUD installed:
- The Achievement Tracker runs alongside other custom HUDs without interference
- Each HUD gets its own identifier (
KyuubiSoft_AchievementTracker)
Without MHUD:
- The tracker uses the standard single-HUD system
- If another plugin already has a HUD active, the tracker will not replace it
- A warning is logged to the server console
Without MHUD, only one custom HUD can be active at a time. If you use multiple HUD plugins, install MHUD to avoid conflicts.
Progress Display
When Show Progress is enabled, each tracked achievement shows:
- Achievement name (localized)
- Progress counter with unit, e.g.,
450/1000 Blk - Percentage, e.g.,
45% - Difficulty color bar on the side
Progress Units
| Trigger Type | Unit |
|---|---|
| Playtime | Min |
| Distance walked | Blk |
| Blocks (mined, placed, etc.) | Blk |
| Kills / Player kills | Kills |
| Damage dealt / taken | Dmg |
| Items crafted | Items |
| Chat messages | Msg |
| Zones discovered | Zones |
| Other | (none) |
Troubleshooting
HUD Not Showing
- Check if the HUD is enabled: open settings via
/ksachievementsand verify HUD Enabled is checked - Make sure you have at least one achievement tracked
- If using another HUD plugin, install MHUD for compatibility
- Check the server log for
"Cannot show Achievement Tracker HUD"warnings
HUD Position Seems Wrong
- Open settings and try a different preset
- Use Reset to go back to defaults
- Note that position is based on 1920x1080 resolution; other resolutions may shift the display slightly
Progress Not Updating
- Verify the achievement is actually being tracked (check the gallery)
- Some triggers update on intervals rather than instantly (e.g., playtime)
- Achievements completed in Creative mode are not tracked by default (configurable)