guide

Install

Supersymmetry / Protocol

Distributed via CurseForge. Prism Launcher is the reference runtime: it handles Java versions, memory allocation, and instance isolation. Other launchers are supported via import pathways documented below.

System Requirements

Component
Requirement
Minecraft
1.12.2
Forge
14.23.5.2855
Java
8 (1.8.0) — Eclipse Temurin reference build
Client RAM
8192 MiB
Server RAM
6144 MiB minimum

Memory Allocation

Budget at 8192 MiB client allocation:

Base
1G
Forge
1.5G
150+ mods
3G
SuSy overhead
2.5G
Base game Forge 150+ mods SuSy overhead

Client Installation Protocol

1. Add Instance
Prism → Add Instance → CurseForge → search Supersymmetry → OK. Prism downloads Forge and all mods automatically. If CurseForge search fails, download the ZIP from the CurseForge page and use Import from ZIP.
2. Configure Java and Memory
Target: Minecraft 1.12.2 + Forge 14.23.5.2855. Prism auto-downloads Java 8. Verify in instance settings. Allocate 8192 MiB: instance → Edit → Settings → Memory → Maximum memory allocation = 8192 MiB. Minimum can remain at 512 MiB.
3. Launch
Double-click the instance. First launch requires 3–5 minutes for Forge mod index construction and class patching. Do not interrupt. Main menu displays the Supersymmetry background and custom interface. Singleplayer to create a world.

Migration Pathways

CurseForge App
Right-click instance → Export → Import ZIP into Prism.
MultiMC
Copy instance folder → Paste into Prism instances directory.

Automated migration: migrate-to-prism.py — auto-detects both launchers, copies with progress bar, parses memory and JVM settings, skips collisions.

python3 migrate-to-prism.py              # normal run
python3 migrate-to-prism.py --dry-run    # preview only

Troubleshooting Reference

Java version error on launch
Supersymmetry requires Java 8 (1.8.0). Prism auto-downloads a compatible runtime. Reference build: Eclipse Temurin by Adoptium — JCK-certified, no vendor bundling. Current release: jdk8u482-b08 (1.8.0_482-b08). After installation, Prism → Settings → Java → Auto-detect → select Temurin 8 runtime. adoptium/temurin8-binaries.
OutOfMemoryError or crash on world load
Allocate at least 6144 MiB. 8192 MiB is required for late-game bases with extensive GregTech multiblock machinery and fluid networks.

Instance Folder Location

Windows
%APPDATA%\PrismLauncher\instances\Supersymmetry\

macOS
~/Library/Application Support/PrismLauncher/instances/Supersymmetry/

Linux
~/.local/share/PrismLauncher/instances/Supersymmetry/

Server Deployment

Latest server pack: 0.1.16.5server-0.1.16.5.zip
Extract and run forge-1.12.2-14.23.5.2855.jar with Java 8. Allocate at least 6 GB RAM. Server ships with default configs; modify server.properties before first launch. All releases.