# raredeveloperofficials/rareenginenative architecture

> Architecture diagram of the GitHub repository raredeveloperofficials/rareenginenative, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raredeveloperofficials/rareenginenative
- Repository: https://github.com/raredeveloperofficials/rareenginenative

## Overview

RareEngineNative is an Android-hosted C++ game engine. Its visible workflow is an Android surface being attached through JNI, then driven by a native render loop that draws a scene of game objects and behaviors through a graphics backend. The README is only a brief product description; source excerpts and the index support the core rendering path, but do not establish broader asset or input systems.

Main entry points: [`Rare Engine/app/src/main/jni/Main.cpp`](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/Main.cpp) (Native surface bridge), [`Rare Engine/app/src/main/jni/rareengine/core/Renderer.cpp`](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Renderer.cpp) (Renderer), [`Rare Engine/app/src/main/jni/rareengine/core/GameObject.cpp`](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/GameObject.cpp) (Game objects), [`Rare Engine/app/src/main/jni/rareengine/core/Engine.cpp`](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Engine.cpp) (Engine state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android Host"]
  node_activity["Main activity<br/>[MainActivity.java]"]
  node_application["Application lifecycle"]
  node_gameview["Game surface<br/>[GameView.java]"]
  node_jni["JNI attachment<br/>[JniAttachment.java]"]
end

subgraph group_runtime["Native Runtime"]
  node_bridge["Native surface bridge<br/>[Main.cpp]"]
  node_rendererloop["EGL render loop<br/>[Main.cpp]"]
  node_engine["Engine state<br/>[Engine.cpp]"]
  node_vector["Vector math<br/>[Vector4.cpp]"]
end

subgraph group_scene["Scene Model"]
  node_scene["Scene<br/>[Scene.cpp]"]
  node_gameobject["Game objects<br/>[GameObject.cpp]"]
  node_behaviour["Behaviour base<br/>[Behaviour.cpp]"]
  node_transform["Transform behaviour"]
  node_renderbehaviour["Render behaviours"]
  node_modelrender["Model rendering"]
end

subgraph group_graphics["Graphics"]
  node_renderer["Renderer<br/>[Renderer.cpp]"]
  node_backend["Graphics backend<br/>[GraphicsBackend.h]"]
  node_opengl["OpenGL backend<br/>[OpenGLBackend.cpp]"]
  node_shaders["Shader templates<br/>[EngineShaders.h]"]
end

node_user(("Android user"))

node_user -->|"opens app"| node_activity
node_activity -->|"shows surface"| node_gameview
node_gameview -->|"reports surface"| node_jni
node_jni -->|"calls native methods"| node_bridge
node_bridge -->|"starts thread"| node_rendererloop
node_rendererloop -->|"draws frames"| node_renderer
node_bridge -->|"creates renderer"| node_renderer
node_bridge -->|"creates test scene"| node_scene
node_bridge -->|"logs events"| node_engine
node_renderer -->|"updates scene"| node_scene
node_scene -->|"updates objects"| node_gameobject
node_gameobject -->|"dispatches updates"| node_behaviour
node_gameobject -->|"uses transform"| node_transform
node_behaviour -->|"uses engine state"| node_engine
node_renderer -->|"issues graphics calls"| node_backend
node_engine -->|"initializes backend"| node_opengl
node_opengl -->|"implements interface"| node_backend
node_renderer -->|"builds programs"| node_shaders
node_modelrender -->|"extends rendering"| node_renderbehaviour
node_transform -->|"calculates transforms"| node_vector

click node_activity "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/java/com/raredeveloper/rareenginenative/MainActivity.java"
click node_application "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/java/com/raredeveloper/rareenginenative/GlobalApplication.java"
click node_gameview "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/java/RareEngine/android/GameView.java"
click node_jni "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/java/RareEngine/android/JniAttachment.java"
click node_bridge "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/Main.cpp"
click node_rendererloop "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/Main.cpp"
click node_engine "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Engine.cpp"
click node_scene "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Scene.cpp"
click node_gameobject "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/GameObject.cpp"
click node_behaviour "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Behaviour.cpp"
click node_transform "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Behaviours/TransformBehaviour.cpp"
click node_renderbehaviour "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Behaviours/RenderBehaviour.cpp"
click node_modelrender "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Behaviours/ModelRenderBehaviour.cpp"
click node_renderer "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Renderer.cpp"
click node_backend "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/headers/GraphicsBackend.h"
click node_opengl "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/OpenGLBackend.cpp"
click node_shaders "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/headers/EngineShaders.h"
click node_vector "https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Vector4.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity,node_application,node_gameview,node_jni,node_user toneBlue
class node_bridge,node_rendererloop,node_engine,node_vector toneAmber
class node_scene,node_gameobject,node_behaviour,node_transform,node_renderbehaviour,node_modelrender toneMint
class node_renderer,node_backend,node_opengl,node_shaders toneRose
```

## Components

### Android Host

- [Main activity](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/java/com/raredeveloper/rareenginenative/MainActivity.java): `Rare Engine/app/src/main/java/com/raredeveloper/rareenginenative/MainActivity.java`
- [Application lifecycle](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/java/com/raredeveloper/rareenginenative/GlobalApplication.java): `Rare Engine/app/src/main/java/com/raredeveloper/rareenginenative/GlobalApplication.java`
- [Game surface](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/java/RareEngine/android/GameView.java): `Rare Engine/app/src/main/java/RareEngine/android/GameView.java`
- [JNI attachment](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/java/RareEngine/android/JniAttachment.java): `Rare Engine/app/src/main/java/RareEngine/android/JniAttachment.java`

### Native Runtime

- [Native surface bridge](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/Main.cpp): `Rare Engine/app/src/main/jni/Main.cpp`
- [EGL render loop](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/Main.cpp): `Rare Engine/app/src/main/jni/Main.cpp`
- [Engine state](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Engine.cpp): `Rare Engine/app/src/main/jni/rareengine/core/Engine.cpp`
- [Vector math](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Vector4.cpp): `Rare Engine/app/src/main/jni/rareengine/core/Vector4.cpp`

### Scene Model

- [Scene](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Scene.cpp): `Rare Engine/app/src/main/jni/rareengine/core/Scene.cpp`
- [Game objects](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/GameObject.cpp): `Rare Engine/app/src/main/jni/rareengine/core/GameObject.cpp`
- [Behaviour base](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Behaviour.cpp): `Rare Engine/app/src/main/jni/rareengine/core/Behaviour.cpp`
- [Transform behaviour](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Behaviours/TransformBehaviour.cpp): `Rare Engine/app/src/main/jni/rareengine/core/Behaviours/TransformBehaviour.cpp`
- [Render behaviours](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Behaviours/RenderBehaviour.cpp): `Rare Engine/app/src/main/jni/rareengine/core/Behaviours/RenderBehaviour.cpp`
- [Model rendering](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Behaviours/ModelRenderBehaviour.cpp): `Rare Engine/app/src/main/jni/rareengine/core/Behaviours/ModelRenderBehaviour.cpp`

### Graphics

- [Renderer](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/Renderer.cpp): `Rare Engine/app/src/main/jni/rareengine/core/Renderer.cpp`
- [Graphics backend](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/headers/GraphicsBackend.h): `Rare Engine/app/src/main/jni/rareengine/headers/GraphicsBackend.h`
- [OpenGL backend](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/core/OpenGLBackend.cpp): `Rare Engine/app/src/main/jni/rareengine/core/OpenGLBackend.cpp`
- [Shader templates](https://github.com/raredeveloperofficials/rareenginenative/blob/main/Rare%20Engine/app/src/main/jni/rareengine/headers/EngineShaders.h): `Rare Engine/app/src/main/jni/rareengine/headers/EngineShaders.h`

### Other components

- **Android user**

## Connections

- Android user → Main activity: opens app
- Main activity → Game surface: shows surface (evidence: `Rare Engine/app/src/main/java/com/raredeveloper/rareenginenative/MainActivity.java`)
- Game surface → JNI attachment: reports surface (evidence: `Rare Engine/app/src/main/java/RareEngine/android/GameView.java`)
- JNI attachment → Native surface bridge: calls native methods (evidence: `Rare Engine/app/src/main/java/RareEngine/android/JniAttachment.java`)
- Native surface bridge → EGL render loop: starts thread (evidence: `Rare Engine/app/src/main/jni/Main.cpp`)
- EGL render loop → Renderer: draws frames (evidence: `Rare Engine/app/src/main/jni/Main.cpp`)
- Native surface bridge → Renderer: creates renderer (evidence: `Rare Engine/app/src/main/jni/Main.cpp`)
- Native surface bridge → Scene: creates test scene (evidence: `Rare Engine/app/src/main/jni/Main.cpp`)
- Native surface bridge → Engine state: logs events (evidence: `Rare Engine/app/src/main/jni/Main.cpp`)
- Renderer → Scene: updates scene (evidence: `Rare Engine/app/src/main/jni/rareengine/core/Renderer.cpp`)
- Scene → Game objects: updates objects (evidence: `Rare Engine/app/src/main/jni/rareengine/core/Scene.cpp`)
- Game objects → Behaviour base: dispatches updates (evidence: `Rare Engine/app/src/main/jni/rareengine/core/GameObject.cpp`)
- Game objects → Transform behaviour: uses transform (evidence: `Rare Engine/app/src/main/jni/rareengine/core/GameObject.cpp`)
- Behaviour base → Engine state: uses engine state (evidence: `Rare Engine/app/src/main/jni/rareengine/core/Behaviour.cpp`)
- Renderer → Graphics backend: issues graphics calls (evidence: `Rare Engine/app/src/main/jni/rareengine/core/Renderer.cpp`)
- Engine state → OpenGL backend: initializes backend (evidence: `Rare Engine/app/src/main/jni/rareengine/core/Engine.cpp`)
- OpenGL backend → Graphics backend: implements interface
- Renderer → Shader templates: builds programs (evidence: `Rare Engine/app/src/main/jni/rareengine/core/Renderer.cpp`)
- Model rendering → Render behaviours: extends rendering
- Transform behaviour → Vector math: calculates transforms
