SciCraft/presets/README.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

70 lines
2.8 KiB
Markdown

# Performance Presets — SCICRAFT
Three drop-in tiers for client (and server) tuning. The **Medium** tier is the
pack default — it ships inside the mrpack (`overrides/config/`) and matches a
Ryzen 5 5600X / 16-32 GB RAM / RX 580 8 GB class machine.
To use a different tier, copy the files from the matching folder into the
`.minecraft/config/` directory (client) and the pack's `server/` directory
(server), then restart.
## Tier targets
| Tier | CPU | RAM | GPU | Use case |
|------|-----|-----|-----|----------|
| **Low** | 4-core / older | 8-16 GB | 4 GB VRAM or iGPU | Integrated graphics, laptops, weak desktops |
| **Medium** | 6-8 core (5600X-class) | 16-32 GB | 8 GB VRAM (RX 580-class) | **Default. Balanced 60 FPS.** |
| **High** | 8+ core | 32 GB+ | 8 GB+ VRAM (RTX 3060+) | High FPS at high render distance / shaders |
## What's included per tier
### Client (`presets/<tier>/config/` → `.minecraft/config/`)
| File | Effect |
|------|--------|
| `sodium-options.json` | Terrain renderer: chunk threads, culling, quality |
| `iris.properties` | Shader loader: on/off, max shadow render distance |
| `lambdynlights.toml` | Dynamic lighting quality / adaptive ticking |
| `entityculling.json` | Entity/block-entity culling distance |
| `cullleaves.json` | Leaf culling on/off |
| `soundphysics.properties` | Reverb/ray budget (audio CPU cost) |
| `flywheel-client.toml` | Create/Flywheel render backend (batching vs instancing) |
> Note: `sodium-mixins.properties` is left at default on all tiers. Hand-editing
> Sodium mixin flags can cause crashes, so we tune the safe, supported options
> (`sodium-options.json`) instead.
### Server (`presets/<tier>/server/`)
| File | Effect |
|------|--------|
| `server.properties` | view-distance, simulation-distance, compression |
| `jvm-flags.txt` | Recommended JVM heap + GC flags for that RAM tier |
## Applying a tier (client)
```bash
# Example: switch to LOW
cp -r presets/low/config/* ~/.local/share/PrismLauncher/instances/<instance>/minecraft/config/
```
Then restart the game. Shader-pack in-game settings (Complementary) still
override a few visual options — see `docs/performance.md`.
## Applying a tier (server)
```bash
# Example: switch to LOW
cp presets/low/server/server.properties server_pack/server.properties
# use the jvm-flags.txt line when launching
```
## Notes
- **Shaders are disabled on the Low tier** — this is the single biggest FPS win.
On Low, either play without a shaderpack or use an "Ultra/Performance"
preset of Complementary with shadows off.
- **Medium is the shipped default** — the mrpack already contains these configs,
so players who do nothing get the balanced experience.
- `enableShaderCompatibleRendering` is on for Mekanism Covers on all tiers so
covers render correctly with shaders.