Skip to content

What's New in Brine2D

Track Brine2D's evolution from early beta to stable release. See what has changed, what is new, and what is coming next.

Latest Release

v0.9.7-beta — 2026

Input system solidification + complete Box2D physics integration.

  • 🎮 Input Action Maps — Rebindable InputAction / InputActionMap / InputBinding layer with 8 binding types
  • 🕹ī¸ Expanded Gamepad API — Built-in deadzone on stick helpers, trigger pressed/released, rumble, multi-gamepad lobby helpers
  • 🖱ī¸ Mouse enhancements — Horizontal scroll, cursor visibility, relative/captured mode
  • ⚛ī¸ Box2D 3.x physics — ECS-native bodies, 5 shape types, collision events, triggers, layers, sub-shapes, one-way platforms, gravity override, joints
  • 🏃 Kinematic Character Controller — KinematicCharacterBody with MoveAndSlide, MoveAndCollide, IsGrounded, moving platforms, snap, slope lock, step climbing
  • 🔍 Physics queries — OverlapCircle, Raycast, IgnoreCollision on PhysicsWorld

See Full Changelog

Release History

Version Release Date Highlights
v0.9.7-beta 2026 Input actions, Box2D physics, kinematic character
v0.9.6-beta 2026 Complete audio overhaul, post-processing effects
v0.9.5-beta 2026 Single package, framework properties, asset pipeline
v0.9.0-beta Jan 2026 Package separation, track-based audio, .NET 10
v0.8.0-beta Dec 2025 Particle textures, spatial audio, texture atlasing
v0.7.0-beta Nov 2025 GPU renderer, post-processing, EventBus
v0.6.0-beta Oct 2025 Scene transitions, UI framework, collision system

Version Support

Version Status .NET
v0.9.7-beta ✅ Latest .NET 10
v0.9.6-beta ⚠ī¸ Maintenance .NET 10
v0.9.5-beta ⚠ī¸ Maintenance .NET 10
v0.9.0-beta ❌ End of life .NET 10
v0.8.0 and earlier ❌ End of life —

Breaking Changes Log

v0.9.7

  • Physics: Old manual CollisionSystem / Collider / SpatialGrid removed — use PhysicsBodyComponent + Box2DPhysicsSystem
  • Input layers: InputLayerManager.CreateLayer() removed — implement IInputLayer and call RegisterLayer() / UnregisterLayer()
  • Input enum: Key.Return corrected to Key.Enter

v0.9.6

  • Audio: PlaySound() now returns nint track handle (was int channel)
  • Audio: StopChannel(int) → StopTrack(nint), PauseChannel(int) → PauseTrack(nint), IsChannelPlaying(int) → IsTrackAlive(nint)

v0.9.5

  • Packages: Consolidated into single Brine2D package (no more Brine2D.SDL)
  • Builder: AddSDL3Rendering() / AddSDL3Input() / AddSDL3Audio() → builder.Configure()
  • Scenes: IRenderer, IInputContext, IAudioPlayer removed from constructors — use framework properties
  • Lifecycle: OnInitializeAsync removed — use OnLoadAsync
  • Input enum: Keys → Key
  • Component: OnUpdate(GameTime) removed — use Behavior
  • Entity.Id: Guid → long
  • Scene transition: LoadSceneAsync → LoadScene (void, fire-and-forget)

v0.9.0

  • Audio: PlaySound() returns nint (from int)
  • Packages: Split into Brine2D and Brine2D.SDL

v0.8.0

  • Scenes: Constructor injection changed — Logger, World, Renderer now properties
  • ECS: World is a framework property, not injected

v0.7.0

  • Rendering: SDL3GPURenderer introduced as a separate backend
  • EventBus: Moved from Brine2D.ECS to Brine2D.Core

Release Philosophy

Brine2D follows Semantic Versioning:

  • Major (1.0, 2.0) — Breaking changes
  • Minor (0.9, 0.10) — New features, may include breaking changes in beta
  • Patch (0.9.1, 0.9.2) — Bug fixes only, no breaking changes

Beta Phase (Current)

  • APIs may change between releases
  • Major features still being added
  • Performance improvements ongoing
  • Community feedback shapes direction

Stable Phase (v1.0+)

  • No breaking changes without major version bump
  • Long-term support for each major version
  • Predictable release schedule
  • Production-ready stability

Get Notified

See a specific version: v0.9.7 | v0.9.6 | v0.9.5 | v0.9.0 | v0.8.0 | v0.7.0 | v0.6.0