Weapon Enhancer

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

1. Start Simple: Create weapons with base materials to understand the system
2. Use /enhancer: Open the menu to browse your items and manage upgrades/affixes
3. Progressive Upgrades: Start with low probability upgrades to save essences
4. Stack Armor: Wear 4 pieces with the same affix to maximize effect
5. Super Affixes: Look for weapons with Super Affixes for easier combat
6. Recycle Old Items: Recycle old weapons/armor to recover materials
7. Difficulty Rewards: Higher difficulty = better rewards, but more challenge
8. 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. 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)

2. 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.