MythicRPG

MythicRPG - Complete RPG System for Minecraft

What does this plugin do?

MythicRPG is a comprehensive server-side RPG plugin that transforms your Minecraft server into a full-featured role-playing game. It adds 50+ custom items with unique abilities, a pet companion system with leveling, custom bosses and mobs, quests, crafting recipes, and a complete progression system.

Why should you download this?

- Easy to Use: 50+ unique items including legendary weapons, epic armor, magical staffs, and mythic artifacts - Easy to Use: 15 types of pets with 6 rarity levels, leveling up to 100, and 9 unique abilities - Easy to Use: Enhanced mobs with 6 difficulty tiers, full equipment, and improved loot drops - Easy to Use: Supports 10 languages including English, Russian, Ukrainian, and more - Easy to Use: Professionally architected with thread-safe operations and optimized code - Easy to Use: Intuitive GUI menus and simple commands for all features

Critical Information

Server Requirements: - Minecraft 1.21.4+ - Paper, Purpur, or Pufferfish server - Java 21+

Installation: 1. Download the plugin JAR file 2. Place it in your server's `plugins/` folder 3. Restart your server 4. Configure settings in `plugins/RPGPlugin/config.yml`

Dependencies: - LuckPerms (optional, for advanced permissions)

---

Features Overview

Custom Items System

50+ Unique Items across 8 categories: - Weapons (swords, axes, bows, daggers) - Armor (helmets, chestplates, leggings, boots) - Tools (pickaxes, axes) - Accessories (rings, amulets, talismans) - Magic Items (staffs, spell books) - Artifacts (special items with unique powers) - Consumables (potions, elixirs) - Materials (crafting components)

6 Rarity Levels: - Common (White) - Uncommon (Green) - Rare (Blue) - Epic (Purple) - Legendary (Gold) - Mythic (Red)

Each item features: - Unique abilities and special effects - Custom enchantments up to level X - Beautiful lore with emoji and colors - Balanced stats for fair gameplay

Pet Companion System

15 Pet Types: - Wolves, Cats, Horses, Parrots, Foxes, Pandas, Polar Bears, Rabbits, Llamas, Ocelots, Pigs, Sheep, Cows, Chickens, Zombies

Pet Features: - Level progression from 1 to 100 - 6 rarity tiers with unique stats - 4 behavior modes: Passive, Defensive, Aggressive, Follow - 9 unique abilities: Regeneration, Speed, Strength, Fire Resistance, Water Breathing, Jump Boost, Resistance, Night Vision, Invisibility - Hunger system requiring feeding - Automatic sun protection for undead pets (golden helmet) - Experience gain from combat and activities

Custom Mobs and Bosses

6 Difficulty Tiers: - Common (25% spawn chance) - Elite (20% spawn chance) - Rare (15% spawn chance) - Epic (10% spawn chance) - Legendary (5% spawn chance) - Mythic (1% spawn chance)

Mob Features: - Full custom equipment with enchantments - Unique abilities per mob type - Enhanced loot drops (up to +80%) - Custom items in mob equipment - Balanced difficulty scaling

Quest System

- Diverse quest types - Progression tracking - Rewards upon completion - Character advancement

Crafting System

- Unique recipes for custom items - Crafting materials system - Recipe book given on first join - Intuitive crafting GUI

Enhanced Loot

Chest Loot Chances: - Runes: 25% - Custom Items: 15% - Custom Materials: 20% - Coins: 35% (10-40 gold)

Mob Drop Improvements: - Better rarity distribution - Custom item drops from equipped mobs - Balanced drop rates (1-2% for custom items)

Localization

10 Supported Languages: - English - Russian - Ukrainian - Belarusian - Kazakh - Uzbek - Kyrgyz - Tajik - Armenian - Azerbaijani

Language can be changed with `/language <lang>` command or auto-detected from client.

---

Commands

Player Commands

- `/stats` - Open character statistics menu - `/items` - Open custom items shop - `/pet` - Manage your pet companion - `/craft` - Open crafting menu - `/zadanie` - View available quests - `/runes` - Open runes shop - `/language <lang>` - Change interface language

Admin Commands

- `/rpgadmin give <player> <item>` - Give custom item to player - `/rpgadmin reload` - Reload plugin configuration - `/rpgadmin stats <player>` - View player statistics

---

Example Items

Legendary Weapons

Destroyer's Hammer - Damage: +28 - Ability: Earthquake - Right-click to knock back all nearby enemies and deal 12 area damage - Cooldown: 30 seconds - Enchantments: Sharpness X, Knockback IV

Sniper Bow - Damage: +25 - Ability: Precise Shot - 100% accuracy, ignores armor, auto-aim, infinite arrows - Enchantments: Power VIII, Punch III, Infinity I, Unbreaking VI

Assassin's Dagger - Damage: +14 - Attack Speed: +40% - Ability: Stealth - 80% critical hit chance, 3.5x critical damage, invisibility for 3 seconds after critical hit - Enchantments: Sharpness IX

Epic Armor

Dragon Helm - Defense: +6 - Health: +6 hearts - Abilities: Fire Resistance, +15% defense, Night Vision - Enchantments: Protection VI, Fire Protection V, Unbreaking V

Titan's Chestplate - Defense: +12 - Health: +10 hearts - Abilities: +25% defense, Knockback Resistance - Enchantments: Protection VII, Unbreaking VI

Shadow Boots - Defense: +6 - Abilities: Invisibility while sneaking, +50% speed, Silent footsteps - Enchantments: Protection VI, Feather Falling V, Unbreaking VI

Mythic Artifacts

Dragon Wings - Defense: +8 - Abilities: Infinite flight, +100% flight speed, Fire breath attack, Fire immunity - Enchantments: Unbreaking X, Protection V

Mage's Amulet - Abilities: +50% magic damage, -30% mana cost, +100 max mana, 2x mana regeneration - Enchantments: Unbreaking I

---

Technical Details

Performance

- Async Saving: 50+ items initialize in ~50-100ms - Async Saving: All operations are thread-safe using ConcurrentHashMap - Async Saving: Fast data access with minimal overhead - Async Saving: Player data saves asynchronously to prevent lag

Architecture

- Full Documentation: Follows SOLID principles - Full Documentation: Singleton, Builder, Factory, Registry patterns - Full Documentation: 57 Java classes, easily extensible - Full Documentation: 13,000+ words of documentation included

Security

- Error Handling: Protection against invalid input - Error Handling: Uses Optional to prevent NullPointerException - Error Handling: Protection against item duplication - Error Handling: Graceful degradation on errors

---

Configuration

The plugin is fully configurable through `config.yml`:

- Boss spawn intervals - Item drop chances - Item statistics - Pet settings - Language settings - And much more

All settings have sensible defaults and are well-documented.

---

Statistics

- 50+ custom items - 15 pet types - 6 rarity levels - 10 supported languages - 25+ unique abilities - 100% thread-safe code - 57 Java classes - 274 KB file size

---

Planned Features

- Guild system with wars - PvP arenas with rankings - Dungeons with unique rewards - Class system (Warrior, Mage, Archer, etc.) - Custom enchantments - Extended economy and shops - Custom worlds and biomes

---

Support

- Updates: Report bugs on GitHub Issues - Updates: Join our community server - Updates: Full documentation available - Updates: Regular updates and improvements

---

License

MIT License - Free to use and modify

---

Why Choose MythicRPG?

✅ Professional development following best practices ✅ High performance with optimized code ✅ Full multilingual support (10 languages) ✅ Rich content (50+ items, 15 pets, custom mobs) ✅ Active support and regular updates ✅ Production-ready and stable ✅ Easy to install and configure ✅ Extensive documentation included

---

Transform your Minecraft server into an epic RPG adventure with MythicRPG!

*Made with ❤️ for the Minecraft community*