🎮 Turn-Based Battle System (Unity, C#)

A polished 2D turn-based battle system built in Unity, focusing on clean architecture, modular systems, and responsive UI/UX.
This project demonstrates a complete combat loop with multiple enemies, player abilities, and dynamic UI feedback.

---

▶️ How to Play

The game is available as a downloadable build:

👉 Play on itch.io

Option 1 – Run Build (Windows)

Download the build and run:

TurnBasedBattle.exe

Make sure all files in the folder remain together.

Option 2 – Run Build (MacOS)

Download the build and run:

TurnBasedBattle.app

Option 3 – Run in Unity

1. Open project in Unity
2. Load main scene
3. Press Play

---

🎬 Gameplay

⚔️ Basic Combat

💥 Skill Combo

🛡️ Defend & Block

⏸️ Pause Menu

---

🚀 Features

• 🔁 Turn-based combat loop (Player → Enemy → Player)
• ⚔️ Multiple enemies with independent behavior
• 🛡️ Defend system (player & enemies)
• 💥 Skill combo system (multi-hit animation + SFX logic)
• ❤️ Heal system using skill points
• 🎯 Target selection (keyboard + mouse support)
• 🎵 Centralized SFX system
• 🖱️ Hover feedback (UI + enemies)
• ⏸️ Pause menu with resume / restart / exit
• 🏁 Win / Lose states with UI transitions

---

🛠️ Technologies Used

• Unity (Version: 6.4)
• C#
• Unity Input System
• TextMeshPro

---

📁 Project Structure

TurnBasedBattle/
│
├── Assets/
│   ├── _Project/
│   │   ├── Animations/
│   │   ├── Audio/
│   │   ├── Materials/
│   │   ├── Prefabs/
│   │   ├── Scenes/
│   │   ├── Scripts/
│   │   │   ├── Animation/
│   │   │   ├── Audio/
│   │   │   ├── Combat/
│   │   │   ├── Core/
│   │   │   ├── Environment/
│   │   │   └── UI/
│   │   ├── Settings/
│   │   └── Sprites/
│   ├── TextMesh Pro/
│   └── ThirdParty/
│
├── Packages/
└── ProjectSettings/

---

🧠 Architecture

The project follows a clean separation of responsibilities:

Core Scripts

• BattleManager → game logic, turn flow, combat rules
• BattleUI → UI rendering and interaction
• BattleCharacterAnimator → animation control only
• SFXManager → centralized audio playback

Design Principles

• No gameplay logic in UI
• Modular and readable code
• Minimal duplication
• Clear separation of concerns

---

🎮 Controls

Action	Key
Select Action	W / S
Select Enemy	A / D
Confirm	Enter
Pause Menu	ESC
Skip Turn	P

---

📚 What I Learned

• Designing a modular turn-based combat system with clear separation of concerns
• Structuring Unity projects for readability and maintainability
• Managing game state and turn flow using a centralized controller (BattleManager)
• Implementing responsive UI systems without embedding gameplay logic in UI scripts
• Creating reusable animation wrappers to decouple logic from presentation
• Designing and implementing a flexible input system using Unity's new Input System
• Handling edge cases in gameplay (defend mechanics, target validation, action availability)
• Improving user experience through audio feedback, hover states, and UI responsiveness
• Refactoring and cleaning up code to achieve a consistent and professional codebase

---

📌 Future Improvements

• Status effects (poison, stun, buffs)
• Enemy AI patterns
• Data-driven abilities
• Save system
• Expanded UI polish

---

🎨 Assets & Credits

The following third-party assets were used in this project:

🎵 Music

• JRPG/RPG Combat Exploration Theme
  https://assetstore.unity.com/packages/audio/ambient/fantasy/jrpg-rpg-combat-exploration-theme-307427

🔊 Sound Effects

• RPG Essentials Sound Effects - FREE!
  https://assetstore.unity.com/packages/audio/sound-fx/rpg-essentials-sound-effects-free-227708

🖥️ UI

• GUI Parts
  https://assetstore.unity.com/packages/2d/gui/icons/gui-parts-159068

🌄 Background

• Free 2D Cartoon Parallax Background
  https://assetstore.unity.com/packages/2d/environments/free-2d-cartoon-parallax-background-205812

🧍 Player Character

• Hero Knight - Pixel Art
  https://assetstore.unity.com/packages/2d/characters/hero-knight-pixel-art-165188

🗡️ Enemy Characters

• Bandits - Pixel Art
  https://assetstore.unity.com/packages/2d/characters/bandits-pixel-art-104130

🤖 AI-Generated Assets

• Character avatar visuals generated using Playground AI
  https://playground.com/

---

All assets are used under their respective licenses for educational and portfolio purposes.

📄 License

This project is made for my portfolio, for educational purposes only.