Mob Affix Engine v1.0.0-rc0.1.0

Hytale Mob Affix Engine 1.0.0-rc0.1.0​

Executive Summary for Server Admins​

This release introduces Thorns — a new damage reflection mechanic that bounces incoming damage back to attackers. Affixes can now apply up to Tier 5 Thorns
protection, perfect for high-defense loadouts. Under the hood, significant architectural improvements simplify testing and reduce code complexity without impacting
gameplay.

Thorns System — Damage Reflection Mechanic​

Introduces a new Thorns effect system that reflects a portion of incoming damage back to attackers.

• 5 Tiers Available: Thorns T1 through T5, each with increasing reflection multiplier
• Visual Feedback: Particle effects on reflect activation
• New Stat: THORNS_MULTIPLIER — controls damage reflection coefficient
• New Damage Cause: MobAffixEngine_Thorn — tracks reflected damage separately in combat logs
• Protection Stack: Multiple Thorns sources can stack for cumulative reflection
• No Reflect-of-Reflect: System guards against infinite reflect loops (reflects never trigger other reflects)

Server Admin Impact​

• Crafts with Thorns affixes now protect against burst damage strategies
• Works with all weapon types and damage sources (physical, environmental, etc.)
• Recommended for PvP arenas or high-difficulty mob encounters

Usage Examples:

Code:

# Apply Thorns T3 (15% reflection) to an NPC for 999999 seconds (permanent)
/mae add-effect world 550e8400-e29b-41d4-a716-446655440000 Thorns_T3 999999

# Apply T5 with periodic re-application every 60 seconds
/mae add-effect world 550e8400-e29b-41d4-a716-446655440000 Thorns_T5 60.0 --every 60.0

# Apply T2 to a player for a limited-time buff
/mae add-effect world 550e8400-e29b-41d4-a716-446655440000 Thorns_T2 30.0

# Apply with custom ThornsMultiplier stat (5000% thorns damage)
/mae add-effect world 550e8400-e29b-41d4-a716-446655440000 Thorns_T2 30.0 --stats "[{\"name\":\"Thorns\",\"multiplier\":50.0}]"

Effects Enhancement — Stats on Effects​

Effects can now carry associated stats, enabling richer affix combinations.

• Effect Stats: Each effect tier can define stat multipliers or bonuses
• Dynamic Scaling: Stats update in real time as effects tick
• UI Display: Stats management page shows effect-associated bonuses

Commands​

No new commands introduced in this release.

Permissions​

No new permissions required.

Dependencies​

No new dependencies​

Integrações & Placeholders​

No external integration changes in this release.

The Thorns system operates entirely within the Mob Affix Engine and does not depend on external plugins (Arena Waves Engine, CIE, etc.). It is compatible with existing integrations.

Post-Update Checklist​

• Backup your run/ directory (world data)
• Update the plugin JAR in your Hytale server plugins/ folder
• Restart your server
• Test Thorns effect application: /affix stat add <mob> THORNS_MULTIPLIER 1.0
• Verify particle effects on mob hit
• Check affix management UI displays correctly