OxHeart - Game Framework for Unity

OxHeart is a modular Unity 6 game-development framework that gives you production-grade versions of the systems every game rebuilds from scratch without locking you into a genre or art style.

Toggle services on or off. Extend the engine with your own game services. Ship on desktop and mobile with IL2CPP-safe patterns and docs written for real projects.

IMPORTANT COMPATIBILITY NOTICE

OxHeart requires Unity 6000.0 or newer.

Before importing the Asset Store .unitypackage, ensure Newtonsoft JSON 3.2.1 or newer, Addressables 2.9.1 or newer, and uGUI 2.0.0 or newer are installed through Package Manager. Asset Store .unitypackage imports cannot install these dependencies automatically.

OxHeart supports the Built-in Render Pipeline, URP, and HDRP on Windows, macOS, Linux, iOS, and Android. WebGL is not supported.

OxHeart includes no analytics backend and sends no telemetry by itself. The optional analytics abstraction is disabled by default.

The package includes original procedurally generated sample audio dedicated to CC0 1.0. See the bundled Third Party Notices.md file for details.

See Technical Details below for complete requirements, platform limitations, IL2CPP guidance, and package contents.

Why OxHeart?

⚡ MODULAR BY DESIGN
Enable only what you need through ServiceConfiguration assets. Use a minimal core for prototypes or enable the full service stack for production.

🏗 CLEAN, EXTENSIBLE ARCHITECTURE
Services are accessed through documented interfaces such as IAudioService, ISaveSystem, IEventManager, and ISceneService. Game-specific services can be registered through an automatically discovered IServiceRegistrar.

🌀 CUSTOM SERVICE LIFECYCLE
RegisterManaged lets custom services participate in OxHeart's LateInitialize and Shutdown lifecycle without requiring changes to the engine.

🚀 RESOURCES AND ADDRESSABLES
Use Resources immediately with the shipped configuration, then enable Addressables when your project is ready. OxHeart supports asynchronous loading, AssetReference APIs, memory budgeting, release tracking, and fallback behavior.

💾 PRODUCTION-READY PERSISTENCE
The save system supports asynchronous operations, multiple slots, auto-save, quick-save, compression, encryption, schema migrations, corrupt-file quarantine, and pluggable ISaveStore backends.
A built-in editor validator identifies save data shapes that IL2CPP managed stripping could silently remove.

🎮 DETERMINISTIC GAMEPLAY
Named deterministic RNG streams, saved RNG snapshots, weighted rolls, anti-pity probability helpers, typed pool bags, and an IL2CPP safe ModelDb content registry support reproducible gameplay and testing.

🔊 AUDIO THAT SCALES
Audio tracks, source pooling, fades, 3D audio, mixer support, and a Music Playlist Service with sequential and shuffle playback, preload lookahead, crossfades, per-track gain, and now playing metadata.

📜 LOCALIZATION AND DIAGNOSTICS
CSV localization tables, runtime language switching, LocString formatting, DynamicVar substitution, pluralization, localized asset references, and fallback languages.
The editor only Localization Health Scanner detects malformed tables, missing translations, placeholder mismatches, fallback cycles, pluralization gaps, configuration problems, and broken localized asset references.

📊 BACKEND-AGNOSTIC ANALYTICS
IAnalyticsService provides one optional telemetry call site without coupling game code to a specific provider. OxHeart includes no analytics provider and sends no telemetry by itself. Analytics is disabled by default.

🔬 INSPECTOR PRODUCTIVITY
Add [OxButton] to a parameterless MonoBehaviour or ScriptableObject method to display it as an Inspector button without writing a custom editor. Private methods, custom labels, Undo, inheritance, and multi object editing are supported.

⚖️ LEGAL AND RELEASE TOOLING
Generate consolidated Third Party Notices, deterministic compliance manifests, and concise credits for resolved UPM packages.
Optional build policies can warn or fail when a package license is unknown or the accepted compliance manifest has changed.


Key features

Service lifecycle, initialization, and dependency ordering
Setup Wizard with default and minimal configuration presets
Type-safe pooled event bus with safe listener dispatch
Resources and optional Addressables integration
Object pooling with pre warming and statistics
Multi-track audio, fades, 3D playback, and source pooling
Music playlists with crossfades and now-playing metadata
Multi-slot save/load, auto-save, migration, and quarantine
CSV localization with runtime language switching
Localization Health Scanner
Optional backend-agnostic analytics abstraction
Scene Management with asynchronous loading, progress, fades, and Addressables support
Game Settings for quality, resolution, fullscreen mode, vsync, and target frame rate
Safe resolution confirmation and automatic rollback
Time channels, global pause, timers, and scheduling
Extensible game state management
Categorized notifications with priority, duration, and a default toast presenter
Deterministic RNG streams and saved snapshots
IL2CPP-safe ModelDb content registry
TypedPoolBag, AbstractOdds, and AntiPityOdds utilities
Sink-based OxLogger and game facing GameLogger
[OxButton] Inspector attribute
Save-type and setup validation tools
Third-Party Notices and Release Compliance tooling
IServiceRegistrar and RegisterManaged extensibility


What's Included

Four runtime assemblies
Editor tooling and default configuration assets
14 importable sample groups
15 playable sample scenes
Core Script Examples numbered 01 through 14, including Analytics and OxButton examples
Per-system documentation, architecture decisions, setup guides, troubleshooting, and a complete packaged changelog


Important scope notes

OxHeart is game infrastructure, not a complete RPG, FPS, RTS, or other genre template. You provide the gameplay, art, project-specific UI, controls, and scenes.
OxHeart does not include networking, multiplayer, a cloud-save adapter, an input service, a tweening library, or a general-purpose UI framework.
The Input System package is optional. OxHeart does not read player input, and its samples adapt to the input backend available in the project.
OxHeart includes no AI model, inference runtime, or AI-service integration.
Release Compliance is convenience tooling, not legal advice. It covers resolved UPM-package dependencies and does not replace review of loose Assets licenses, trademarks, marketing disclosures, external services, or other legal obligations.

Complete compatibility, dependency, IL2CPP, platform, input, licensing, and compliance limitations are listed under Technical Details.

LEARN MORE AND SUPPORT

Documentation:
https://oxheart.moomoo.games/latest/

Architecture guide:
https://oxheart.moomoo.games/latest/Architecture/

Development logs:
https://moomoo.games/#/devlog

Support:
[email protected]

Website:
https://moomoo.games

When reporting an issue, include your Unity version, OxHeart version, target platform, and steps to reproduce.