docs(mods): sync docs to the 164-jar kitchen-sink pack

The pack grew 76 -> 164 jars (133 both / 31 client) without any doc
update. Create + ~18 addons filled the tech gap, ars_nouveau + ars_creo
the magic gap, and the full YUNG's/Moog's/TerraBlender set the worldgen
gap, which also resolved the ponderjs orphan.

- 17-mod-shortlist: rewritten around the current pack; gap doc marked
  done, remaining gaps narrowed to map mod, Necronomicon orphan, C2ME.
- 04-mods: jar counts updated; the 24/52 cutover split is now labelled
  historical alongside the current 31/133.
- CLAUDE.md: WS6 partly done, stale "65 default both" line dropped, and
  the ~50-100 mod ceiling flagged as knowingly exceeded in both places.
  MAX_MEMORY 10G was sized for that old assumption - noted for re-check.
- 18-landing-rework: mods.json count 76 -> 164, "50+" stat tile noted
  stale.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
oierandClaude Opus 4.8 committed 2026-07-20 21:29:43 +02:00
1 parent 0bf42d5797
commit 7164371d34
4 files changed
+78 -53

No files matched your search

+21 -15
View File
@@ -12,7 +12,9 @@ with `plan/` or the code, those win.
- **Players**: 4–10 friends
- **Modpack vibe**: Kitchen-sink (tech + magic + exploration + QoL)
- **Pack approach**: Manually curated (~50–100 mods), NOT a forked existing pack
- **Pack approach**: Manually curated, NOT a forked existing pack. Original target
~50–100 mods; **actual is 164 jars** (2026-07-20, kitchen-sink expansion) —
ceiling knowingly exceeded, watch RAM
- **Minecraft version**: 1.21.1, **NeoForge** (not classic Forge)
- **Auth/skins**: Drasl (Yggdrasil-compatible), **password login** — no OIDC
- **DNS**: handled OUTSIDE this repo; point `${BASE_DOMAIN}` + subdomains at the host
@@ -131,7 +133,9 @@ while every other check passed.
### Memory sizing
~50–100 mods, 8 players, 1.21.1: `INIT_MEMORY: 4G`, `MAX_MEMORY: 10G`,
`USE_AIKAR_FLAGS: TRUE`.
`USE_AIKAR_FLAGS: TRUE`. **The pack is now 164 jars / 133 server-side** (Create
ecosystem + Ars Nouveau + full worldgen) — sized for the old 50–100 assumption, so
`MAX_MEMORY` may need a bump. Re-check heap usage under load before adding more.
## Config (.env)
@@ -157,13 +161,12 @@ mirrored at apex `/launcher/`. Per guest:
## Open / Pending Work
### Roadmap — mod migration follow-ups (post packwiz→04-mods)
- [ ] **Curate `mods-sides.json` cosmetic-client mods.** tomllib auto-flagged 11
hard client-only mods; the other 65 default `both`, including client-cosmetic
ones (BetterF3, entityculling, MouseTweaks, ponderjs, fancymenu, drippy, melody,
welcomescreen, Searchables, JustEnoughResources, TravelersTitles, yeetus…) that
load harmlessly on the server but waste RAM. Hand-edit them to `client` so
`sync-server-mods.sh` drops them from `./server-mods`. (Also review `appleskin`,
flagged `client` — flip to `both` if server-side food data wanted.)
- [ ] **Curate `mods-sides.json` cosmetic-client mods.** Pack is now **164 jars**
(2026-07-20): **31 `client` / 133 `both`**. The `both` set still contains
client-cosmetic mods that load harmlessly on the server but waste RAM — hand-edit
them to `client` so `sync-server-mods.sh` drops them from `./server-mods`.
(Also review `appleskin`, flagged `client` — flip to `both` if server-side food
data wanted.)
### Landing rework + mod list (PLANNED — see `plan/18-landing-rework.md`)
Full design settled across WS1–WS6; all tasks unchecked, ready to execute.
- [ ] **WS1 — Join flow off packwiz.** Homepage = UlicraftLauncher, 3 steps
@@ -181,12 +184,15 @@ Full design settled across WS1–WS6; all tasks unchecked, ready to execute.
- [ ] **WS5 — Footer status link** to `status.${BASE_DOMAIN}` (nav unchanged).
- [ ] **WS6 — Mod shortlist + list component (`plan/17-mod-shortlist.md`).**
Light gap doc: current 76-jar pack is vanilla+ QoL/perf; **empty** on tech &
magic, thin worldgen, no map; orphan deps `ponderjs`/`Necronomicon`. Landing
mod-list component = auto-generated `mods.json` + extracted logos from the
distribution forgemods (`tooling/build-modlist.py`), flat alphabetical, pretty
names, no categories/links; feeds the "50+" stat tile.
- [ ] Server-side perf mods (C2ME, etc.).
Gap doc part **DONE**: pack filled out to **164 jars** (2026-07-20) — Create
ecosystem (tech), Ars Nouveau + ars_creo (magic), full YUNG's + Moog's +
TerraBlender (worldgen); `ponderjs` orphan resolved by Create. Still open: **no
map mod** (Xaero's), `Necronomicon` orphan (no Iron's Spells), and 164 > the
stated 50–100 ceiling. Still to build: landing mod-list component =
auto-generated `mods.json` + extracted logos from the distribution forgemods
(`tooling/build-modlist.py`), flat alphabetical, pretty names, no
categories/links; feeds the "50+" stat tile.
- [ ] Server-side perf mods (C2ME, etc. — `modernfix` already in the pack).
- [x] **Filestash file share** (`files.`, 2026-07-14) — live in prod. One shared
htpasswd login, writable, rendered `:ro` config. See `plan/20-files.md`.
Follow-ups: add the Uptime Kuma HTTP monitor for `files.`; the share is