***
⚔️ 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.
