Weapon Enhancer Plugin
Last Update: 2026-02-01
Plugin Version: 0.3.21
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
🆕 Latest Updates (0.3.21)
- Item enhancement blacklist: exclude specific itemIds (example: Blunderbuss ammo) so they will never receive rarity/affixes.
- Drop multiplier blacklist: exclude specific itemIds (example: loot bags) so they will never be multiplied by difficulty drop systems.
- Global enhancement chance: configurable chance for eligible weapons/armor to receive rarity + affixes (
enhancementGenerationChance). Set to 1.0 for “always enhance”.
- Armor HP regen balancing: configurable multiplier + cap to prevent broken stacked regen.
- HUD stability improvements: reduced join-time HUD race conditions.
📋 Hotbar Tooltip
Overview
The plugin shows a custom HUD tooltip when a player selects a slot on the hotbar. The tooltip is for the currently selected hotbar slot only (no mouse hover). It appears only for enhanced weapons or armor and hides automatically after a few seconds.
Important: This tooltip works only on the hotbar (selected slot). A normal per-item tooltip on hover (e.g. in inventory) is not possible at the moment due to current Hytale client limitations; the hotbar HUD is the supported way to show rarity and affixes for the equipped item.
- When: Visible for the active hotbar slot; card hides after 4 seconds or when changing slot.
- Content: Item name, rarity (coloured), and affixes, one per line.
- Empty/non-enhanced slots: No card is shown.
⚔️ 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 |
Rarity Bonus |
Drop Rate |
| Normal |
1.0x |
1.0x |
1.0x |
0% |
1.0x |
| Hard |
3.5x |
1.5x |
1.5x |
15% |
1.5x |
| Expert |
4.5x |
2.0x |
2.5x |
30% |
2.5x |
| Master |
6.0x |
2.8x |
4.0x |
50% |
4.0x |
Note: Enemy Defense uses diminishing returns internally to avoid extreme values (so the “effective” damage reduction is not purely linear).
How to use: Type /enhancer and open the Difficulty 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
🎮 Menu Command
/enhancer - Open the main menu (weapons, armor, difficulty, settings, inventory)
⚙️ 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
/enhancer: Open the menu to browse your items and manage upgrades/affixes
- 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/
⚙️ New Config Options
These options are in plugins/weapon-enhancer/config.json:
- enhancementItemIdBlacklist: itemIds that must NEVER receive rarity/affixes (example: ammo).
- dropMultiplierItemIdBlacklist: itemIds that must NEVER be multiplied by difficulty drop systems (example: loot bags).
- enhancementGenerationChance: chance (0.0 - 1.0) to apply rarity + affixes. Use 1.0 to keep “always enhance”.
- armorHpRegenMultiplier: multiplies the final stacked armor HP regen (lower = weaker regen).
- armorHpRegenMaxPercentPerInterval: caps HP regen per interval to prevent overpowered healing.
🔧 Requirements & Dependencies
This plugin requires the following mods/plugins to be installed and enabled on the server (i.e. not disabled by server config):
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 (Ellie:HyUI)
- Version: Latest compatible version
- Download: Available on CurseForge
- Purpose: Used for UI (e.g. salvage, upgrade, hotbar tooltip)
- Installation: Install HyUI as a separate mod/plugin (it is not bundled inside this JAR)
3. MultipleHUD (Buuz135:MultipleHUD)
- Version: Latest compatible version
- Purpose: Required for the hotbar tooltip HUD layer used by this plugin (client HUD integration)
- Installation: Install as a separate mod/plugin and keep it enabled
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
- "Dependency 'Ellie:HyUI' / 'Buuz135:MultipleHUD' could not be found": The mod is missing or disabled by server config
Note: This plugin is designed for Hytale Early Access. Features may change as the game develops.
