MobDex

If you like this plugin, please leave a like; it's important to me.

MobDex - Discover the World, One Mob at a Time
Transform your survival experience into an exciting journey of discovery!

Ever wondered what secrets lurk in the shadows of your Minecraft world? MobDex turns every exploration into an adventure, rewarding players for discovering rare and legendary creatures across your server!

✨ What is MobDex?
MobDex is a revolutionary mob discovery system that adds a whole new dimension to your Minecraft experience. Instead of just killing mobs, players now collect discoveries like a true explorer, building their personal encyclopedia of rare creatures!

The Concept:

• Random mobs spawn with special rarities (Rare, Unique, Legendary, Mythical)
• Get close to discover them (no killing required!)
• Each discovery is permanently saved to your personal MobDex
• Compete on the server-wide leaderboard
• Unlock exclusive rewards for first-time discoveries

Core Features
Proximity-Based Discovery System
No more senseless grinding! Simply get within 10 blocks of a rare mob to discover it.

• Epic discovery message with particle effects
• Satisfying sound notification
• Instant rewards for your first discovery
• Automatic tracking in your MobDex

Four Default Rarity Tiers
Rarity Spawn Rate Stats Boost Rewards
Rare 5% ×1.5 HP, ×1.2 DMG 1 Diamond
Unique 2% ×2 HP, ×1.5 DMG 3 Diamonds + Emerald
Legendary 0.5% ×3 HP, ×2 DMG 10 Diamonds + Netherite
Mythical ✨ 0.1% ×5 HP, ×3 DMG Server-wide broadcast!
Every rarity is 100% customizable! Change spawn rates, multipliers, colors, particles, and rewards to match your server's economy.

Beautiful Encyclopedia GUI
Open your MobDex with /mobdex to explore your discoveries:

️ Browse by Mob

• Browse through all mob types with custom player heads
• See which rarities you've discovered for each mob
• Track your progress with visual indicators (✓/✗)

Browse by Rarity

• View all mobs of a specific rarity tier
• See discovered vs undiscovered in one glance
• Beautiful color-coded interface

Detailed Statistics

• Total unique discoveries
• Per-rarity completion percentage
• Kill count for each mob type
• Overall completion tracker

Live Leaderboard

• Top 10 discoverers displayed in-GUI
• Real-time ranking updates
• Competitive progression system

⚡ Dynamic Rare Mob Spawning
Rare mobs are visually stunning:

• Custom display names with rarity colors
• ✨ Persistent particle effects (customizable per rarity)
• Special sheep colors for easy identification
• Buffed stats - more health, more damage, more XP
• Automatic detection - works with natural spawns AND chunk loading!

Flexible Reward System
Reward your players for their discoveries:

• Execute any command on discovery
• Use placeholders for dynamic rewards: {player}, {rarity}, {mob}
• Toggle first-discovery-only rewards
• Perfect for economy plugins, custom items, permissions, and more!

Eye-Catching Visuals
Particle Effects
Each rarity tier features unique particle effects:

• Customizable particle types
• Adjustable colors (RGB support)
• Configurable view distance
• Persistent animations

Clean GUI Design

• ️ Stylish borders with glass panes
• Custom mob heads for all 95+ mob types
• Color-coded rarities for instant recognition
• ⬅️ Intuitive navigation with back buttons
• Paginated lists for easy browsing

️ Admin Tools
Powerful commands for server management:

/mobdexadmin spawn <mob> <rarity> - Spawn a rare mob for testing
/mobdexadmin discover <player> <mob> <rarity> - Grant discoveries
/mobdexadmin killall <mob|all> - Remove rare mobs
/mobdexadmin wipedata <player|all> - Reset data (auto-backup)
/mobdexadmin reload - Hot-reload configuration
Auto-backup system ensures no data loss when wiping!

⚙️ Highly Configurable
Spawn Control

• ✅ Whitelist/blacklist specific worlds
• ✅ Control spawn reasons (natural, spawner, etc.)
• ✅ Disable specific mob types
• ✅ Adjust spawn chances per mob type
• ✅ Chunk loading multiplier for existing mobs
• ✅ Nether roof toggle

Customization Options
yaml
# Fully customize each rarity
rarities:
Legendary:
spawn-chance: 0.5
health-multiplier: 3.0
damage-multiplier: 2.0
exp-multiplier: 5.0
color: "&6"
particle: "VILLAGER_HAPPY"
particle-color: "255,215,0"
sheep-color: "ORANGE"
rewards:
- "give {player} diamond 10"
Discovery Settings

• Discovery distance (default: 10 blocks)
• Sound on/off toggle
• Custom messages with placeholders
• Particle effect density

Performance Optimized
MobDex is built with performance in mind:

• ⚡ Async chunk processing - no lag on chunk load
• Smart proximity checks - only checks once per second
• Efficient YAML storage - minimal file size
• Automatic cleanup - removes dead mob trackers
• Lightweight - ~5MB per 1000 discoveries

Plugin Compatibility
MobDex plays nice with others:

• ✅ MythicMobs - Automatically skips MythicMobs entities
• ✅ EliteMobs - Automatically skips EliteMobs entities
• ✅ Economy plugins - Vault support via reward commands
• ✅ Permission plugins - Full permission system
• ✅ Multiworld plugins - World blacklist support

Default Configuration Highlights
yaml
rarities:
Rare:
spawn-chance: 5.0 # 5% of all mob spawns
health-multiplier: 1.5 # 50% more HP
damage-multiplier: 1.2 # 20% more damage
exp-multiplier: 2.0 # Double XP drops
color: "&9" # Blue name
particle: "VILLAGER_HAPPY"
particle-color: "0,150,255"

discovery-distance: 10 # Blocks needed to discover
discovery-sound-enabled: true
particle-view-distance: 32 # How far players see particles

disabled-worlds: # Skip certain worlds
- "world_the_end"

disabled-entities: # Skip certain mobs
- "ENDER_DRAGON"
- "WITHER"

What Makes MobDex Special?
✨ Unique Gameplay Loop

• Not just another "kill X mobs" plugin
• Rewards exploration and curiosity
• Creates memorable moments of discovery

Commands & Permissions
Player Commands
Command Permission Description
/mobdex [player] mobdex.encyclopedia Open your MobDex
Admin Commands
Command Permission Description
/mobdexadmin spawn <mob> <rarity> mobdex.admin Spawn a rare mob
/mobdexadmin discover <player> <mob> <rarity> mobdex.admin Grant discoveries
/mobdexadmin leaderboard [page] mobdex.admin View leaderboard
/mobdexadmin killall <mob|all> mobdex.admin Remove rare mobs
/mobdexadmin wipedata <player|all> mobdex.admin Wipe player data
/mobdexadmin reload mobdex.admin Reload config
Aliases:

• /mobdex → /encyclopedia, /dex
• /mobdexadmin → /mdadmin, /mda

⭐ Why Choose MobDex?
✅ Unique concept - Nothing else like it ✅ Active development - Regular updates ✅ Performance focused - Won't lag your server
✅ Highly customizable - Make it yours ✅ Beautiful interface - Players will love it ✅ Professional quality - Production-ready ✅ Great support - We're here to help

Ready to Transform Your Server?
Download MobDex today and give your players a reason to explore every corner of your world!

⭐ If you enjoy MobDex, please leave a review! It helps a ton! ⭐

License
This plugin is provided as-is. You may use it on your server(s) but may not redistribute or claim as your own.

Made with ❤️ for the Minecraft community

Transform exploration. Reward discovery. Build legends.

Download MobDex Now!