Home

Welcome to RealmEngine

RealmEngine is a .NET 10 RPG backend engine built around clean architecture principles — CQRS with MediatR, vertical slice feature organization, and a PostgreSQL-backed content catalog.

It's designed to be UI-agnostic — any .NET application consumes it via a simple mediator.Send(command) API. The official clients in this repository are both Avalonia-based: Veldrath (the multiplayer game) and RealmForge (the Postgres content editor).

---

What's in this Repository

Component	Description
RealmEngine.Core	All game logic — combat, crafting, quests, progression
RealmEngine.Data	EF Core persistence, content & save-game repositories
RealmEngine.Shared	Shared models, abstractions, and utilities
Veldrath.Server	ASP.NET Core game server with SignalR real-time hub
Veldrath.Client	Avalonia cross-platform desktop client
RealmForge	Avalonia DB content editor for managing game entities
RealmFoundry	Blazor Server community content submission portal

---

Where to Go Next

I want to…	Go here
Set up the project and run the tests	Getting Started
Contribute code or fix a bug	Contributing
Understand why certain decisions were made	FAQ
See what's built and what's planned	Roadmap Summary
See implementation status	Implementation Status
Read the game design document	Game Design
Browse per-system feature docs	See sidebar → RealmEngine

---

Quick Links

• 🗺️ Game Design Document — complete game specification
• 📋 Implementation Status — 19/20 systems, 2,595+ engine tests
• 🐛 Issues — bug reports and feature requests