Weapon Enhancer

🔧 Requirements & Dependencies

This plugin requires the following dependencies to function properly:

1. Hybrid API (Serilum:Hybrid)

Version: Latest compatible version

Download: Available on CurseForge

Installation: Place the Hybrid JAR file in your server's plugins/ directory

Note: Hybrid must be installed and running before this plugin can function

2. HyUI Library (v0.5.1 or compatible)

Version: 0.5.1 or higher

Download: Available on CurseForge

Purpose: Provides advanced UI capabilities for the weapon salvage interface

Installation: Included in the plugin JAR (no separate installation needed)

Note: This is bundled with the plugin, so you don't need to download it separately

Troubleshooting

If you encounter issues:

"Plugin failed to load": Make sure Hybrid API is installed and loaded first

"Class not found": Verify that Hybrid API is the correct version and properly installed

"UI not working": Ensure you're using a compatible version of Hytale server

Weapon Enhancer Plugin

Last Update: 2026-01-27 Plugin Version: 0.2.88 Weapon Enhancer adds an advanced enhancement system for weapons and armor in Hytale. Every weapon and armor you obtain automatically receives unique random properties!

🚀 Main Features

✓ Automatic Enhancement: All weapons and armor receive affixes automatically

✓ 5 Rarity Tiers: COMMON, MAGIC, RARE, EPIC, LEGENDARY

✓ 20 Total Affixes: 12 for weapons + 8 for armor

✓ Super Affixes: Special effects with activation probability

✓ Difficulty System: 4 difficulty levels with scalable rewards

✓ Material System: Materials influence affix power

✓ Graphical Interfaces: Modern UI to manage your weapons and armor

✓ Fully Configurable: Every aspect can be customized

⚔️ Rarity System

Rarity Color Affixes Value Cap

COMMON ⚪ White 1 30%

MAGIC 🔵 Blue 2 50%

RARE 🟡 Yellow 3 70%

EPIC 🟣 Purple 4 85%

LEGENDARY 🔴 Red 5 100%

How it works: When you obtain a weapon/armor, a random rarity is assigned. Higher rarities have more affixes and higher value caps.

✨ Weapon Affixes (12 total)

Offensive

POWER - Increases damage (10% - 100%) CRITICAL_STRIKE - Increases critical chance (10% - 50%) CRITICAL_DAMAGE - Increases critical damage (30% - 100%)

Utility

ENERGY_CHARGE - Generates energy per hit (15% - 60%) LIFESTEAL - Restores HP based on damage dealt (25% - 100%) DURABILITY - Increases weapon durability (20% - 80%)

Special

RESONANT - Increases damage against specific enemies (20% - 50%) PREDATOR - Increases damage against creatures (15% - 40%) DOMINANT - Increases damage against players (5% - 15%)

🛡️ Armor Affixes (8 total)

HP_REGEN - Regenerates HP per second (1% - 3%) MP_COST_REDUCTION - Reduces mana cost (5% - 25%) ENERGY_COST_REDUCTION - Reduces energy cost (5% - 15%) MOVEMENT_SPEED - Increases movement speed (5% - 15%) FIRE_DAMAGE_REDUCTION - Reduces fire damage (5% - 100%) POISON_DAMAGE_REDUCTION - Reduces poison damage (5% - 100%) GENERAL_DEFENSE - Reduces all physical and magical damage (4% - 7%) THORNS - Reflects damage back to attackers (4% - 7%)

Important: Armor affixes stack when wearing multiple pieces (e.g., 4 pieces with HP_REGEN = 4x the value).

🌟 Super Affixes

Special effects that activate during combat with a certain probability:

Super Affix Effect Activation Chance Duration

BLEED Deals continuous damage 20% 15 seconds

POISON_DAMAGE Deals poison damage 20% 8 seconds

ICE_DAMAGE Freezes the enemy 20% 5 seconds

How it works: When you hit an enemy, a random roll determines if the effect activates. The probability is configurable (default: 30% of weapons have a Super Affix). 🎮 Difficulty System

Choose your challenge level with 4 difficulty tiers:

Difficulty Enemy Defense Enemy Damage Material Bonus Drop Rate

Normal 1.0x 1.0x 1.0x 1.0x

Hard 1.67x 2.8x 1.5x 1.5x

Expert 2.4x 4.5x 2.5x 2.5x

Master 3.0x 6.5x 4.0x 4.0x

How to use: Type /difficulty or /diff to open the difficulty selection menu. Higher difficulties give better rewards (more materials, higher drop rates, better rarity chances) but enemies are tougher. Chest Loot: Chests generate better loot based on your difficulty level. Higher difficulty = better chance for rare items.

🔧 Commands

⚔️ Weapon Commands

/wenhancer or /weaponenhancer - Regenerates all properties of equipped weapon (cost: 20 Copper Ingots)

/wrecycle - View and recycle your weapons (recovers 50% of materials)

/wupgrade - Improve weapon rarity (costs essences, 5 upgrade options)

/waffix - Change weapon affixes (costs essences)

🛡️ Armor Commands

/aenhancer or /armorenhancer - Regenerates all properties of equipped armor (cost: 5 Copper Ingots)

/arecycle - View and recycle your armor

/aupgrade - Improve armor rarity (costs essences)

/aaffix - Change armor affixes (costs essences)

🎮 Difficulty Command

/difficulty or /diff - Open difficulty selection menu

⚙️ Material System

Materials influence how powerful affixes can be:

Material Tier Multiplier Examples

Base 30% Crude, Wood, Bone

Low 50% Copper

Medium 65-80% Bronze, Iron

High 90-95% Steel, Silver, Gold

End-Game 100% Mithril, Adamantite, Cobalt, Thorium, Onyxium, Doomed

Example: A RARE Iron weapon with 50% POWER will effectively have 50% × 0.8 = 40% power. Better materials = more powerful affixes!

💡 Tips for Players

Start Simple: Create weapons with base materials to understand the system

Use /wrecycle: View all your weapons to find the best ones

Progressive Upgrades: Start with low probability upgrades to save essences

Stack Armor: Wear 4 pieces with the same affix to maximize effect

Super Affixes: Look for weapons with Super Affixes for easier combat

Recycle Old Items: Recycle old weapons/armor to recover materials

Difficulty Rewards: Higher difficulty = better rewards, but more challenge

Material Matters: A COMMON Mithril weapon can be better than a RARE Copper weapon

⚠️ Important Notes

Affixes automatically apply to all weapons/armor when obtained

Super Affixes have activation probability (they don't always activate)

Materials influence affix power (better materials = better affixes)

Higher rarities have more affixes and higher values

Armor affixes stack when wearing multiple pieces

Everything is configurable via JSON files in plugins/weapon-enhancer/

🔧 Requirements

Hybrid API (Serilum:Hybrid) - Required dependency

HyUI Library (v0.5.1+) - Bundled with plugin

Note: This plugin is designed for Hytale Early Access. Features may change as the game develops.