How noahdunnagan/mcopt works
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: Lod.java Far Terrain Manager · LodNative.java LOD Native Code · Native.java Native Bindings · ChunkOpt.java Chunk Optimizations
Components 21
Rendering
- Metal Backend
metal/src/main/java/mcopt/metal/MetalBackend.java - Metal Bridge
metal/src/main/java/mcopt/metal/MetalBridge.java - Command Encoder
metal/src/main/java/mcopt/metal/MetalEncoder.java - Pipeline Creation
metal/src/main/java/mcopt/metal/MetalPipeline.java - Native Bindings
metal/src/main/java/mcopt/metal/Native.java - Frame Generation
metal/src/main/java/mcopt/metal/FrameGen.java - Metal Effects
metal/src/main/java/mcopt/metal/MetalFx.java
Game Integration
- FPS Counter
fpshud/src/main/java/mcopt/fps/mixin/HudMixin.java - Performance Profile
metal/src/main/java/mcopt/metal/Profile.java - Startup Optimization
metal/src/main/java/mcopt/metal/Startup.java
World Optimizations
- CPU Render Optimizations
metal/src/main/java/mcopt/metal/cpu/Cpu.java - Cull Reuse
metal/src/main/java/mcopt/metal/cpu/CullReuse.java - Chunk Optimizations
metal/src/main/java/mcopt/metal/chunk/ChunkOpt.java - Region Save Hook
metal/src/main/java/mcopt/metal/mixin/chunk/RegionFileStorageMixin.java - Light Snapshots
metal/src/main/java/mcopt/metal/mixin/chunk/DataLayerStorageMapMixin.java
Far Terrain
- Far Terrain Manager
metal/src/main/java/mcopt/metal/lod/Lod.java - Terrain Tile Field
metal/src/main/java/mcopt/metal/lod/LodField.java - LOD Native Code
metal/src/main/java/mcopt/metal/lod/LodNative.java - Native Mesh Code
metal/src/main/native/lodmesh.c - Native Noise Code
metal/src/main/native/lodnoise.c
Other components
- Minecraft + Sodium
Connections 19
- 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
metal/src/main/java/mcopt/metal/MetalBridge.java - Command Encoder → Native Bindings: calls
metal/src/main/java/mcopt/metal/MetalEncoder.java - Pipeline Creation → Native Bindings: creates libraries
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
metal/src/main/java/mcopt/metal/cpu/CullReuse.java - Minecraft + Sodium → Chunk Optimizations: optimizes chunks
- Region Save Hook → Chunk Optimizations: checks save policy
metal/src/main/java/mcopt/metal/mixin/chunk/RegionFileStorageMixin.java - Light Snapshots → Chunk Optimizations: checks statistics
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
metal/src/main/java/mcopt/metal/lod/Lod.java - Far Terrain Manager → LOD Native Code: uses native support
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