An engine-independent C# RTS simulation kernel extracted from the Godot Warcraft3 learning project. Development follows that game's tactical and control requirements.
Early development: APIs, data structures and snapshot formats may change incompatibly. This is not a complete RTS framework and does not promise production readiness, cross-version save compatibility or cross-platform determinism. Networking, complete movement rules, combat, economy and abilities remain future work.
- Independent match instances, fixed simulation steps, entity IDs, queued commands and events.
- Framework ownership: entities, commands, events, order paths and group planning are owned by dedicated internal modules (see framework notes, Chinese).
- Simple velocity integration; JSON frame snapshots, restoration, state hashes and field-level difference reports.
- Serializable random state, static pathing grids and bilinear height sampling.
- 0.0.1: first usable framework baseline; see VERSION_0.0.1.md. Complete M2 movement acceptance and later gameplay migration are out of scope for this version.
- Eight-neighbor pathfinding with static and match-owned dynamic obstacles, cell clearance and frame commands that add or remove footprints; navigation snapshots validate static map identity.
- Goal-based path following with stop, replace and append queues; dynamic replanning, continuation after a failed queued goal, player / unit-AI source priority and order snapshot restoration.
- Authoritative facing, per-frame turning with turn-rate slowdown and elevation-based slope scaling; restoration validates height-field identity.
- Group placement with four soft formations, fixed-work deferred planning, sweep reservation and local detours, and slot-ordered compact arrival.
- Continuous congestion for 3 seconds fails the current goal and continues the queue; stopped units are not pushed.
- Windows first; determinism checks apply only to matching code, input, content and controlled runtime environments.
The current implementation uses ordinary C# types and modular composition, focusing on correctness, state ownership and readability without an ECS migration. ECS is not permanently excluded: a mature third-party implementation may be evaluated later against real maintenance needs, project performance measurements and dependency costs. A general-purpose framework is not built in advance. Hosts own input, assets, rendering and networking; the kernel has no Godot reference or scene-tree dependency.
See framework, navigation and movement for contracts (Chinese). Snapshot v9 stores facing, motion progress, order queues and group-planning progress, and validates supplied static grid and height field identities. Versions 1–8 are rejected; cross-version migration remains unsupported.
The match owns its random stream. Hosts cannot consume it through a public mutable object. Snapshot RngState can be used for diagnostics or a detached stream; the early mutable RtsMatch.Rng property has been removed.
Install the .NET 10 SDK. The library targets net8.0; the test and CLI hosts target net10.0. Initial restore needs the net8 targeting pack; CI installs both .NET 8 and 10 SDKs.
git clone https://github.com/LiGameAcademy/rts_kernel_cs.git
cd rts_kernel_cs
./Test.ps1Equivalent commands:
dotnet restore RtsKernel.sln -m:1
dotnet build RtsKernel.sln --no-restore -m:1 -c Release
dotnet run --project tests/Rts.Kernel.Tests --no-build -c Release
dotnet run --project samples/Rts.Kernel.Cli --no-build -c Release
Tests use a console assertion runner with a nonzero exit code on failure. Use the script above, not dotnet test, as the verification entry point. Windows CI runs the same script.
src/Rts.Kernel: simulation and terrain data contracts.tests/Rts.Kernel.Tests: kernel behavior checks.samples/Rts.Kernel.Cli: minimal headless example.
Godot adapters, WC3 JSON/SLK conversion, game assets and integration tests stay in the game repository. No game artwork or map assets are included here. Terrain coordinates and flag bits currently follow the source project's conventions, not a general-purpose map format.
git submodule add https://github.com/LiGameAcademy/rts_kernel_cs.git external/rts_kernel
git submodule update --init --recursive
Reference external/rts_kernel/src/Rts.Kernel/Rts.Kernel.csproj from the host. Pin the submodule commit and upgrade explicitly. Commit and push kernel work first, then update, verify and commit the host's submodule pointer.
Relevant path history was extracted from source commit 05cf2b0, preserving authors, dates and messages. Commit hashes changed; see the mapping. Historical commits retain pre-extraction project references; standalone builds are supported starting at the repository preparation commit.
MIT, Copyright (c) 2026 李维民. See LICENSE. No NuGet package or formal release is published at this stage.