Archeoids

A playable Asteroids-style game where every ship, rock, bullet, and particle is an Archevolt entity.

Archeoids gameplay with a cyan ship, drifting asteroids, and a score and lives HUD.

Archeoids is a small Asteroids game built with Archevolt and Silk.NET. Fly through wrapping sectors, split rocks, and survive with three lives. Archevolt runs the gameplay, and Silk.NET handles the window, input, and rendering. All shapes and text are generated in code.

Run

From the repository root:

dotnet run --project samples/Archeoids -c Release

The desktop game needs a graphical session and an OpenGL 3.3 driver. NuGet restores Silk.NET’s windowing, input, OpenGL bindings, and native GLFW dependencies.

Key	Action
A / D or Left / Right	Turn
W or Up	Thrust
Space	Fire
P	Pause or resume
R	Restart
Escape	Quit

The HUD shows score, sector, remaining lives, visible entity count, and smoothed simulation time per tick. A new ship flashes during its temporary invulnerability. Clear every rock to start the next sector.

Read the code

File	Role
GameModel.cs	Unmanaged components, spawn bundles, resources, messages, and the wrapping arena.
GameSystems.cs	Generated queries, systems, and explicit schedule dependencies.
Game.cs	Owns the world and schedules. `Step` advances one fixed 1/120-second tick, and `Capture` extracts sprites after commands flush.
Program.cs	Connects the window and keyboard to the fixed-step loop.
VectorRenderer.cs	Batches procedural shapes and a tiny bitmap font into OpenGL triangles. It never accesses the world.
Verification.cs	Exercises the real simulation and captures the framebuffer during a smoke run.

Patterns to look for

Deferred commands. A hit marks its rock immediately, then queues despawns, so overlapping bullets cannot destroy it twice. See Deferred commands.
Independent message readers. Three readers consume RockDestroyed to split rocks, award points, and create particles. See Messages.
Tags that change membership. Adding and removing Invulnerable changes whether a ship matches the damage query. See Queries and filters.
Deterministic simulation. A seeded random resource and a fixed timestep make runs reproducible. Restart replaces the world and its schedules, which clears entities and message cursors.

Collision detection uses simple bullet-versus-rock loops, because the sample is intended for a small arena.

Verify

Run deterministic gameplay checks without a window:

dotnet run --project samples/Archeoids -c Release -- --verify

The checks cover one-hit rock splitting, independent message readers, command visibility, expiration before collision, wrapping, seam collisions, invulnerability, game over, waves, and restart. Success prints archeoids=ok checks=5.

Run six seconds of scripted play through the real window and renderer:

dotnet run --project samples/Archeoids -c Release -- --smoke-test

The smoke run checks that the framebuffer contains foreground geometry, writes artifacts/archeoids/smoke.bmp, prints graphics=ok, and closes automatically. It needs a graphical session, while the gameplay checks can run in headless CI.