A powerful Hytale server plugin that enhances weapons and armor with random properties, this loot system similar to action RPGs like Diablo, rarities, and affixes. Every crafted weapon receives unique enhancements that make each weapon truly special!
Description
Weapon Enhancer Plugin
Last Update: 2026-02-01
Plugin Version: 0.3.21
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.