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. * Flexible Claims: Tokens drop as glowing items with Custom Model Data support. * Flexible Claims: Tokens are bound to the earner using Persistent Data Containers (PDC). * Flexible Claims: 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. * Smart Structure Detection: Tracks 14+ specific mob types (including variants like Husks and Drowned). * Smart Structure Detection: Progress bars and notifications at key milestones (e.g., 50, 100, 2000 kills). * Smart Structure Detection: 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. * Polish: `/tokens` * Polish: 6-row inventory with layered navigation and rarity tabs. * Polish: 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 | | :--- | :--- | :--- | | Creative Flight | Undead Strength | Strength I, Night Vision, Regen I. | | Creative Flight | Archer's Focus | Strength II, Speed I, +50% Bow Damage. | | Creative Flight | Web Walker | Jump Boost III, Speed II, Wall Climbing. | | Creative Flight | Swift Hooves | Speed III, Saturation. | | Creative Flight | Blast Shield | Explosion Immunity, Fire Res, Resistance III. | | Creative Flight | Infernal Aura | Fire Immunity, Strength II, Fire Attacks. | | Creative Flight | Ocean's Grace | Water Breathing, Dolphin's Grace, Night Vision. | | Creative Flight| Frozen Heart | Speed I, Resistance II, Snowball Throwing. | | Creative Flight| Dark Presence | Wither Immunity, Strength II, Wither Attacks. | | Creative Flight | Echolocation | Night Vision, Slow Falling, Speed II. | | Creative Flight | Pack Leader | Haste II, Strength I, Summons 3 Wolf Companions. | | Creative Flight | Ink Cloud | Dolphin's Grace II, Blinds nearby enemies. | | Creative Flight | Void Shift | Instant teleportation (15 blocks). | | Creative Flight | Buzz Rush | Speed III, Slow Falling, Saturation II. | | Creative Flight | Stallion Sprint | Speed IV, Jump Boost III. | | Creative Flight | Feather Fall | Complete Fall Immunity, Slow Falling. | | Creative Flight | Berserker Rage | Strength III, Resistance II, Charge Attack. | | Creative Flight | Sonic Shriek | Sonic Boom Attack, Entity Detection, Darkness Immunity. | | Creative Flight | Brew Master | Grants 3-5 random beneficial potions. | | Creative Flight| Dragon's Might | Creative Flight, Strength III, Dragon Breath Attack. |

---

🎨 Visuals & Immersion We prioritize player experience with high-quality visual and audio feedback. * Rarity Particles: Lightning strikes, rarity-colored fireworks, and spiral particles when a token is earned. * Rarity Particles: Custom particle trails (Snowflakes, Dragon Breath, Void particles) and sound effects on activation. * Rarity Particles: Scrolling token animation and title reveal upon first join. * Rarity Particles: Distinct effects for Common, Rare, Epic, and Legendary tokens.

---

🛠️ Administration & Data

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

Admin Tools * Hot Reload: Give/Take tokens (virtual or physical) to online/offline players. * Hot Reload: Manually set progress values or clear cooldowns. * Hot Reload: 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.**