Void.Engine 1.2.1

Void Engine

A lightweight, extensible 2D game framework for .NET.

Philosophy

Extend, don't modify.

Most game engines try to do everything. They have physics, networking, UI, animation, and everything else you can think of. The problem is your game is unique. Your physics needs are different. Your UI is different. Yet these engines force you to use their way of doing things. You fight the engine instead of making your game.

At the other extreme, frameworks like MonoGame give you almost nothing. You end up rebuilding things every game needs: saving, audio management, pathfinding. These are solved problems. Why rebuild them?

Void sits in the middle. It gives you the essentials and gets out of your way.

Features

Quick Install

dotnet add package Void.Engine

Project Template

dotnet new install Void.Templates

Quick Start

1. Install the template

dotnet new install Void.Templates

2. Create a new game

dotnet new voidgame -n MyGame
cd MyGame

Or use the current folder:

mkdir MyGame
cd MyGame
dotnet new voidgame

3. Run your game

dotnet run

A window will appear. That's it.

Customizing Your Game

When creating a new game, you can specify:

dotnet new voidgame -n MyGame --appCompany MyStudio --appTitle "My Game"

What You Get

The template generates a complete, runnable game project with:

• Program.cs — Entry point with game settings
• MyGameGame.cs — Main game class with OnEnter, OnUpdate, OnDraw, OnExit
• Content/ — Folder for your assets
• Pre-configured .csproj with Void.Engine reference

Manual Setup (Optional)

If you prefer to set up manually instead of using the template:

dotnet new console -n MyGame
cd MyGame
dotnet add package Void.Engine

Then create MyGame.cs:

using Void.Engine;

public class MyGame : Game
{
    public MyGame(GameSettings settings) : base(settings) { }

    protected override void OnEnter() { }
    protected override void OnUpdate(FrameTime frameTime) { }
    protected override void OnDraw(FrameTime frameTime) { }
    protected override void OnExit() { }
}

And Program.cs:

using Void.Engine;

var settings = GameSettings.Instance
    .SetAppCompany("MyStudio")
    .SetAppName("MyGame")
    .SetWindow(1280, 720)
    .Build();

using var game = new MyGame(settings);
game.Run();

Demos

• FlappyBirb: A Flappy Bird clone
• Scavengers: A rogue-lite zombie survival clone

Asset Packer

Void includes a CLI tool and API for packing assets into encrypted, tamper-proof archives.

CLI Tool

# Build a pack
void-packer build -c Content/ -o Packs/

# Extract a pack
void-packer extract --pack GameAssets.pack --output Extracted/

# Verify pack integrity
void-packer verify --pack GameAssets.pack

# List files in a pack
void-packer list --pack GameAssets.pack --detailed

# Update a pack (fast incremental updates)
void-packer update --pack GameAssets.pack --add Content/newfile.png --remove oldfile.txt

Security Features

• AES-GCM 256-bit encryption
• Separate encryption for header and data sections
• Per-file CRC32 integrity verification
• Adaptive compression
• Chunked encryption with per-chunk authentication
• Stream-based reading from disk (no full pack loaded into memory)
• Thread-safe for concurrent asset loading

API Usage

// Load a pack in your game
var pack = AssetManager.Instance.LoadPack("GameAssets.pack");
AssetManager.Instance.AddMountToStart(pack);

// Load multiple packs with priority control
var graphicsPack = AssetManager.Instance.LoadPack("Graphics.pack");
var audioPack = AssetManager.Instance.LoadPack("Audio.pack");
AssetManager.Instance.AddMountToStart(graphicsPack);
AssetManager.Instance.AddMountToStart(audioPack);

// Graceful error handling
if (!Packer.TryLoadPack("Mod.pack", out var reader, out var error))
{
    Console.WriteLine($"Failed to load mod: {error}");
    return;
}

Extensibility

Void was built to be extended, not just used.

Every major system is built around interfaces and base classes that you can replace, customize, or ignore entirely.

What you can extend:

How it works:

GameSettings.Instance.SetAtlasPacker(typeof(MyAtlasPacker));
AssetManager.Instance.AddMountToStart(new CloudMount());
Logger.Instance.AddSink(new DatabaseSink());

No engine code modification. No forking the repo. No fighting the framework.

Supported Platforms

Requirements

• .NET 10
• SFML.Net 3.0

License

MIT. Use it for anything. No royalties. No fees.

Void Engine: Made by developers who care about your work.