# FKRPG Optimization Report — 2026-08-27

> Packwiz is source of truth. All changes via `server_pack/` → MRPACK → LOCAL TEST → benchmark → VPS.

## SYSTEM
- **OS (local)**: Linux (Fish shell) — local commands Fish-compatible; CI uses bash.
- **Repo**: `/home/mithral/Documents/F##KRPG` @ `14b5dc3`, `packwiz` binary `2026-08-19` (`/usr/bin/packwiz`).
- **Local test**: `~/.auto-mcs/Servers/FKRPG` (142 jars, drift 1 missing vs Packwiz 143 — see drift).
- **Production**: `docker-compose.yml` `itzg/minecraft-server` `FABRIC_LOADER 0.19.3` `INIT 8G MAX 10G` file-mount `/modpacks/pack.mrpack` (`server-pack.mrpack`).
- **DRIFT status**: `LOCAL ≠ PACKWIZ` (1 missing `c2me-fabric-...364.jar`), `PRODUCTION ≠ PACKWIZ` unknown (no local `data/mods` hint) — run full audit on VPS.

## MINECRAFT
- `1.21.1` (both packs `pack.toml:13`).
- `server.properties:26` `initial-enabled-packs` includes `tectonic:tectonic` as disabled? Actually `initial-disabled-packs=...,tectonic:tectonic` — verified intentional (Tectonic datapack disabled in level-settings but still active via mod).
- `generate-structures true`, `level-type default` + Tectonic/Terralith via mods.

## FABRIC
- Loader `0.19.3` (`server_pack/pack.toml:12`).
- Fabric API `0.116.15+1.21.1` (`P7dR8mSH/Nlt8gI9z`) — latest for 1.21.1 lineage is `0.128+`? Verify — potentially outdated, but Fabric API is `LIBRARY` — review before update (may affect Cardinal/Trinkets).
- Kotlin `1.13.13+kotlin.2.4.10`.

## PACKWIZ
- `pack-format packwiz:1.1.0`, `index hash sha256 fc014e14...` (`server_pack/pack.toml:9`).
- Integrity `tools/validate_pack.py:53 OK: 143 mods indexed, all have [download] url or metadata source`.
- `optimization-manifest.json:1` + `mod-version-policy.json:1` created Phase 0, tracking all 143 server mods.
- CI `build-pack.yaml:36-66` does refresh/validate/export but not yet manifest/hash gates — add in Phase 2.

## LOCAL ENVIRONMENT
- Path `~/.auto-mcs/Servers/FKRPG` — 142 jars, `c2me` missing (audit FAIL correctly).
- Configs: `config/chunksmith/config.json` `throttleTargetMspt 300`, `tickBudget 15` — aggressive but safe.
- Logs: not yet inspected via Spark — `baseline.json:1` placeholder.

## PRODUCTION ENVIRONMENT
- VPS Docker `caddy` + `mc` on `25565/8123`.
- Deploy must be atomic: download Mrpack asset → wipe `data/mods data/config data/cache` → `docker compose up -d` (per `docker-compose.yml:15`).
- **NOT TESTED YET** — local must pass first. Rollback `releases/1.0.0` golden not yet cut.

## OPTIMIZATION MODS
| mod | current | side | classification | status |
|---|---|---|---|---|
| Lithium | `0.15.0+mc1.21.1` (`gvQqBUqZ/MM5BBBOK`) | both | OPTIMIZATION | **OUTDATED** → `0.16.x` latest; mixins ok defaults optimal — propose patch `1.0.1` |
| ModernFix | `5.25.1` (`nmDcB62a/NnNX8LBn`) | both | OPTIMIZATION | review `config/modernfix-mixins.properties`; safe server defaults only |
| FerriteCore | `7.0.2-hotfix` (`uXXizFIs/bwKMSBhn`) | both | OPTIMIZATION | **OUTDATED** → `8.x` for 1.21.1; keep safe memory opts |
| Noisium | `2.3.0` (`KuNKN7d2/4sGQgiu2`) | server | OPTIMIZATION | verify enabled, compatible |
| C2ME | `0.3.0+alpha.0.364` (`VSNURh3q/DSqOVCaF`) | both | OPTIMIZATION | **DRIFT** missing locally; newer `0.4.0-alpha.0.27+` available per `perf.md` — requires compat test with expansive Tectonic (`vertical_scale 1.28`) |
| ChunkSmith | `3.13.0+1.21.1` (`4BeAEBIb/WGnQTosc`) | both | OPTIMIZATION | installed 3.13.0 (perf.md cites 3.4.1 old); throttle `45ms target` etc. |
| Alternate Current | `1.9.0` (`r0v8vy1s/78P98rac`) | server | OPTIMIZATION | keep `enabled true nonLocational true` (`alternate-current.conf`) |
| Krypton | `0.2.8` (`fQEb0iXm/Acz3ttTp`) | both | OPTIMIZATION | zero-conf |
| Packet Fixer | `3.3.1` (`c7m1mi73/2C41Q8WX`) | both | OPTIMIZATION | audit compression thresholds |
| Debugify | `1.21.1+1.0` | both | OPTIMIZATION | overlaps with ModernFix/Lithium — keep safe |

Policy: `TEST_BEFORE_PRODUCTION` — detect ≠ install.

## WORLDGEN MODS
| mod | current | notes |
|---|---|---|
| Tectonic | `3.0.22` | tuned `tectonic.json` 0.19 continents, 1.28 vertical — FROZEN seed-affecting |
| Terralith | `2.6.2` | `terralith.json` skylands false |
| Continents | `26.2_v1.1.14 (bVXaqvWr)` | **WRONG BUILD** — should be `1.21.x_v1.1.12 (3hhSlpEU)` per docs; flagged `REVIEW_REQUIRED` |
| Lithostitched | `1.8.0+beta5` | `breaks_seed_parity true` |
| TerraBlender | `4.1.0.8` | biome API |
| Geophilic | `v3.4.1 f15-71` | |
| Wilder Wild | `4.2.1` + `FrozenLib 2.2.4` | worldgen json5 |
| CTOV | `3.6.3` | village |
| River Redux | `0.4.1` | |
| StoneZone | `2.11.17` | |
| Stoneworks | `v21.1.0` | |
| EveryCompat | `2.11.50` | |
| YUNG API/Better Monuments/Witch Huts | `5.1.5/4.1.2/4.1.1` | |
| Serene Seasons | `10.1.0.1` | fertility/seasons.toml |

All `WORLDGEN` → `EXPLICIT_APPROVAL_REQUIRED`, `automatic_updates false`. Update proposal must show changelog/perf/worldgen/migration risk + approval gate.

## IMMUTABLE MODS
31 `FROZEN` (prompt absolute):
`spell-engine 1.7.0`, `spell-power 1.3.0`, `wizards 2.4.9`, `archers 2.4.10`, `archers-expansion 1.3.9`, `armory 1.0.0`, `arsenal 1.2.0`, `berserker 2.4.7`, `forcemaster 2.4.7`, `witcher 2.4.10`, `more-rpg-classes 2.3.5`, `skill-tree 1.0.0`, `skills (puffish) 0.16.4`, `origins 1.13.0-alpha.12`, `extra-origins r3`, `better-combat 2.2.0`, `simply-swords 1.63.0`, `relics 1.0.4`, `trinkets 3.10.0`, `paladins 2.4.11`, `rogues 2.4.9`, `elemental-wizards 2.4.9`, `dragonsteel 0.0.3`, `morerunes 0.0.2`, `more_spell_attributes 0.0.8`, `runes 1.3.2`, `jewelry 2.0.10`, etc. plus libs `pehkui, playeranimator, ranged-weapon-api, owo-lib`.
Audit `tools/audit.py` never proposes updates to these — would emit `BLOCKED — IMMUTABLE RPG/MAGIC/COMBAT STACK`.

## OUTDATED MODS
- Detected offline from filenames vs docs: Lithium, FerriteCore, C2ME, Continents (wrong game version), Fabric API potentially. Run `fish tools/audit.fish --check-outdated` for live Modrinth query (network). Worldgen `REVIEW_REQUIRED`, optimization `SAFE UPDATES` (needs local test).

## SAFE UPDATES (test before prod)
1. **Lithium 0.15.0 → 0.16.x** — patch `1.0.1` candidate, lowest risk, verify mixins.
2. **FerriteCore 7.0.2 → 8.x** — memory opts, test GC.
3. **C2ME 0.3.0 → 0.4.0+** — compat matrix (terrain/biomes/structures/dims/teleport/save).
4. **Continents fix 26.2→1.21.x** — actually **worldgen** so not safe-auto; still high priority fix (current jar built for snapshots).

Each: apply to LOCAL TEST → backup → pack refresh → validate → start → Spark → benchmark → approve → MRPACK → hash → VPS.

## REVIEW REQUIRED
- All `WORLDGEN` (21 mods) — including the Continents fix — require explicit approval and migration risk doc (seed change, chunk gen).
- `LIBRARY` 34 (Architectury/Balm/Puzzles etc.) — review may affect FROZEN deps.
- `GAMEPLAY` 47 — case-by-case (e.g., `squaremap` vs `dynmap` redundancy).

## PERFORMANCE BASELINE
- `baseline.json:1` placeholder `tps 20.0 mspt 25.4 mem 7.1G gc 3.2ms`. **No real Spark capture yet.**
- Next: start local server, `spark profiler --timeout 300`, fill baseline; commit as golden.

## PERFORMANCE REGRESSIONS
- None measured yet. Drift prevents clean baseline — fix C2ME missing first.

## CONFIGURATION
- `chunksmith/config.json` — `continueOnRestart true`, `throttleTargetMspt 300`, `throttleMaxHeap 80%`, `lodEnabled auto`, `csloD 1024MB`.
- `alternate-current.conf` — `enabled true`.
- `server.properties:17-64` — `view-distance 10`, `simulation 10`, `sync-chunk-writes true`, `compression 256`, `entity-broadcast 100`, `max-tick-time 60000`. `sync-chunk-writes true` safe for HDD but costs perf — recommend `false` only after confirming NVMe + tests.
- `modernfix-mixins.properties` — audit needed.
- RPG configs (spell_engine, origins etc.) — **immutable, not tuned**.

## JVM
- Docker `INIT 8G MAX 10G` (compose). Java version unknown — need `java -version` on VPS. Recommend Java 21 + `UseG1GC` (default) or `ZGC` (`-XX:+UseZGC` per README) with headroom for OS/cache/backups. Do not allocate 100% RAM.

## NETWORK
- `krypton 0.2.8`, `packet-fixer 3.3.1`, `network-compression-threshold 256`, `view-distance 10`.
- Evaluate chunk send rate, entity tracking, avoid unlimited packets. `moreCulling` client-only.

## STORAGE
- Local unknown; VPS unknown — run `lsblk -d -o name,rota,model` + `df -h` on VPS. If HDD → major bottleneck for `sync-chunk-writes true`.

## PREGENERATION
- ChunkSmith pregeneration: target idle high rate, throttled online via `MSPT/TPS`. Noisium + C2ME compatible. Test `/chunksmith pregen 128` + `cslod status`.

## DISTANT HORIZONS
- Not in pack (private Voxy excluded). ChunkSmith CSLOD via `port+1` backchannel. Client JVM `-XX:+UseZGC` suggested. Do not inflate server `view-distance` for DH.

## MAP SYSTEMS
- `squaremap 1.3.2` (server), `Xaero Minimap/World Map` + `MapLink 4.5.1` + `MapSyncer 1.0.3` (client-leaning). `dynmap` excluded per compose. Evaluate redundant server rendering — Squaremap should be sole server web map; Xaero client via MapLink link `http://frpg.dedyn.io:8123`.

## RISKS
- **C2ME missing locally** blocks clean baseline — fix before benchmark.
- **Continents wrong jar** may cause biome/terrain warnings — fix to 1.21.x build before pregeneration.
- **Fabric API potentially stale** — update may cascade.
- **No Spark baseline** → cannot prove optimization.
- **No golden release** → no rollback point yet.

## RECOMMENDATIONS
1. Fix drift: reinstall C2ME locally (`packwiz refresh` + copy jar or re-export mrpack).
2. Run `fish tools/audit.fish --check-outdated` to populate live outdated list.
3. Capture `baseline.json` via Spark on fixed local.
4. Cut `releases/1.0.0` golden (current 1.0 pack) with hashes before any optimization.
5. Apply safe optimization patch `1.0.1` (Lithium/FerriteCore) on LOCAL → benchmark → approve.
6. Separately propose `1.1.0` for Continents fix + worldgen review (requires seed migration doc).
7. Extend CI `build-pack.yaml` with manifest/hash/drift gates.

---
*Generated 2026-08-27 from audit + manifest + policy. Packwiz is source of truth.*