#10

# Devlog

## 2026-05-23

---

# 🧠 WaveSystem Stabilization

- Fixed double enemy-death processing caused by projectile attacks

- Added `is_dead` flag to BaseEnemy

- Ensured `remove_from_group("Enemy")` is called on death

- Stabilized wave completion conditions

---

# 📦 SpawnSystem Improvements

- EnemySpawner converted to async spawning

- Added spawn interval support

- Added active spawn tracking

- Improved spawn_finished detection

---

# 💨 Enemy Spawn Presentation

- Added black smoke effect on spawn

- Fade-in on spawn

- Scale tween on spawn

- Disabled AI during spawn using `is_spawning`

---

# 🚪 Escape System Improvements

- Black smoke effect on escape

- Wave counter adjustments on escape

- Squad disband on escape

---

# 🧹 Enemy Removal Pipeline Refactor

Unified all enemy removal cases into a single design direction:

- Death

- Escape

- Wave forced cleanup

---

# 🧭 Steering Improvements

- Added velocity damping

- Added spawn zone constraints

- Added inward pressure toward center

- Reduced swarm dispersion

---

# 🧑‍🤝‍🧑 Squad AI

- Investigated leader scaling issues

- Fixed conflicts between spawn animation and leader scaling

- Preserved original scale during spawn

---

# 📊 Current Status

Enemy group behavior is now mostly stable.

### Remaining Issues

- Enemy density tuning

- Circle formation refinement

- Broken state handling

- Leader death presentation

- Spawn anticipation effects

---

# 🎬 Battle Presentation System Added

Added central UI presentation for combat flow:

### Features

- CenterMessageUI system

- Black bars + fade tween

- Wave / Battle / Escape presentation

### Flow

GATE OPEN  

→ ENEMY COMING  

→ BATTLE START  

→ WAVE START  

End of battle:

WAVE CLEAR  

→ BATTLE END  

→ YOU SURVIVED  

---

# 🧩 UIManager Expansion

- Added center message registration system

- Unified `show_center_message()` access

Now usable from:

WaveSystem / Events / Story / Boss / Zones

---

# 🎞 Center Message Improvements

- Separated background and text tweens

- Added message_id-based cancellation system

- Improved timing consistency

- Fixed async overlap issues

---

# 🧠 Key Insight

Battle presentation is not just UI —

it directly controls game pacing and player perception.

Especially:

- Pre-combat silence

- Enemy spawn timing

- Transition pacing between waves

These strongly affect player tension and engagement.

---

# 🌐 EventSystem Integration

- Decoupled NPC / Gate / Wave / UI systems

- Added KING_TALKED progression event

- Wave events introduced (START / COMPLETE / ESCAPE)

Enables:

NPC → Event → Gate → Wave → World reaction loop

---

# ⚔ Combat System Refactor (Chain System)

- Implemented ChainManager

- Added chained damage system

- All attacks now support chaining

---

# 🗡 Slash System Improvements

- Added homing slash behavior

- Added hit-scale feedback

- Implemented chain slash propagation

---

# 🔥 Fire & Lightning Chain Support

- Fireball: AoE + DoT + chain support

- Lightning: bounce-based multi-hit system

---

# 🧮 DamageSystem Unification

- Unified all damage processing

- Integrated ChainManager into damage flow

---

# 🎮 Player Adjustments

- Added forward impulse on attack

- Improved “attack weight” and motion feel

---

# 💡 Gameplay Feel Improvements

- Dense combat is now more rewarding

- Chain system reinforces crowd combat satisfaction

- Core loop is becoming clearer: “group → chain → collapse”

---

# 📌 Next Improvements

- Chain UI polish (screen pop, glow, shake)

- Chain multiplier system (damage scaling over 10+)

- Improved attack weight / inertia tuning

- Lightning chain acceleration

- Enemy density balancing