# Mod shortlist + landing mod-list component (WS6)

> **Status: gap doc DONE (pack filled out 2026-07-20), landing component still
> PLANNED.** Two separable deliverables: (1) a curated kitchen-sink gap doc (this
> file), (2) an auto-generated `mods.json` + logos that feed a flat mod-list
> component on the landing page (see also `18-landing-rework.md`).

## TL;DR

- The pack is now **kitchen-sink** — **164 jars** (`mods-sides.json`: 133 `both`,
  31 `client`), up from the 76-jar vanilla+ base this doc originally described.
  Tech (Create + ~18 addons), magic (Ars Nouveau + ars_creo) and worldgen (full
  YUNG's set + Moog's structures + TerraBlender) all landed. **Map is still the
  only open gap.**
- **164 jars is over the stated 50–100 ceiling** in `CLAUDE.md`. Accepted for now;
  it moves the RAM/stability bar (`INIT_MEMORY 4G`/`MAX_MEMORY 10G` — watch it).
- Jars live in the **external distribution repo** (`$DISTRIBUTION_WEB_ROOT/servers/
  ulicraft-1.21.1/forgemods/required/*.jar`, Nebula-managed). Adding mods happens
  there, **not** in this repo. This doc is a shortlist only; depth = **light** (names
  by area, verify NeoForge 1.21.1 at add-time — no per-mod version/link research).
- The landing component shows the **installed pack** (full client set), auto-generated
  from the jars — a different dataset from this shortlist. Flat alphabetical, pretty
  names, extracted logos, no categories, no Modrinth/CF links.

## Current pack — what's in (164 jars)

- **Tech — Create ecosystem (the anchor):** create, createaddition, createdeco,
  create_connected, copycats, create-central-kitchen, create-enchantment-industry,
  create-integrated-farming, create_jetpack(+curios), create_mechanical_chicken,
  create_mechanical_extruder, create_mechanical_spawner, mechanical_cow,
  mechanicals, createsifter, createultimine, createornithopterglider,
  CreateDragonsPlus, sliceanddice, sophisticatedbackpackscreateintegration,
  kubejs-create. Non-Create tech: laserio, enderrf, EnderStorage, melter,
  mob_grinding_utils, buildinggadgets2, charginggadgets, titanium, CodeChickenLib.
- **Magic:** ars_nouveau, ars_creo (Ars×Create bridge).
- **Worldgen/exploration:** full YUNG's set (BetterCaves, CaveBiomes, Bridges,
  BetterDungeons, BetterMineshafts, BetterStrongholds, BetterDesertTemples,
  BetterJungleTemples, BetterOceanMonuments, BetterWitchHuts,
  BetterNetherFortresses, BetterEndIsland), Moog's (Voyager, End, Nether,
  MissingVillages, moogs_structures), TerraBlender, ExplorersCompass,
  world_dimension_nexus, HangGlider, fishingoverhaul.
- **Perf:** sodium, sodium-extra, iris, immediatelyfast, entityculling, ferritecore,
  lithium, modernfix, spark.
- **QoL:** JEI, Jade(+addons), JER, JEProfessions, appleskin, MouseTweaks, Controlling,
  Searchables, inventoryessentials, polymorph, rightclickharvest, simplemagnets,
  fastleafdecay, torchmaster, trashcans, corpse(+curioscompat), lootr, comforts,
  BetterF3, tagtooltips, cardboardboxes, EasyAnvils, EasyMagic, easydisenchanting,
  easy-villagers, easy-piglins, EasierSleeping, solcarrot, Neat, Ping-Wheel,
  moreoverlays, ToastControl, ExtremeSoundMuffler, colorfulhearts, UsefulSlime.
- **Storage:** sophisticatedbackpacks(+core), functionalstorage(+more).
- **Farm/decor/build:** FarmersDelight, handcrafted, rechiseled, amendments,
  immersive_paintings, etched, emotecraft.
- **FTB utils:** chunks, essentials, library, teams, ultimine.
- **Voice:** Simple Voice Chat (`voicechat`).
- **Scripting/guide:** KubeJS(+rhino, +delight, +create), lootjs, toolsjs, ponderjs,
  Patchouli.
- **Server-custom:** `ulicraftmod` (this group's own mod).
- **Libs:** architectury, balm, cloth-config, configured, curios, caelus, geckolib,
  kotlinforforge, moonlight, Placebo, PuzzlesLib, resourcefullib, CreativeCore,
  supermartijn642 core/config, jamlib, baguettelib, txnilib, fzzy_config,
  titanium, utilitarian, YungsApi, Necronomicon, yacl, konkrete.

## Remaining gaps

- [ ] **Map — none.** Candidate: Xaero's Minimap + Worldmap. (`Ping-Wheel` and
      `ftb-chunks`' claim map do not replace a minimap.)
- [ ] **Server-side perf (optional):** C2ME. (`modernfix` is in.)
- [ ] Optional second magic pillar (Botania / Iron's Spells) — Ars alone covers the
      vibe; only add if the pack budget allows.

## Orphaned dependencies

- [x] **`ponderjs`** — resolved, Create is in the pack.
- [ ] **`Necronomicon`** present but **no Iron's Spells** — it's Iron's Spells' lib.
      Add Iron's Spells or drop.

## Execution (external repo, when ready)

1. Add jars in the distribution repo (Nebula `forgemods/required/`), keep the NeoForge
   1.21.1 builds matching the `21.1.233` pin.
2. `release-distro.sh` regenerates `distribution.json` + uploads.
3. Back in this repo: `tooling/classify-mods.py` (seed sides) → hand-edit new
   client-cosmetic entries to `client` → `tooling/sync-server-mods.sh`.
4. `tooling/build-modlist.py` (new, see `18-landing-rework.md`) regenerates
   `landing/src/data/mods.json` + logos → rebuild landing.

## Related

- `04-mods.md` — distribution-fed mod system, classify/sync, sides.
- `18-landing-rework.md` — the landing mod-list component + `mods.json` generator.