Forge Of The Ancients

# Forge Of The Ancients - Big changes

## 🆕 NEW WEAPONS

### ⭐ Starfall Greatsword
*"When the heavens rain destruction"*
- **Mark enemies** by attacking them (stacks up to 10)
- **Right-click** to call down meteors on all marked targets
- Meteors deal **15 damage** to main target + **7.5 AoE damage**
- **10 second cooldown** with visual preview particles
- Marks expire after 5 seconds
- Real-time mark counter in action bar

### ⚫ Dark Sword
*"Embrace the shadows, strike from darkness"*
- **Shadowstep** - Teleport up to 12 blocks forward with **safe collision detection**
- Gain **1 second invulnerability** and **3 seconds invisibility** after teleporting
- **Mark enemies** in 6 block radius at destination
- Deal **+3 bonus damage** to marked enemies for 5 seconds
- **Dark trail** - Wither enemies along teleport path
- **8 second cooldown**

---

## 🔧 MAJOR WEAPON OVERHAULS

### 🩸 Bleeding Katana - Complete Rework
**NEW MECHANICS:**
- **Bleeding System** - Apply bleed DoT that stacks up to 5 times
- **0.5 damage per second per stack** (max 2.5 DPS at 5 stacks)
- **Lifesteal Scaling** - Heal 2-7 HP based on bleed stacks (25-50% proc chance)
- **Critical Strikes** - 15% chance for 1.5x damage with particle effects
- **Execute Mechanic** - +4 bonus damage to enemies below 30% HP
- **Statistics Tracking** - Bleeds applied, heals, critical hits, executes

**FIXES:**
- Fixed broken Random import (was using JOML library)
- Removed static Random instance (thread-safe now)
- Added comprehensive visual/audio feedback

---

### ❄️ Ice Blade - Complete Rework
**NEW MECHANICS:**
- **Freeze with Cooldown** - 30% chance with 1 second internal cooldown
- **Frozen Bonus Damage** - Deal +2 damage to already frozen enemies
- **Freeze Immunity** - 3 seconds immunity after freeze expires (prevents spam)
- **Shatter on Death** - Frozen enemies explode with ice shards (40 particles)
- **Ambient Aura** - Gentle snowflakes when holding sword

**IMPROVEMENTS:**
- All particles now SERVER-SIDE (multiplayer fixed)
- Reduced particle spam (70% reduction)
- Better freeze detection using entity NBT tracking
- Freeze duration: 6 seconds with Slowness III

**FIXES:**
- Fixed client/server desync issues
- Fixed thread-unsafe Random usage
- Added proper null checks throughout

---

### ⚗️ Toxic Cutlass - Major Improvements
**NEW MECHANICS:**
- **Poison Stacking** - Hitting poisoned enemies extends duration by 2 seconds
- **Poison Combo Damage** - +2 damage to poisoned enemies with visual feedback
- **Poison Trails** - Poisoned enemies leave green particle trails
- **Plague Surge Enhanced** - Now deals damage AND applies wither
- **Healing Cap** - Maximum 10 HP per use (prevents abuse)

**IMPROVEMENTS:**
- All particles SERVER-SIDE (multiplayer ready)
- Ally protection (won't poison teammates)
- 60% fewer particles (performance boost)
- Better knockback (pushes away instead of pulling)

**FIXES:**
- Fixed client/server particle issues
- Added team/ally checking
- Durability cost added (2 per use)

---

### ⚡ Eternal Blade - Safe Dash System
**NEW MECHANICS:**
- **Combo System** - Base 8 damage + 2 per enemy hit (scales!)
- **Combo Bonuses:**
  - 3+ enemies: Speed II for 5 seconds + visual flash
  - 5+ enemies: Heal 4 HP + special message
- **Safe Dash** - Full collision detection (no more deaths!)
- **Dark Trail** - Wither enemies along dash path

**IMPROVEMENTS:**
- Momentum-based velocity (much safer than raw speed)
- Stops before walls/lava/void (no more accidents)
- Resistance II instead of full invulnerability (balanced)
- Preview particles show destination
- 70% fewer particles (performance)

**FIXES:**
- Fixed dangerous teleport into walls/void/lava
- Fixed ally damage (team-safe now)
- Reduced from 200 to 80 particles
- Added fall damage prevention

---

### ✦ Heavenly Sword - No More Self-Punishment!
**MAJOR CHANGES:**
- **REMOVED 4-second self-blindness** (was terrible!)
- **ADDED Night Vision** (7 seconds)
- **ADDED Regeneration II** (7 seconds, ~8 HP healed)
- **ADDED Resistance I** (7 seconds)
- **Fall Protection Now Conditional** - Only works during active blessing (10s)

**NEW MECHANICS:**
- **Divine Damage** - 6 damage to knocked enemies (offensive now!)
- **Smart Fall Protection** - Works in mainhand OR offhand
- **Visual Aura** - Particles when blessing is active
- **Fall Save Counter** - Tracks how many falls negated

**IMPROVEMENTS:**
- Reduced Absorption from +4 to +2 hearts (balanced)
- All particles SERVER-SIDE (70% reduction)
- Cooldown reduced from 20s to 18s
- Ally protection added

---

### 🔥 Hell Sword - Burn Stacking System
**NEW MECHANICS:**
- **Burn Stacking** - Burns stack up to 3 times (longer duration per stack)
- **Burning Bonus** - +2 damage to already burning enemies
- **Fire Immunity** - 3 seconds after using ability
- **Soul Harvesting** (removed weakness on crit - was broken)
- **Stack Indicator** - Shows burn stacks when looking at enemies

**IMPROVEMENTS:**
- All particles SERVER-SIDE (67% reduction: 150 → 50)
- Fire duration scales with stacks (6-8 seconds)
- Inferno duration increased to 10 seconds
- Ally protection added
- Better visual effects

**FIXES:**
- Removed broken critical hit detection
- Fixed team damage
- Added durability cost

---

### ⚫ Sculk Blade - From Punishment to Power
**MAJOR CHANGES:**
- **REMOVED 8-second self-darkness** (was awful!)
- **ADDED Night Vision** (7 seconds)
- **ADDED Resistance I** (7 seconds)
- **ADDED Damage Component** - 6 damage pulse to all enemies

**NEW MECHANICS:**
- **Soul Harvesting** - Heal 2 HP per kill during 7-second window
- **Soul Absorption** - Gain Absorption I per kill
- **Soul Particles** - Visual soul trails fly to you on harvest
- **Status Display** - Shows harvesting time remaining

**IMPROVEMENTS:**
- Strength reduced from V to IV (balanced)
- Weakness buffed from II to III
- Cooldown reduced from 20s to 15s
- Ally protection added
- Better visual effects with custom particle fallbacks

---

### ✦ Orion Scythe - Constellation System
**NEW MECHANICS:**
- **Constellation Stacking** - Marks stack up to 5 times on enemies
- **Active Ability: Supernova** - Right-click to detonate ALL marks (20 block range)
- **Scaling Damage** - 5 base + 2 per stack (passive), 2x damage on supernova
- **Mark Duration** - 6 seconds (refreshes on hit)
- **Target Counter** - Shows marked enemy count when holding

**IMPROVEMENTS:**
- Starfire proc chance increased from 30% to 35%
- Removed 2-second cooldown on passive (no more feel-bad moments)
- Better visual stacking indicators
- Proper player damage attribution (not magic)
- Ally protection added

**FIXES:**
- Fixed magic damage source issues
- Added durability cost (2 per supernova)
- Better particle effects

---

### ⚡ Storm Rapier - Chain Lightning
**NEW MECHANICS:**
- **Chain Lightning** - Each strike chains to 1 nearby enemy (8 blocks)
- **Scaling Speed Buff** - Speed I-IV based on total enemies hit
- **Extended Duration** - 6s base + 1s per enemy struck
- **Target Preview** - Shows enemy count in action bar when holding

**IMPROVEMENTS:**
- Chain lightning deals 70% damage (5.6 per chain)
- Optimized Y-axis search (±10 blocks instead of ±20)
- Can hit up to 6+ enemies total with chains
- Visual chain particle effects
- Ally protection added

**FIXES:**
- Added team/ally checking
- Better targeting system
- Cooldown reduced from 9s to 8s

---

### ◈ Voidreaver Greatsword - Critical Fixes
**CRITICAL FIXES:**
- **FIXED MEMORY LEAK** - Removed dangerous static list
- **THREAD-SAFE** - Now uses ItemStack NBT instead of shared state
- **AUTO-CLEANUP** - No more lingering effects on disconnect

**NEW MECHANICS:**
- **Final Implosion** - 8 damage burst when singularity ends
- **Better Pull** - Slight vertical component (more natural)
- **Every Tick Updates** - Smoother pull (was every 5 ticks)
- **Status Display** - Shows remaining time when holding

**IMPROVEMENTS:**
- All particles every tick (much smoother)
- Better visual effects with void tear
- Crush damage now shows indicators
- Ally protection added
- Durability cost added

---

## 🛡️ GLOBAL IMPROVEMENTS

### Performance Optimizations
- **Particle Reduction** - Average 60-70% fewer particles across all weapons
- **Server-Side Rendering** - All particles now multiplayer-compatible
- **Thread Safety** - Removed all static Random instances
- **Efficient Searches** - Optimized entity detection ranges

### Multiplayer Support
- **Ally Protection** - All weapons now check for teammates/tamed entities
- **Team Safety** - Won't damage same-team players
- **Proper Sync** - Fixed client/server desync issues throughout

### Quality of Life
- **Statistics Tracking** - All weapons now track usage stats
- **Durability Costs** - Consistent resource management
- **Visual Feedback** - Enhanced particles, sounds, and action bar messages
- **Better Tooltips** - Animated borders, real-time status, comprehensive info

### Code Quality
- **NBT Constants** - All NBT keys properly defined
- **Helper Methods** - Better code organization
- **Comments** - Comprehensive documentation
- **Error Handling** - Proper null checks and fallbacks

---

## 📊 STATISTICS

**Total Lines of Code Improved:** ~8,000+
**Bugs Fixed:** 30+
**Performance Improvements:** 60-70% particle reduction
**New Mechanics Added:** 25+
**Weapons Overhauled:** 11

---

**Thank you for playing Forge of the Ancients!**