Kitsune.Core 0.4.0

Kitsune

Kitsune is a 2D game engine for C# built on Foster. It modernizes proven Monocle-inspired patterns — Scene, Entity, Component, tags, and collision — as layered .NET libraries you can adopt incrementally.

Kitsune.Core (0.4.0) provides entity hierarchy, a LIFO scene stack (Replace, Push, Pop), tag queries, axis-aligned hitboxes, and depth-ordered rendering hooks. Kitsune.Bridges.Platformer adds Solid, Actor, PlatformerBody, forgiveness systems, moving platforms, collision layers, directional platforms, lift momentum, solid-authoritative kinematic push/carry/squish, and horizontal momentum storage after jump.

Prerequisites

• .NET 10 SDK

Build and run

dotnet build
dotnet test

HelloWorld — minimal Foster window (circle demo):

dotnet run --project Examples/HelloWorld

CoreDemo — Phase 1 Core proof (entities, collision, tags, depth ordering):

dotnet run --project Examples/CoreDemo

Use WASD and Space to move the orange player (A/D walk, Space/W jump). Red and blue rectangles demonstrate depth ordering (red draws on top).

PlatformerDemo — Platformer Bridge playground (coyote time, jump buffer, platforms):

dotnet run --project Examples/PlatformerDemo

Use A/D to walk, Space or W to jump, and S to drop through cyan jump-through platforms. The level is laid out in zones left-to-right: coyote ledge, jump-buffer gap, one-way crossing, jump-through terrace, a blue mover with a momentum-storage gap to the island, and a rising crusher alcove (red lip — jump off or respawn).

Project layout

kitsune-engine/
├── Kitsune.Core/                 # Engine runtime (Scene, Entity, Component, Hitbox)
├── Kitsune.Bridges.Platformer/   # Platformer Bridge (Solid, Actor, PlatformerBody)
├── Kitsune.Editor/               # Editor shell stub
├── Kitsune.Core.Tests/           # Core unit tests
├── Kitsune.Bridges.Platformer.Tests/  # Bridge unit tests
├── Examples/
│   ├── HelloWorld/               # Foster wiring smoke test
│   ├── CoreDemo/                 # Core feature demo
│   └── PlatformerDemo/           # Platformer Bridge demo level
├── docs/                         # Public documentation
└── kitsune.slnx

Documentation

• Getting started
• Design principles
• Contributing
• Changelog

License

MIT — see LICENSE.