SciCraft/docs/performance.md
MiTHRAL ae0ede6c28
All checks were successful
Build & Release Pack / build (push) Successful in 1m46s
SCICRAFT — The Dark Photon Protocol v1.0.0
NeoForge 1.21.1 (21.1.248) packwiz pack: client + server packs, story
system (KubeJS/FTB Quests), patched World Portal & Create Ore Excavation,
performance presets, and ops tooling. Clean-history import for v1.0.0.
2026-08-24 14:27:31 -04:00

2.6 KiB

Performance — Client

Three drop-in tiers are provided: Low, Medium, and High. The Medium tier ships as the pack default (matches a Ryzen 5 5600X / 16-32 GB RAM / RX 580 8 GB machine). Full details and copy commands live in presets/README.md.

Tier Target Shaders Render distance Key trade-offs
Low 4 GB VRAM / iGPU Off 4-6 Minimal effects, most CPU headroom
Medium 8 GB VRAM (RX 580-class) On (Complementary, Performance) 8 Balanced 60 FPS — default
High 8 GB+ VRAM (RTX 3060+) On (Complementary, Ultra) 10-12 Max visual quality

Applying a tier

# client configs → instance config dir
cp -r presets/low/config/* ~/.local/share/PrismLauncher/instances/<instance>/minecraft/config/

Restart the game after copying. See presets/README.md for the full file map.

What each tier changes

Config Low Medium High
Sodium chunk threads 1 auto auto
Sodium cpu render-ahead 1 3 4
Sodium quality FAST DEFAULT DEFAULT
Iris shaders off on, shadow 32 on, shadow 64
Dynamic lights simple fancy fancy (max)
Entity culling distance 64 128 192
Sound reverb rays 16 24 32
Flywheel backend BATCHING INSTANCING INSTANCING

Shader tuning (Complementary Reimagined r5.4)

Shader loader is Iris (native NeoForge). Recommended shaderpack: Complementary Reimagined r5.4 (client_pack/shaderpacks/, see README).

In-game (Esc → Options → Shader Packs → Complementary → Shader Pack Settings):

Medium (8 GB VRAM)

  • Preset: Fast / Performance
  • Antialiasing: OFF, SSAO: Fast, Shadow Quality 1.0x
  • Shadow Distance: 64, Bloom: Low, Clouds: 2D Fast
  • Water Reflections: Screenspace Fast, Colored Light: OFF

High (8 GB+ VRAM)

  • Preset: High / Default
  • Antialiasing: OFF or FXAA, SSAO: High, Shadow Quality 1.5x
  • Shadow Distance: 128, Bloom: On, Clouds: 3D
  • Water Reflections: Screenspace, Colored Light: On

Low (no shaders, or "Potato")

  • Play with shaders off (Iris enableShaders=false).
  • If you want them on, use Complementary "Potato/Ultra" preset, shadows OFF.

If FPS is still low, lower Shadow Quality / disable Bloom before touching render distance.

Reload rules

  • Server scripts / recipes / advancements: /reload
  • Client tooltips / JEI / textures / lang: F3+T
  • New items/blocks (registry_blocks.js): full restart
  • Config files (Sodium, Iris, etc.): full restart