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.