How otb2124/ossianforge works
OssianForge is a data-driven C# 3D game engine. Game authors define scenes, actions, input bindings, and state machines as content; at runtime, the app initializes the engine, loads resources and builds the node tree, then updates physics/input and renders the scene. The node/property model is the central gameplay layer, with reflection-based dispatch connecting configured actions to behavior. The README documents major capabilities not visible in sampled implementations; those are represented at subsystem level. Edges are limited to relationships shown in excerpts, the source index, or README statements.
Main entry points: Engine.cs Engine lifecycle · Resources.cs Resource manager · Config Content configs · Nodes.cs Node tree
Components 26
Runtime orchestration
- Application
App/App.cs - Engine lifecycle
Engine/Engine.cs - Debug console
Engine/Utils/Console/DebugConsole.cs
Content and dispatch
- Resource manager
Engine/Resources/Resources.cs - Resource loading
Engine/Resources/Load - Content configs
Engine/Resources/Types/Config - Action dispatcher
Engine/Reflection/ReflectionDispatcher.cs - Script packs
Content/ScriptFiles
Scene and behavior
- Scene and tree configs
Engine/Resources/Types/Config - Node tree
Engine/Nodes/Nodes.cs - Node manager
Engine/Nodes/NodeManager.cs - Node and properties
Engine/Nodes/Node.cs - Transforms
Engine/Nodes/Props/Types/Transform/TransformProperty.cs - Gameplay properties
Engine/Nodes/Props/Types
Engine systems
- Input system
Engine/Inputs/Inputs.cs - Physics worlds
Engine/Physics/Physics.cs - Audio playback
Engine/Audio/Audio.cs - UI interaction
Engine/UI/UI.cs
Presentation
- Graphics and window
Engine/Graphics/Graphics.cs - Mesh batching
Engine/Graphics/Batch/Batch.cs - Mesh resources
Engine/Resources/Types/Meshes/MeshResource.cs - Post-processing
Engine/Graphics/RenderTarget/PostProcessStack.cs
Other components
- Game author
- OpenGL
- Jitter2
- OpenAL
Connections 28
- Game author → Content configs: authors data
- Application → Engine lifecycle: drives lifecycle
App/App.cs - Engine lifecycle → Graphics and window: initializes and renders
Engine/Engine.cs - Engine lifecycle → Resource manager: loads resources
Engine/Engine.cs - Engine lifecycle → Node tree: updates nodes
Engine/Engine.cs - Engine lifecycle → Input system: updates input
Engine/Engine.cs - Engine lifecycle → Physics worlds: updates physics
Engine/Engine.cs - Engine lifecycle → Audio playback: initializes audio
Engine/Engine.cs - Engine lifecycle → UI interaction: updates and renders
Engine/Engine.cs - Engine lifecycle → Debug console: starts console
Engine/Engine.cs - Resource manager → Resource loading: delegates loading
Engine/Resources/Resources.cs - Resource loading → Content configs: loads typed content
Engine/Resources/Load/NodeDependency.cs - Resource manager → Action dispatcher: executes actions
Engine/Reflection/ReflectionDispatcher.cs - Resource manager → Script packs: creates script instances
Engine/Resources/Resources.cs - Node tree → Resource manager: reads tree and scene
Engine/Nodes/Nodes.cs - Node tree → Node manager: registers and updates
Engine/Nodes/Nodes.cs - Node manager → Node and properties: walks node tree
Engine/Nodes/NodeManager.cs - Node and properties → Gameplay properties: updates properties
Engine/Nodes/Node.cs - Node and properties → Transforms: attaches transform
Engine/Nodes/Props/Types/Transform/TransformProperty.cs - Input system → Content configs: reads bindings
Engine/Inputs/KeyHandler.cs - Graphics and window → Mesh batching: renders batches
Engine/Graphics/Graphics.cs - Mesh batching → Mesh resources: draws meshes
Engine/Graphics/Batch/Batch.cs - Graphics and window → Post-processing: uses post stack
Engine/Graphics/Graphics.cs - Mesh batching → OpenGL: draws via
- Physics worlds → Jitter2: integrates physics
- Audio playback → OpenAL: plays through
- Scene and tree configs → Content configs: defines scene data
- Gameplay properties → Action dispatcher: invokes configured actions