OptCraft

# OptiCraft Description OptiCraft is a **client-side Fabric performance mod** focused on improving FPS stability, lowering stutter, and reducing unnecessary CPU/memory overhead in common gameplay scenarios. It uses a **modular optimization system** so each performance feature can be toggled independently. You can run it in safe mode, tune individual modules, or enable aggressive presets for higher performance. ## Core Focus Areas - **Rendering:** skips duplicate chunk rebuild scheduling where safe. - **Client Tick:** reduces repeated allocations in hot per-tick logic. - **Entity Handling:** caches repeated client entity lookups to reduce redundant work. - **Memory:** canonicalizes repeated `Identifier` objects with an LRU cache. - **IO:** uses async handling for non-critical tasks (like debounced config saves/resource sampling). - **Networking:** reduces packet-path allocations with identifier canonicalization. ## Advanced Modes - **Compatibility Mode:** disables high/extreme risk patches for maximum mod compatibility. - **Maximum Performance Mode:** enables and tunes all major optimizations automatically. - **Ultra Aggressive Mode:** pushes cache and dedupe settings further. - **Unsafe Extreme Mode:** enables invasive FPS-first patches (particle budget limiting and short-window sound dedupe). ## Configuration + UX - Full in-game config UI via **Cloth Config** (when installed). - **Mod Menu** integration for one-click config access. - Fallback config screen if Cloth Config is missing. - Built-in debug overlay with module state + optimization counters. ## Compatibility - Fabric client mod. - Java 17+. - Universal best-effort jar targeting **Minecraft 1.20.1+** with runtime-gated mixins.