Setup — Install & Update

Prereqs

Java 21 (Adoptium Temurin 21 LTS recommended)
~12 GB RAM free for client, 8 GB minimum for server
Disk: keep under 100 GB total for world + packs

First-time server setup

# from this repo root
packwiz install --dir server_pack            # downloads all mods into server_pack/
java -Xms2G -Xmx6G -jar server_pack/neoforge-21.1.248-installer.jar --installServer
# accept EULA, then launch:
java -Xms2G -Xmx6G -XX:+UseG1GC -jar server_pack/neoforge-21.1.248-server.jar nogui

First-time client setup

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 mods.md).

Adding a mod (both packs)

packwiz --dir server_pack  curseforge add --addon-id <CF_ID> -y
packwiz --dir client_pack  curseforge add --addon-id <CF_ID> -y
packwiz --dir server_pack  modrinth add <MR_SLUG_OR_ID> -y
packwiz --dir client_pack  modrinth add <MR_SLUG_OR_ID> -y
packwiz --dir server_pack  refresh
packwiz --dir client_pack  refresh

Always add to both packs unless the mod is client- or server-only.
For Fabric mods that must run through Sinytra, use packwiz url add "<Name>" "<URL>" --force and verify the Sinytra connector tolerates the version.

Editing story text

# edit STORY/*.md first, then:
python tools/gen_story.py      # regenerates en_us.json in BOTH packs
bash tools/sync_kubejs.sh      # mirrors server_pack/kubejs → client_pack/kubejs

Never hand-edit en_us.json — it is generated. Full workflow: STORY/00-index.md.

2 KiB Raw Blame History