Coreshun Achievement & Badge System v1.0

Achievement & Badge System
Reward players for everything they do — and make it stick.

Overview
A drop-in achievement system with real Roblox badge awarding built in. Define any achievements you like, track progress automatically or from your own events, and on unlock players get a polished popup, optional rewards, optional real badges, and achievement points that double as a ready-made leaderboard stat.

Achievements, Your Way

• Fully configurable — set each one's name, description, icon, points, and target. Single-step ("join the game") or progress-based ("collect 1,000 coins").
• Hidden achievements — secret entries show as "???" until the player earns them.
• Auto-tracking — point an achievement at a leaderstat, attribute, or Coreshun Currency value and it unlocks itself at the target. Event-driven, so it fires the instant the value is reached.
• Or drive it yourself — a clean _G API (Increment / Set / Unlock) ties achievements to any game event in one line.

Real Roblox Badges
Paste a Badge ID into any achievement and it awards the actual Roblox badge on unlock — idempotent and fully protected, so a bad ID never errors your game. Custom in-game achievements and real platform badges, from one place.

Recognition & Rewards

• Unlock popup — a built-in, animated "Achievement Unlocked" banner that works on its own, no dependencies.
• Achievement points — every unlock adds points, stamped as a Player attribute for your UI, nametags, or a leaderboard to read.
• Reward hooks — the OnUnlock hook grants currency, items, or perks without touching the core.

Built Right

• Achievements panel — a clean, scrollable list with progress bars, points, and a completion header that refreshes live as players progress.
• Hardened DataStore — per-player unlocks + progress persist safely, with graceful fallback and additive, rejoin-safe writes.
• 6 themes, scale-only UI (phone to 4K), and a configurable HUD button.

Pairs With
Coreshun Leaderboard (rank players by achievement points — the attribute is ready to read), Toast (opt-in unlock notifications), and Currency / Inventory (grant rewards from the OnUnlock hook).

Setup (about 2 minutes)

1. Insert the model and run the one-line installer.
2. Edit the achievements list in the config (or use the four included examples).
3. Press Play. That is it.

Included
Fully readable Luau (no obfuscation), a README, manual and cheat sheet PDFs, and a Rojo project. Built with Rojo. Unlimited personal and commercial use.

Part of the Coreshun stack — drops in clean alongside Leaderboard, Currency, Inventory, Shop, Quest, Toast, and more.