No description
Find a file
MiTHRAL 3d76c0e059
All checks were successful
Build & Release Pack / build (push) Successful in 1m39s
feat: three-tier performance presets (Low/Medium/High) for client + server
Add drop-in performance presets tuned for three hardware tiers.

Tier targets:
- Low: 4GB VRAM/iGPU, 8-16GB RAM
- Medium: RX 580-class 8GB, 16-32GB RAM (shipped as pack default)
- High: RTX 3060+ 8GB+, 32GB+ RAM

Client configs (per tier, presets/<tier>/config/):
- sodium-options.json: chunk threads, cpu render-ahead, quality
- iris.properties: shaders on/off, max shadow render distance
- lambdynlights.toml: dynamic lighting mode + adaptive ticking
- entityculling.json: culling tracing distance
- cullleaves.json: leaf culling
- soundphysics.properties: reverb/ray budget (CPU cost)
- flywheel-client.toml: Create backend (BATCHING vs INSTANCING)

Server configs (per tier, presets/<tier>/server/):
- server.properties: view-distance, sim-distance, players, compression
- jvm-flags.txt: heap + G1 GC flags per RAM tier

Medium configs also copied to client_pack/config/ so they ship as the
mrpack defaults (bundled into overrides/config/).

Docs: docs/performance.md + docs/server.md rewritten for three tiers;
presets/README.md explains how to apply each tier.

Default (Medium) enables shaders with INSTANCING flywheel on the 8GB GPU
tier; Low disables shaders + uses BATCHING for maximum FPS on weak GPUs.
2026-08-19 23:27:45 -04:00
.gitea/workflows Ship single .mrpack release; drop CurseForge zip export 2026-08-19 16:20:31 -04:00
client_pack feat: three-tier performance presets (Low/Medium/High) for client + server 2026-08-19 23:27:45 -04:00
docs feat: three-tier performance presets (Low/Medium/High) for client + server 2026-08-19 23:27:45 -04:00
presets feat: three-tier performance presets (Low/Medium/High) for client + server 2026-08-19 23:27:45 -04:00
server_pack fix: KubeJS redeclaration of const SC across server scripts 2026-08-19 22:14:35 -04:00
STORY Reorganize repo: STORY/ as prose source of truth, gen_story.py generator, docs/ ops guides, lang-key single-sourcing 2026-08-19 14:54:58 -04:00
tools Make CI validation stdlib-only for Python 3.9 runner container 2026-08-19 15:38:29 -04:00
.gitignore fix: singleplayer worldgen crash + server/client side hygiene 2026-08-19 21:02:47 -04:00
README.md Reorganize repo: STORY/ as prose source of truth, gen_story.py generator, docs/ ops guides, lang-key single-sourcing 2026-08-19 14:54:58 -04:00

SCICRAFT — The Dark Photon Protocol

"The last signal of the Second Renegade Flight hums in your blood. Rebuild the Lattice. The Protocol is never finished — only maintained."

SCICRAFT is a 140+ mod NeoForge 1.21.1 kitchen-sink modpack with a sci-fi / Whovian story layer. A collapsed star-empire is leaking back into reality through the Dimensional Doors; you are a proto-Time-Lord engineer rebuilding the Quantum Lattice — the emitter of the Dark Photon Protocol — and holding the global Corruption Tide at bay.

The entire pack is managed with packwiz and ships as two synchronized packs: a full client pack and a server-only pack.


Features

  • NeoForge 1.21.1 (21.1.248) · packwiz v1.1.0
  • Tech pillars: Mekanism, Applied Energistics 2, Create, FastPipes, Flux Networks, LaserIO, Modular Routers, Entangled
  • Dimensions: Dimensional Doors, Void Dimension, Deeper and Darker, Stellaris (rockets to moon/mars/venus/mercury)
  • Mobs & combat: Born in Chaos, Mutant Monsters, Nyf's Spiders, Better Combat, Simply Swords
  • Building: FramedBlocks, Chipped, Supplementaries, Architect's Palette, Building Gadgets, Handcrafted, Every Compat
  • Story layer: KubeJS-driven lore — the Quantum Lattice, the global Corruption Tide, Renegade Glass, a 9-node advancement phase tree
  • QoL: JEI, Jade, JourneyMap, Waystones, Curios, AppleSkin, IPN, FTB Chunks/Quests
  • Client stack: Iris + Sodium (native NeoForge), Cull Leaves, LambDynamicLights, Dynamic FPS, flywheel compat
  • Server stack: ModernFix, FerriteCore, ImmediatelyFast, Entity Culling, BadOptimizations, Krypton Reno

Requirements

  • Java 21 (Adoptium Temurin 21 LTS recommended)
  • Client: ~12 GB RAM free, 4 GB VRAM recommended (shader preset included)
  • Server: 8 GB RAM minimum
  • Disk: keep the world under 100 GB total

Directory layout

.
├── server_pack/          # Server-only packwiz pack (135 mod files)
├── client_pack/          # Full client packwiz pack (144 mod files)
│   └── shaderpacks/      # Complementary Reimagined setup guide (4GB VRAM preset)
├── STORY/                # the story — canon, items, phases, dialogue (edit here)
├── docs/                 # operations — setup, server, performance, mods
├── tools/                # gen_story.py, sync_kubejs.sh, gen_textures.py
└── README.md

Both packs are identical except the client pack adds render/shader/visual mods. Keep them in sync after any change:

bash tools/sync_kubejs.sh    # kubejs/ → client_pack
python tools/gen_story.py    # STORY/*.md → en_us.json (both packs)

Install — server

git clone git@git.mithraic.cloud:ad3laid3/SciCraft.git
cd SciCraft

packwiz install --dir server_pack
java -Xms2G -Xmx6G -jar server_pack/neoforge-21.1.248-installer.jar --installServer

# accept EULA (server_pack/eula.txt), then launch with the recommended flags:
java -Xms4G -Xmx8G -XX:+UseG1GC \
  -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 \
  -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC \
  -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 \
  -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 \
  -jar server_pack/neoforge-21.1.248-server.jar nogui

Recommended server.properties: view-distance=8, simulation-distance=6. Full details in docs/server.md.

Install — client

git clone git@git.mithraic.cloud:ad3laid3/SciCraft.git
cd SciCraft
packwiz install --dir client_pack

Add client_pack as a packwiz modpack in your launcher (Prism/ATLauncher/PolyMC) or use packwiz serve from client_pack and install via the Modrinth/packwiz installers. Drop a shaderpack into client_pack/shaderpacks/ — see the README there for the 4 GB VRAM preset.

Multiplayer: players join with the client pack; the server runs the server pack. Never put client-only mods on the server (see the client-only list in docs/mods.md).


The story (short version)

  1. Dark photons are real — a fifth force the Second Renegade Flight harnessed. They are the binding force of the Door.
  2. You are a proto-Time-Lord — the only one who can read the Protocol.
  3. The wound — the Flight's seal on a collapsed star-empire is failing. The Void Dimension is the leak; the Deeper and Darker is what answers.
  4. The Protocol — rebuild the Quantum Lattice and keep it online.
  5. The Corruption Tide — rises while Doors go unsealed (global, all players share). Re-seal Doors at the Lattice with a Void Stabilizer. No fail state — soft escalation only.
  6. The Doctor connection is atmospheric only — Renegade Glass, Per Spatium, portal styling. Never plot-driving.

Full canon, the phase tree, and the 5-minute "add a story beat" workflow: STORY/00-index.md. Story text is generated from STORY/ into en_us.json via tools/gen_story.py — edit prose, not scripts.


License & credits

Pack content is assembled for the SciCraft server. All mods belong to their respective authors. Original story text, scripts, and pack configuration are MIT licensed.