Coreria is a custom game engine designed for creating physics-intensive, real-time combat games. Built with a hybrid Rust/C architecture, it combines modern systems programming with battle-tested game development libraries to deliver high-performance gaming experiences.
- 🔥 Real-Time Physics: Powered by ODE (Open Dynamics Engine) for authentic momentum and collision systems
- ⚡ High Performance: Rust core with C game logic for optimal speed and memory safety
- 🎨 Modern Graphics: OpenGL rendering with Bevy integration for advanced visual effects
- 🥊 Combat-Focused: Specialized systems for fighting games with ragdoll physics and destructible environments
- 🛠️ Spec-Driven Development: Integrated development methodology with ChronoShift toolkit
ChaosForge is a multiplayer arena deathmatch game that showcases the full power of the Coreria engine. Battle in a destructible 3D coliseum where physics and skill determine victory.
- 4-8 Player Combat: Intense multiplayer battles with no login required
- 4 Unique Fighting Styles:
- 🥊 Brawler: Close-quarters powerhouse with devastating combos
- ⚡ Striker: Lightning-fast attacks and mobility
- 👻 Phantom: Elusive fighter with deceptive moves
- 🛡️ Titan: Heavy defender with crushing ultimates
- Dynamic Arena: Shrinking boundaries force confrontation
- True Physics: Momentum-based combat with ragdoll deaths
- Destructible Environment: Break the arena as you fight
Movement: WASD
Sprint: Shift (50% speed boost, stamina-based)
Block: Ctrl (75% damage reduction)
Combat: Mouse buttons for combos and special moves
The Coreria engine uses a hybrid architecture optimized for performance and maintainability:
┌─────────────────┐ ┌─────────────────┐
│ Rust Core │ │ C Game Logic │
│ │ │ │
│ • Memory Safety │◄──►│ • Game Systems │
│ • Modern Tools │ │ • Performance │
│ • Bevy ECS │ │ • OpenGL/GLFW │
└─────────────────┘ └─────────────────┘
│ │
└───────────┬───────────┘
▼
┌─────────────────────┐
│ Shared Libraries │
│ │
│ • OpenGL Rendering │
│ • ODE Physics │
│ • Audio Systems │
└─────────────────────┘
- Core Engine: Rust with Bevy ECS and OpenGL bindings
- Game Layer: C with GLFW for windowing and input
- Physics: Open Dynamics Engine (ODE) for realistic simulations
- Graphics: OpenGL 3.3+ with modern shader pipeline
- Build System: Cargo for Rust, Make for C components
ChronoShift is our integrated development methodology that transforms how games are built. Instead of code-first development, specifications drive implementation.
- 📋 Executable Specifications: Specs that generate working code
- 🔄 Iterative Development: Rapid prototyping and refinement
- 📚 Automatic Documentation: Always up-to-date project docs
- 🎯 Feature Planning: Structured approach to game development
- 🤖 AI-Assisted: Works seamlessly with modern coding assistants
# Initialize a new game project
uvx --from git+https://github.com/github/spec-kit.git specify init my-game
# Generate specifications
specify create-spec "multiplayer combat system"
# Plan implementation
specify plan
# Generate development tasks
specify tasks- Rust (latest stable) - Install Rust
- C Compiler (GCC/Clang)
- OpenGL Development Libraries
- ODE Physics Library
- Python 3.11+ (for ChronoShift tools)
# Clone the repository
git clone https://github.com/CGXDevTeam/Coreria.git
cd Coreria
# Build and run ChaosForge
cd chaosforge-game
make
./chaosforge# Build the Rust core
cargo build --release
# The engine will be available as a library for C games# Install the spec-driven development toolkit
cd ChronoShift/spec-kit
pip install -e .
# Verify installation
specify --helpCoreria/
├── 🦀 src/ # Rust engine core
│ └── main.rs # Engine entry point
├── 🎮 chaosforge-game/ # ChaosForge game implementation
│ ├── main.c # Game entry point
│ ├── combat_system.c # Fighting mechanics
│ ├── physics_manager.c # Physics integration
│ └── Makefile # Build configuration
├── 🛠️ ChronoShift/ # Development methodology
│ └── spec-kit/ # Spec-driven development tools
├── 📋 specs/ # Feature specifications
│ └── 003-build-coreria-a/ # Current development spec
├── ⚙️ Cargo.toml # Rust dependencies
└── 📖 README.md # This file
Rust Engine:
cargo build # Debug build
cargo build --release # Optimized build
cargo test # Run testsChaosForge Game:
cd chaosforge-game
make # Build game
make clean # Clean build artifactsChronoShift Tools:
cd ChronoShift/spec-kit
pip install -e . # Editable install
python -m pytest # Run tests# Test the complete system
cargo test # Engine tests
cd chaosforge-game && make test # Game tests (if available)
cd ChronoShift/spec-kit && python -m pytest # Tool testsWe welcome contributions! Whether you're interested in:
- 🎮 Game Development: Enhance ChaosForge or create new games
- ⚙️ Engine Development: Improve the Rust/C core systems
- 🛠️ Tooling: Extend the ChronoShift development methodology
- 📚 Documentation: Help others understand and use Coreria
Please see our Contributing Guide for details.
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ by the Coreria Team
Overview • ChaosForge • Engine • ChronoShift • Quick Start