🌌 OSK Framework

May 19, 2026 · View on GitHub

OSK Framework is a lightweight, modular, and high-performance Unity architectural framework designed for professional game development. It features zero runtime GC allocations in core loops, an isolated Multi-Canvas UI system, and a modern MVVM-like Universal Data Binding engine.

🌟 Key Features & Sub-Managers

Click on any module to view its detailed documentation, API reference, code examples, and performance guidelines:

  1. ⏱️ Centralized Tick System (MonoManager) — centralizes Update, FixedUpdate, and LateUpdate loops to eliminate native C++/C# boundaries.
  2. 📦 Object Pooling (PoolManager) — high-performance O(1)O(1) object and component recycling system with IPoolable callbacks.
  3. ✉️ Event Bus System (EventBusManager) — decoupled, type-safe global publish-subscribe event hub.
  4. 🔊 Sound Manager (SoundManager) — handles BGM, SFX, UI audio, cross-fade transitions, and automatic volume persistence.
  5. 🎨 UI Manager & UniversalBinder (UIManager) — multi-canvas layout isolation (Screen, Popup, Notif, Overlay, Lock) coupled with a zero-reflection MVVM Data Binding engine.
  6. 💾 Local Storage (DataManager) — encrypted game save storage and optimized PlayerPrefs alternatives.
  7. 🔀 Game FSM (ProcedureManager) — structured game loop flow states using finite state machine nodes.
  8. 🌐 Localization System (LocalizationManager) — multi-language translation and dynamic language swapping.
  9. 📓 Shared Blackboard (BlackboardManager) — key-value database for AI decision-making (Behavior Trees) and shared parameters.
  10. 🛠️ Utility Managers (Command, Observer, Director, Resources...) — auxiliary managers for scene transitions, Undo/Redo commands, resource caching, and input handling.

🚀 Quick Start

1. Prerequisites & Dependencies

Ensure the following packages/assets are installed:

2. Setup Framework

  1. In the Unity Editor top menu, go to: Window ➔ OSK-Framework ➔ CreateFramework.
  2. Select the Main singleton in the hierarchy.
  3. In the Inspector, navigate to Main Modules, select the managers you require, and click "Sync Modules (Hierarchy)" to automatically generate the module tree in your scene.

⚡ Core Performance Guidelines

  • Zero GC Spawning: Avoid instantiating entities or particle effects. Recycle them using the PoolManager.
  • Avoid Update Loops: Centralize updates in game loops using the Centralized Tick System to save CPU instructions.
  • Layout Rebuild Isolation: Keep dynamic UI elements inside independent canvases to limit canvas redrawing, as detailed in the UIManager Guide.

📞 Support & Community