Aurora Falls - Voxelgine

Aurora Falls is a C#/.NET voxel sandbox with procedural worlds, Quake-style movement, server-authoritative multiplayer, entities, combat, and a dedicated headless server.

The client has been migrated in place from Raylib to FishGfx. The production client contains no Raylib package or compatibility path. It targets Windows x64, while the shared engine and dedicated server remain portable net10.0 projects.

Highlights

• Procedural, mutable 16x16x16 voxel chunks with dual-channel lighting
• Server-authoritative networking, prediction, interpolation, and combat
• Quake-style ground/air movement, swimming, collision, and ray queries
• FishGfx voxel rendering, real MSAA, post-processing, and FishUI integration
• A custom high-level audio API over a narrow native miniaudio shim
• Streamed ambience and basic positional 3D audio, with a future Steam Audio seam
• Indexed, independently compressed world columns with spatial client streaming
• A graphics-free dedicated server that can publish and run on Windows or Linux

Repository layout

RaylibGame.sln
|- Voxelgine/                 Windows x64 client and game-specific adapters
|- VoxelgineEngine/           Portable world, simulation, entities, networking, and contracts
|- VoxelgineServer/           Portable dedicated server
|- Voxelgine.Audio/           Managed high-level audio layer
|- native/VoxelAudioNative/   Narrow C ABI implemented with miniaudio
|- UnitTest/                  Windows client and integration tests
|- VoxelgineEngine.Tests/     Portable engine/world/network tests
|- Voxelgine.Audio.Tests/     Audio contract and native integration tests
`- thirdparty/
   |- FishGfx/                Pinned FishGfx submodule, including nested FishUI
   `- miniaudio/              Pinned miniaudio submodule

ChunkMap remains authoritative for simulation, collision, saves, and network data. The FishGfx VoxelWorld is a client-owned rendering mirror; it is never a serialization or gameplay authority. See Architecture for the ownership and headless-boundary rules.

Quick start

The clone must include recursive submodules:

git clone --recurse-submodules https://github.com/sbarisic/RaylibGame.git
Set-Location RaylibGame
git submodule status --recursive

For an existing clone:

git submodule sync --recursive
git submodule update --init --recursive

Mutable configuration, saves, player records, and logs are stored in a writable per-user runtime directory, not beside the executable. See docs/RUNTIME_DATA.md, or pass --data-root <path> to the client or dedicated server.

Do not use git submodule update --remote. The parent repositories deliberately pin exact dependency commits.

Windows client requirements are the .NET 10 SDK, the .NET 9 targeting pack for the pinned nested FishUI project, and Visual Studio 2022 or 2026 with the MSVC x64 C/C++ toolchain and Windows SDK. CMake can be on PATH or installed through Visual Studio's C++ CMake tools; the build discovers it automatically. Build and run the FishGfx client with:

dotnet build Voxelgine/Voxelgine.csproj -c Release `
  -f net10.0-windows10.0.17763.0 -p:Platform=x64
dotnet run --project Voxelgine/Voxelgine.csproj -c Release `
  -f net10.0-windows10.0.17763.0

Run the portable dedicated server with:

dotnet run --project VoxelgineServer/VoxelgineServer.csproj -c Release -- `
  --port 7777 --seed 666

The complete toolchain, publish, test, and package-audit commands are in Building and validation.

Documentation

• Standalone downloads, automatic updates, and releasing
• Architecture and migration invariants
• Dependency pins and upstream workflow
• Audio architecture and cue bank
• Models, shaders, and asset conversion
• Building, testing, publishing, and package audits
• World archive and spatial streaming

Multiplayer and persistent identity

Network protocol 2 authenticates persistent local P-256 identities and all UDP datagrams. Display names do not own saves. Legacy player files are backed up; identity-based profiles start fresh. The client pins server keys after the first authenticated connection. Global sandbox/debug commands require the host or an authorized administrator. World archive format 6 remains unchanged. See Multiplayer, Hosting, and Runtime data before moving keys or resetting trust.

Controls

Input	Action
WASD	Move
Mouse	Look
Space	Jump or swim up
Shift	Walk, swim down, or ledge safety
C	Toggle noclip
1-9, 0	Select one of ten hotbar slots
Left mouse	Use item or break block
Right mouse	Place the selected block, wheat, basket, or bed
E	Interact with a plant or furniture
Tab	Open inventory
P (hold)	Show player list
T	Open chat
F1	Toggle debug menu
F3	Toggle debug mode
F5	Toggle network/renderer statistics
Escape	Close the active overlay, or disconnect and return to the main menu

License

This project is for educational and experimental purposes. See LICENSE.