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

67 lines
2.6 KiB
Markdown

# 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
```bash
# 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**