TokensSMP

**

---

⚔️ MobTokens & Abilities Collect Tokens. Unlock Abilities. Dominate.

MobTokens introduces a comprehensive RPG-style progression system to your server. Players complete specific challenges—ranging from combat to exploration—to earn unique Token Items. These tokens grant powerful active abilities based on the mob they represent, complete with stunning visual effects and a sleek GUI.

---

🌟 Key Features

💎 Physical Token System Tokens aren't just virtual currencies; they are tangible items.

• Physical Items: Tokens drop as glowing items with Custom Model Data support.
• Secure Ownership: Tokens are bound to the earner using Persistent Data Containers (PDC).
• Item Safety: Tokens never despawn, cannot be picked up by hoppers, and do not merge.
• Flexible Claims: Right-click a physical token to add it to your collection.

📊 Deep Progression Tracking The plugin tracks every action to determine when a player earns a token.

• Kill Tracking: Tracks 14+ specific mob types (including variants like Husks and Drowned).
• Milestones: Progress bars and notifications at key milestones (e.g., 50, 100, 2000 kills).
• Advanced Criteria: Tracks Taming, Breeding, Creation (Golems), Item Collection, and Structure Exploration.
• Smart Structure Detection: Asynchronous checks for Nether Fortresses and Ocean Monuments to prevent lag.

🖥️ Interactive GUI A beautiful, user-friendly interface to manage abilities.

• Command: /tokens
• Layout: 6-row inventory with layered navigation and rarity tabs.
• Information: View progress bars for locked tokens, ability details, cooldowns, and active status.
• Polish: Sound effects, hover tooltips, and "shiny" glow effects for owned tokens.

---

⚡ The Ability System There are 20 Unique Abilities divided by rarity. Each offers specific buffs, particle effects, and mechanics.

Token	Ability Name	Description
Zombie	Undead Strength	Strength I, Night Vision, Regen I.
Skeleton	Archer's Focus	Strength II, Speed I, +50% Bow Damage.
Spider	Web Walker	Jump Boost III, Speed II, Wall Climbing.
Pig	Swift Hooves	Speed III, Saturation.
Creeper	Blast Shield	Explosion Immunity, Fire Res, Resistance III.
Blaze	Infernal Aura	Fire Immunity, Strength II, Fire Attacks.
Guardian	Ocean's Grace	Water Breathing, Dolphin's Grace, Night Vision.
Snow Golem	Frozen Heart	Speed I, Resistance II, Snowball Throwing.
Wither Skel	Dark Presence	Wither Immunity, Strength II, Wither Attacks.
Bat	Echolocation	Night Vision, Slow Falling, Speed II.
Wolf	Pack Leader	Haste II, Strength I, Summons 3 Wolf Companions.
Squid	Ink Cloud	Dolphin's Grace II, Blinds nearby enemies.
Enderman	Void Shift	Instant teleportation (15 blocks).
Bee	Buzz Rush	Speed III, Slow Falling, Saturation II.
Horse	Stallion Sprint	Speed IV, Jump Boost III.
Chicken	Feather Fall	Complete Fall Immunity, Slow Falling.
Ravager	Berserker Rage	Strength III, Resistance II, Charge Attack.
Warden	Sonic Shriek	Sonic Boom Attack, Entity Detection, Darkness Immunity.
Witch	Brew Master	Grants 3-5 random beneficial potions.
Ender Dragon	Dragon's Might	Creative Flight, Strength III, Dragon Breath Attack.

---

🎨 Visuals & Immersion We prioritize player experience with high-quality visual and audio feedback.

• Token Drops: Lightning strikes, rarity-colored fireworks, and spiral particles when a token is earned.
• Abilities: Custom particle trails (Snowflakes, Dragon Breath, Void particles) and sound effects on activation.
• New Players: Scrolling token animation and title reveal upon first join.
• Rarity Particles: Distinct effects for Common, Rare, Epic, and Legendary tokens.

---

🛠️ Administration & Data

Data Management

• Performance: Fully asynchronous data saving to prevent server lag.
• Storage: Per-player YAML files with auto-save and data caching.
• Safety: Built-in corruption handling and null checks.

Admin Tools

• Management: Give/Take tokens (virtual or physical) to online/offline players.
• Manipulation: Manually set progress values or clear cooldowns.
• Stats: View detailed server-wide statistics and debug info.
• Hot Reload: Update configuration without restarting.

---

📜 Commands

Player Commands

• /token balance - View token balance and progress.
• /token list - List all tokens and ownership status.
• /token stats - View detailed kill and collection statistics.
• /ability activate <token> - Activate a specific ability.
• /ability active - Show currently active abilities.
• /tokens - Opens the main GUI.

Admin Commands

• /tokensadmin give <player> <token> - Give a token directly.
• /tokensadmin giveitem <player> <token> - Give the physical item.
• /tokensadmin setprogress <player> <key> <value> - Modify player progress.
• /tokensadmin reload - Reload the plugin config.
• /tokensadmin check <player> - Inspect another player's data.**