# noahdunnagan/mcopt architecture

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

- Interactive diagram: https://gitdiagram.com/noahdunnagan/mcopt
- Repository: https://github.com/noahdunnagan/mcopt

## Overview

mcopt is an alpha Minecraft performance mod for Apple Silicon. The player runs Minecraft with Sodium; mcopt can select a hardware-aware performance profile and improve rendering and world processing. Its Metal backend and CPU, chunk, and startup optimizations are distinct runtime areas. Far terrain is an experimental opt-in: the Lod subsystem manages distant terrain, with tile and native-code components represented separately. The excerpts show selected implementation links; README statements support the documented product capabilities. Unsampled subsystems are included where the README and tree establish their role, but uncertain internal links are omitted.

Main entry points: [`metal/src/main/java/mcopt/metal/lod/Lod.java`](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/lod/Lod.java) (Far Terrain Manager), [`metal/src/main/java/mcopt/metal/lod/LodNative.java`](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/lod/LodNative.java) (LOD Native Code), [`metal/src/main/java/mcopt/metal/Native.java`](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/Native.java) (Native Bindings), [`metal/src/main/java/mcopt/metal/chunk/ChunkOpt.java`](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/chunk/ChunkOpt.java) (Chunk Optimizations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_render["Rendering"]
  node_metal_backend["Metal Backend<br/>[MetalBackend.java]"]
  node_metal_bridge["Metal Bridge<br/>[MetalBridge.java]"]
  node_metal_encoder["Command Encoder<br/>[MetalEncoder.java]"]
  node_metal_pipeline["Pipeline Creation<br/>[MetalPipeline.java]"]
  node_native_bindings["Native Bindings<br/>[Native.java]"]
  node_frame_gen["Frame Generation<br/>[FrameGen.java]"]
  node_metal_fx["Metal Effects<br/>[MetalFx.java]"]
end

subgraph group_integration["Game Integration"]
  node_fps_hud["FPS Counter<br/>[HudMixin.java]"]
  node_profile["Performance Profile<br/>[Profile.java]"]
  node_startup["Startup Optimization<br/>[Startup.java]"]
end

subgraph group_world["World Optimizations"]
  node_cpu_opt["CPU Render Optimizations<br/>[Cpu.java]"]
  node_cull_reuse["Cull Reuse<br/>[CullReuse.java]"]
  node_chunk_opt["Chunk Optimizations<br/>[ChunkOpt.java]"]
  node_region_save["Region Save Hook"]
  node_light_snapshots["Light Snapshots"]
end

subgraph group_far["Far Terrain"]
  node_lod_controller["Far Terrain Manager<br/>[Lod.java]"]
  node_lod_field["Terrain Tile Field<br/>[LodField.java]"]
  node_lod_native["LOD Native Code<br/>[LodNative.java]"]
  node_lod_mesh_c["Native Mesh Code<br/>[lodmesh.c]"]
  node_lod_noise_c["Native Noise Code<br/>[lodnoise.c]"]
end

node_minecraft(("Minecraft + Sodium"))

node_minecraft -.->|"uses optionally"| node_metal_backend
node_minecraft -->|"displays"| node_fps_hud
node_minecraft -->|"configures"| node_profile
node_minecraft -->|"optimizes startup"| node_startup
node_metal_bridge -->|"calls"| node_native_bindings
node_metal_encoder -->|"calls"| node_native_bindings
node_metal_pipeline -->|"creates libraries"| node_native_bindings
node_minecraft -.->|"enables rendering"| node_frame_gen
node_minecraft -->|"applies effects"| node_metal_fx
node_minecraft -->|"optimizes rendering"| node_cpu_opt
node_cpu_opt -->|"supports culling"| node_cull_reuse
node_minecraft -->|"optimizes chunks"| node_chunk_opt
node_region_save -->|"checks save policy"| node_chunk_opt
node_light_snapshots -->|"checks statistics"| node_chunk_opt
node_minecraft -->|"opts into far terrain"| node_lod_controller
node_lod_controller -->|"manages tiles"| node_lod_field
node_lod_controller -->|"uses native support"| node_lod_native
node_lod_native -.->|"uses mesh code"| node_lod_mesh_c
node_lod_native -.->|"uses noise code"| node_lod_noise_c

click node_metal_backend "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalBackend.java"
click node_metal_bridge "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalBridge.java"
click node_metal_encoder "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalEncoder.java"
click node_metal_pipeline "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalPipeline.java"
click node_native_bindings "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/Native.java"
click node_frame_gen "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/FrameGen.java"
click node_metal_fx "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalFx.java"
click node_fps_hud "https://github.com/noahdunnagan/mcopt/blob/main/fpshud/src/main/java/mcopt/fps/mixin/HudMixin.java"
click node_profile "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/Profile.java"
click node_startup "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/Startup.java"
click node_cpu_opt "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/cpu/Cpu.java"
click node_cull_reuse "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/cpu/CullReuse.java"
click node_chunk_opt "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/chunk/ChunkOpt.java"
click node_region_save "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/mixin/chunk/RegionFileStorageMixin.java"
click node_light_snapshots "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/mixin/chunk/DataLayerStorageMapMixin.java"
click node_lod_controller "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/lod/Lod.java"
click node_lod_field "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/lod/LodField.java"
click node_lod_native "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/lod/LodNative.java"
click node_lod_mesh_c "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/native/lodmesh.c"
click node_lod_noise_c "https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/native/lodnoise.c"

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_metal_backend,node_metal_bridge,node_metal_encoder,node_metal_pipeline,node_native_bindings,node_frame_gen,node_metal_fx toneBlue
class node_fps_hud,node_profile,node_startup toneAmber
class node_cpu_opt,node_cull_reuse,node_chunk_opt,node_region_save,node_light_snapshots toneMint
class node_lod_controller,node_lod_field,node_lod_native,node_lod_mesh_c,node_lod_noise_c toneRose
class node_minecraft toneIndigo
```

## Components

### Rendering

- [Metal Backend](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalBackend.java): `metal/src/main/java/mcopt/metal/MetalBackend.java`
- [Metal Bridge](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalBridge.java): `metal/src/main/java/mcopt/metal/MetalBridge.java`
- [Command Encoder](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalEncoder.java): `metal/src/main/java/mcopt/metal/MetalEncoder.java`
- [Pipeline Creation](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalPipeline.java): `metal/src/main/java/mcopt/metal/MetalPipeline.java`
- [Native Bindings](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/Native.java): `metal/src/main/java/mcopt/metal/Native.java`
- [Frame Generation](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/FrameGen.java): `metal/src/main/java/mcopt/metal/FrameGen.java`
- [Metal Effects](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/MetalFx.java): `metal/src/main/java/mcopt/metal/MetalFx.java`

### Game Integration

- [FPS Counter](https://github.com/noahdunnagan/mcopt/blob/main/fpshud/src/main/java/mcopt/fps/mixin/HudMixin.java): `fpshud/src/main/java/mcopt/fps/mixin/HudMixin.java`
- [Performance Profile](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/Profile.java): `metal/src/main/java/mcopt/metal/Profile.java`
- [Startup Optimization](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/Startup.java): `metal/src/main/java/mcopt/metal/Startup.java`

### World Optimizations

- [CPU Render Optimizations](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/cpu/Cpu.java): `metal/src/main/java/mcopt/metal/cpu/Cpu.java`
- [Cull Reuse](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/cpu/CullReuse.java): `metal/src/main/java/mcopt/metal/cpu/CullReuse.java`
- [Chunk Optimizations](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/chunk/ChunkOpt.java): `metal/src/main/java/mcopt/metal/chunk/ChunkOpt.java`
- [Region Save Hook](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/mixin/chunk/RegionFileStorageMixin.java): `metal/src/main/java/mcopt/metal/mixin/chunk/RegionFileStorageMixin.java`
- [Light Snapshots](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/mixin/chunk/DataLayerStorageMapMixin.java): `metal/src/main/java/mcopt/metal/mixin/chunk/DataLayerStorageMapMixin.java`

### Far Terrain

- [Far Terrain Manager](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/lod/Lod.java): `metal/src/main/java/mcopt/metal/lod/Lod.java`
- [Terrain Tile Field](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/lod/LodField.java): `metal/src/main/java/mcopt/metal/lod/LodField.java`
- [LOD Native Code](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/java/mcopt/metal/lod/LodNative.java): `metal/src/main/java/mcopt/metal/lod/LodNative.java`
- [Native Mesh Code](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/native/lodmesh.c): `metal/src/main/native/lodmesh.c`
- [Native Noise Code](https://github.com/noahdunnagan/mcopt/blob/main/metal/src/main/native/lodnoise.c): `metal/src/main/native/lodnoise.c`

### Other components

- **Minecraft + Sodium**

## Connections

- Minecraft + Sodium → Metal Backend: uses optionally
- Minecraft + Sodium → FPS Counter: displays
- Minecraft + Sodium → Performance Profile: configures
- Minecraft + Sodium → Startup Optimization: optimizes startup
- Metal Bridge → Native Bindings: calls (evidence: `metal/src/main/java/mcopt/metal/MetalBridge.java`)
- Command Encoder → Native Bindings: calls (evidence: `metal/src/main/java/mcopt/metal/MetalEncoder.java`)
- Pipeline Creation → Native Bindings: creates libraries (evidence: `metal/src/main/java/mcopt/metal/MetalPipeline.java`)
- Minecraft + Sodium → Frame Generation: enables rendering
- Minecraft + Sodium → Metal Effects: applies effects
- Minecraft + Sodium → CPU Render Optimizations: optimizes rendering
- CPU Render Optimizations → Cull Reuse: supports culling (evidence: `metal/src/main/java/mcopt/metal/cpu/CullReuse.java`)
- Minecraft + Sodium → Chunk Optimizations: optimizes chunks
- Region Save Hook → Chunk Optimizations: checks save policy (evidence: `metal/src/main/java/mcopt/metal/mixin/chunk/RegionFileStorageMixin.java`)
- Light Snapshots → Chunk Optimizations: checks statistics (evidence: `metal/src/main/java/mcopt/metal/mixin/chunk/DataLayerStorageMapMixin.java`)
- Minecraft + Sodium → Far Terrain Manager: opts into far terrain
- Far Terrain Manager → Terrain Tile Field: manages tiles (evidence: `metal/src/main/java/mcopt/metal/lod/Lod.java`)
- Far Terrain Manager → LOD Native Code: uses native support (evidence: `metal/src/main/java/mcopt/metal/lod/Lod.java`)
- LOD Native Code → Native Mesh Code: uses mesh code
- LOD Native Code → Native Noise Code: uses noise code
