Architecting complex strategic ecosystems through rigorous logic and modular design.
The Universal War Engine is a sophisticated tactical simulation framework designed to handle complex combat mechanics and unit-based strategic gameplay. Developed as a core logic asset within the Codiom initiative, this project focuses on scalable system architecture and deterministic game state management.
As a Software Engineering student at Istanbul Aydın University, I utilized this repository to implement advanced Object-Oriented Programming (OOP) patterns—ensuring that unit behaviors, combat interactions, and world-state transitions are handled with industrial-grade efficiency.
- 🛡️ Unit Management System: Hierarchical unit classes with unique attributes (health, attack, defense) and specialized abilities.
- ⚔️ Tactical Combat Logic: Implementation of turn-based battle algorithms with balanced damage calculation and probability-based outcomes.
- 🛠️ Modular Game State: Decoupled architecture allowing for seamless transitions between exploration, preparation, and combat phases.
- 🤖 Algorithmic Strategy: Scalable backend capable of supporting both human-driven decisions and automated AI maneuvers.
- 💾 State Persistence: Integrated logic for managing game sessions and historical combat logs.
| Category | Technology | Usage |
|---|---|---|
| Development | Python 3.9+ | Core game logic and system orchestration. |
| Paradigm | OOP / Modular | Primary design methodology for scalable unit and combat systems. |
| Mathematics | NumPy | High-performance calculation for combat probabilities and balancing. |
| Data Format | JSON / YAML | Managing unit stats, configurations, and world-state data. |
| Version Control | Git / GitHub | Management of source code and architectural revisions. |
The engine follows an Event-Driven Component Architecture, ensuring that combat events are processed independently from the user interface or data layer.
Combat outcomes are determined through a balanced algorithmic approach:
-
Net Damage Calculation:
$$Damage = (Base_Attack \times Crit_Multiplier) - Defense_Resistance$$ -
Survival Probability: Measures the statistical likelihood of a unit surviving a multi-turn engagement.
$$P(Survival) = 1 - P(Lethal_Hit)$$
.
├── 📁 src/
│ ├── units.py # Unit class hierarchy and specialized behaviors
│ ├── combat.py # Battle algorithms and damage logic
│ └── game_state.py # World-state and session management
├── 📁 config/
│ └── unit_stats.json # Balanced attribute configurations
├── 📄 main.py # Engine entry point and loop orchestration
├── 📄 requirements.txt # Dependency manifest
└── 📄 README.md # System Documentation# Clone the repository
git clone [https://github.com/BerattCelikk/Universal_War-Game-.git](https://github.com/BerattCelikk/Universal_War-Game-.git)
cd Universal_War-Game-
# Initialize virtual environment
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
To launch the strategic engine:
python main.py- AI Integration: Implementing basic Heuristic Search algorithms for automated strategic opponents.
- GUI Framework: Developing a graphical interface using Pygame or CustomTkinter for enhanced visualization.
- Multiplayer Logic: Adding socket-based networking for real-time strategic combat between players.
- Dynamic Environments: Integrating terrain-based effects on unit movement and combat efficiency.
Architected with precision by Berat Erol Çelik Founder of Codiom
Software Engineering @ Istanbul Aydın University