mirror of
https://github.com/johndoe6345789/BlockWar.git
synced 2026-04-24 13:45:04 +00:00
46 lines
1.9 KiB
Markdown
46 lines
1.9 KiB
Markdown
# BlockWar
|
|
A UE5 Game: Build Forts, Battle for Victory
|
|
|
|
## About
|
|
BlockWar is an innovative multiplayer FPS that combines tactical base construction with team-based combat. Build elaborate fortifications during the build phase, then battle it out in intense combat to capture the enemy flag.
|
|
|
|
Built in Unreal Engine 5, inspired by classic community mods.
|
|
|
|
## Technical Approach
|
|
|
|
**Procedural Generation + Unit Testing**: BlockWar uses UE5's native procedural generation tools (PCG Framework, Blueprints, C++, Python, Geometry Script) to create game content. This approach enables comprehensive unit testing while maintaining tight engine integration.
|
|
|
|
**Key Technologies:**
|
|
- **UE5 PCG Framework**: Level and content generation
|
|
- **Geometry Script**: Procedural mesh generation
|
|
- **Python**: Editor automation and unit testing
|
|
- **C++**: Performance-critical systems and testing
|
|
- **Blueprints**: Gameplay logic and procedural workflows
|
|
|
|
## Documentation
|
|
- [DESIGN_BRIEF.md](DESIGN_BRIEF.md) - Comprehensive game design documentation
|
|
- See "Procedural Generation Strategy" section for detailed technical approach and testing methodology
|
|
See [DESIGN_BRIEF.md](DESIGN_BRIEF.md) for comprehensive game design documentation.
|
|
|
|
## GitHub Actions diagnostics
|
|
This repository ships with a lightweight "workflow doctor" to help ChatGPT/Codex-style agents quickly understand and triage GitHub Actions issues without running the workflows themselves.
|
|
|
|
### Setup
|
|
1. Install the dependency:
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### Usage
|
|
- Inspect the repository from its root:
|
|
```bash
|
|
python tools/workflow_doctor.py
|
|
```
|
|
|
|
- Only print actionable diagnostics (skip verbose summaries):
|
|
```bash
|
|
python tools/workflow_doctor.py --quiet
|
|
```
|
|
|
|
When no workflow files are present, the tool reports that the `.github/workflows` directory is empty so that agents don't waste time chasing nonexistent CI definitions.
|