CustomStats

# CustomStats - ARPG Affixes & Active Skills! Tired of the vanilla Minecraft gear progression? **CustomStats** completely revitalizes your server's combat and itemization by introducing a deep, ARPG-inspired affix system for all crafted weapons and armor. Inspired by games like *Path of Exile*, this plugin makes every crafted item a unique and potentially game-changing discovery. Forge gear with simple stat boosts or discover powerful items with spectacular abilities that trigger in the heat of battle. Every sword, helmet, and chestplate has the potential to become a legendary artifact! ## ✨ Key Features * **Dynamic Affix System:** Items can be generated with a mix of randomized passive stats. * **Powerful Active Skills:** A chance to roll a game-changing active affix that can trigger spectacular effects in combat. * **Randomized on Craft:** Every time a player crafts a valid item, it has a chance to be imbued with unique affixes. No two items are exactly alike! * **Scroll of Affix:** Allows players to add a random affix to an existing item that doesn't have any, giving unenchanted gear a new purpose. * **Deeply Customizable:** Control everything from affix value ranges, roll chances, item blacklists/whitelists, and more via a detailed `config.yml`. * **Multi-Language Support:** All player-facing messages can be translated. Comes with English and Ukrainian locales out of the box. * **Lightweight & Performant:** Designed to be efficient and not bog down your server. --- ## ⚔️ How It Works The system is designed to be intuitive and seamlessly integrate into the survival experience. 1. **Craft an Item:** When a player crafts a weapon (sword) or a piece of armor, the plugin automatically rolls for affixes. The resulting item can have anything from one simple stat to a combination of passive boosts and a powerful active skill. 2. **Use a Scroll of Affix:** Did you find a great piece of gear with no stats? Use a **Scroll of Affix** on it! This consumable item will add one new, random affix to the item, giving it a new lease on life. ## 🎲 Passive vs. Active Affixes CustomStats features two distinct types of affixes to create diverse and exciting item combinations. ### Passive Affixes (The Stats) These are your classic, always-on stat boosts. They form the foundation of your gear's power. * `⚡ +Lightning Damage` * `🔥 +Fire Damage` * `🩸 +Life Steal` * `🎯 +Critical Strike Chance` * `💀 +Poison Resist` * ...and many more! ### Active Affixes (The Game-Changers) These are rare and powerful effects that have a chance to trigger under specific conditions (dealing or taking damage). An item can only have one active affix, making them truly special. * 🌋 **Earth Shock:** Chance on hit to unleash a seismic wave, dealing bonus damage and knocking back nearby enemies. * 🗡️ **Shadow Step:** Chance on hit to teleport behind your target and deal significant bonus damage. * 🧊 **Ice Cocoon:** Chance when hit to encase yourself in a protective ice shell, healing you and making you temporarily resilient. * ✝️ **Divine Shield:** A chance, when taking lethal damage, to become immune for a few seconds, saving you from certain death. * ...and other exciting skills to discover! --- ## ⚙️ Configuration Tailor every aspect of the plugin to fit your server's balance and economy through the extensively commented `config.yml`. * Set `min/max` values for every single affix. * Define the chance for an item to roll an active affix. * Add custom items from other plugins to the affix system using `overrides`. * Blacklist specific vanilla or custom items to prevent them from getting affixes. **Example from `config.yml`:** ```yaml active-affixes: weapon: shadow_step: chance-min: 3.0 chance-max: 10.0 bonus-damage-min: 4.0 bonus-damage-max: 9.0 behind-distance: 1.6 target-slow-duration: 60 target-weakness-duration: 40 ``` --- ## 📝 Commands & Permissions **Commands:** * `/customstats reload` (Alias: `/cs reload`) - Reloads the configuration and language files. * `/customstats getscroll ` (Alias: `/cs getscroll`) - Gives the player an Affix Scroll. **Permissions:** * `customstats.admin` - Required for all `/customstats` commands. * `customstats.use_affix_scroll` - Allows players to use the Scroll of Affix. (Default: `true`) --- ### 🔮 Future Plans * More unique active affixes for both weapons and armor. * More scrolls for more controlled affix manipulation. * Support for more item types like bows and crossbows. I hope you enjoy the new depth and excitement **CustomStats** brings to your server! If you have any feedback or bug reports, please let me know.