# ⚔️ WarriorClasses (Open Beta) **A lightweight, high-performance RPG class plugin for Paper & Purpur 1.21.1+** [📚 Official Wiki](https://servercastlehill.com/wiki.html) • [💬 Discord Community](https://discord.gg/f6AgyKms3J)

--- WarriorClasses is a lightweight, high-performance RPG class plugin designed for Paper and Purpur (1.21.1+). Built specifically for survival and RPG servers that need deep player progression, balanced combat mechanics, and strict anti-farm limits. This plugin was created because I needed a classic warrior-class RPG solution on my own server—one that would offer real content to develop and differentiate those classes, with distinct, progressive effects and abilities that give players a genuine RPG server experience. It can be complemented with other plugins designed to provide that kind of experience, such as race plugins, dungeons, and custom mob plugins. While the general reason I created this plugin is progression, the specific reason to use this one rather than an existing alternative is efficiency and resource usage. Other similar solutions radically alter the game and consume heavy server resources; a heavy, radical solution isn’t for everyone, especially if you want a smooth learning curve and adaptation process for new players. > **🧪 Open Beta Notice:** This plugin is currently in Open Beta! All features, skills, and mechanics are fully functional. Feel free to test it, use it on your server, and report any feedback or bugs in our Discord community! --- ## 🌐 Out-of-the-Box Multilingual Support WarriorClasses ships pre-packaged with 7 ready-to-use language translations right out of the box. You do not need to translate configuration files manually; just copy your language file from the resources folder and replace your main `messages.yml` with it: - 🇬🇧 **English** (`messages.yml`) - 🇪🇸 **Spanish / Español** (`messages_es.yml`) - 🇧🇷 **Portuguese / Português (Brasil)** (`messages_pt.yml`) - 🇩🇪 **German / Deutsch** (`messages_de.yml`) - 🇫🇷 **French / Français** (`messages_fr.yml`) - 🇷🇺 **Russian / Русский** (`messages_ru.yml`) - 🇨🇳 **Simplified Chinese / 简体中文** (`messages_zh.yml`) --- ## ✨ Key Features ### 🛡️ 5 Distinct RPG Classes - **Bastion:** Heavy shield defender with taunts, disarms, area mitigation, and retaliation strikes. - **Barbarian:** Two-handed axe specialist inflicting bleeding, cleaving hordes, and bursting HP. - **Assassin:** Shadow-stepping mobile killer with stealth, backstabs, and executioner strikes. - **Sorcerer:** Ranged magical DPS dealing pure damage (bypassing physical shields) with crowd control. - **Cleric:** Group anchor providing health restoration, regen, debuff purges, and critical ally intervention. ### 📈 Balanced Progression System - **3 Evolution Tiers:** Advance from Tier 1 up to Tier 3 Master rank using `/class evolve`. - **10 Internal Sub-Grades per Tier:** Dynamic sub-ranks that showcase player progress in chat and scoreboards. - **Weapon Expertise:** Scales physical damage (80% to 160%) and reduces skill cooldowns by up to 20%. ### 🧠 Smart Anti-Farm Threat Engine - **Vanilla & Mob Plugin Compatible:** Seamlessly evaluates threat points from both vanilla mobs and external mob plugins by efficiently reading mob levels and combat scaling without heavy server performance costs. - **First Blood Bonus:** Daily 4x multiplier for casual players to progress smoothly. - **Strict Daily Cap:** Configurable daily limit to prevent economy exploitation. - **Burst Fatigue Protection:** Reduces threat points by 50% for rapid consecutive mob kills (anti-mob farm protection). ### ⚙️ Intuitive Hotbar & Inventory Tools - **Skill Selector Compass:** Hotbar-friendly item to cycle and cast prepared skills seamlessly during fast-paced PvP/PvE. - **Reassignment Crystals:** Consumable item system allowing players to reset or switch their class without losing master status. --- ## 🛠️ Commands & Permissions ### Player Commands - `/class` — Opens the visual Class Selection GUI. - `/class status` (or `/class progreso`) — View current Tier, Grade, Threat Points, and evolution requirements. - `/class evolve` — Ascend your character to the next Tier when requirements are met. - `/fl` or `/skill` — Opens the Skill Loadout GUI & Compendium. - `/class reset` — Reset your current class (Requires holding a Reassignment Crystal). ### Admin Commands (`warriorclasses.admin`) - `/warrior settier <1-3>` — Force set a player's Tier. - `/warrior addkills ` — Grant Threat/Kill points to a player. - `/warrior adddungeons ` — Grant completed dungeon credits. - `/warrior givetrophy ` — Grant a Boss Trophy to a player. - `/warrior givecrystal [amount]` — Give Reassignment Crystals. - `/warrior reload` — Reload configuration and message files instantly. --- ## 🔌 Dependencies & Integrations - **Core Requirement:** Paper / Purpur 1.21.1+ (Java 21). - **Mob Plugins (Recommended):** Fully compatible with Vanilla mobs and external custom mob plugins. The Threat Engine automatically evaluates mob levels and difficulty to calculate progression points efficiently. - **PlaceholderAPI (Optional):** Full placeholder support for Scoreboards, Tablists, and Chat tags (`%warriorclasses_prefix%`, rank, tier, grade). ---

### 💬 Feedback & Support Since this is an Open Beta, your feedback is extremely valuable! If you encounter any bugs, balance issues, or have feature suggestions: [**Join our Discord Community**](https://discord.gg/f6AgyKms3J) • [**Read the Official Wiki**](https://servercastlehill.com/wiki.html)

warrior_classes

1.0.3