# SurviePote — Atlas (Nebula) : configuration plug-and-play

Génère `root/distribution.json` pour le launcher Helios (SurviePote, MC 26.3, Fabric Loader 0.20.0).
Le launcher lit la distribution à `https://mcpv.ihorizon.org/distribution.json`
(cf `launcher/app/assets/js/distromanager.js`).

## 1. Arborescence `root/`

```
atlas/
├── .env                        # ROOT=./root, BASE_URL, JAVA_EXECUTABLE (voir §2)
├── SURVIEPOTE.md               # ce fichier
└── root/                       # web root à servir (TNDev: NE PAS committer les .jar, voir .gitignore)
    ├── distribution.json       # fichier généré, servi à https://mcpv.ihorizon.org/distribution.json
    ├── meta/
    │   └── distrometa.json     # rss + discord client (globaux)
    ├── schemas/                # schémas JSON régénérés par `init root` / `g schemas`
    ├── modpacks/curseforge/    # vide (import CurseForge, inutilisé)
    └── servers/
        └── SurviePote-26.3/
            ├── servermeta.json         # nom, adresse, discord, main/autoconnect
            ├── SurviePote-26.3.png     # icône serveur (copiée de launcher/build/icon.png)
            ├── fabricmods/
            │   ├── required/       # 31 mods partagés (client+serveur), TOUS requis
            │   ├── optionalon/     # vide
            │   └── optionaloff/    # vide
            ├── files/
            │   ├── resourcepacks/FallPack_26.3_v3.1.zip   # module File, chemin préservé
            │   └── shaderpacks/Revelation-dev.zip         # module File, chemin préservé
            └── libraries/      # vide (libs Fabric résolues à la volée via FabricResolver)
```

## 2. `.env`

```properties
JAVA_EXECUTABLE=/run/current-system/sw/bin/java
ROOT=./root
BASE_URL=https://mcpv.ihorizon.org/
HELIOS_DATA_FOLDER=
# DEV ALTERNATIVE (décommenter en dev local):
# BASE_URL=http://localhost:8080/
```

- `BASE_URL` **doit** finir par `/` : c'est le préfixe des URLs dans `distribution.json`.
  Prod : `https://git.kisakay.com/k/mc/raw/branch/main/atlas/root/` — tous les artefacts
  (mods, files, repo Fabric) sont versionnés sur git et servis en raw public, aucun hébergeur
  de fichiers séparé nécessaire. Voir `.env.example`.
  En dev, passer à `http://localhost:8931/` puis régénérer (`g distro`).
- Écart volontaire : la consigne disait `/usr/bin/java`, inexistant sur NixOS ;
  on pointe vers le binaire réel (`readlink -f $(which java)`).
- `HELIOS_DATA_FOLDER` vide = pas de `--installLocal` (pas de dossier Helios local).

## 3. Re-générer

```bash
cd atlas
npm install                              # une fois (Node 22 requis, testé en 24.14.0 OK)
npm run start -- init root               # (re)crée root/meta, root/schemas, root/servers
npm run faststart -- g server SurviePote 26.3 --fabric 0.20.0   # un seul serveur
# ... peupler fabricmods/ + files/ (voir §4), éditer servermeta.json ...
npm run faststart -- g distro            # (re)génère root/distribution.json
```

`npm run start` rebuild avant d'exécuter ; `faststart` réutilise `dist/` (plus rapide).
Ne **jamais** utiliser `--installLocal` ici (pas de Helios local).

## 4. Où sont mods / files, tri, choix d'implémentation

- Source mods : `~/.local/share/PrismLauncher/instances/26.3/minecraft/mods/*.jar`
  (copie physique par `cp`, pas de symlink).
- `fabricmods/required/` (31) : tous les mods **sauf 15 client-only purs** (même logique
  que `server/`) : sodium, iris, continuity, dynamic-fps, xaerominimap, xaeroworldmap,
  skinlayers3d, waveycapes, capes, chat_heads, morechathistory, fast-ip-ping, modmenu,
  appleskin, vanillarice.
- Tri : Nebula trie les mods par nom de fichier (`BaseModStructure.getSpecModel`),
  donc « tri mods auto » = natif, rien à faire.
- **Choix resourcepack/shader** : `src/structure/spec_model/module/File.struct.ts`
  (`MiscFileStructure extends ModuleStructure`, scan récursif, pas de namespaces
  `required/optionalon/optionaloff`) — contrairement à `FabricModStructure`
  (cf `ToggleableModule.struct.ts`). Les modules `File` sont donc **toujours requis**.
  Le choix user « optionnels ON » n'est **pas exprimable** en natif : les mettre en
  `fabricmods/optionalon` casserait le typage (`Type.FabricMod`, pas de `artifact.path`).
  → FallPack + Revelation sont en `files/resourcepacks/` et `files/shaderpacks/`
  (chemins relatifs préservés dans `artifact.path`, URLs sous `.../files/...`).
  Pour du vrai optionnel, il faudrait patcher Nebula (rendre `MiscFileStructure`
  toggleable) ou gérer ça côté launcher.

## 5. Servir via HTTP

Plus besoin d'hébergeur : tout est servi en raw git public
(`BASE_URL=https://git.kisakay.com/k/mc/raw/branch/main/atlas/root/`).
`distribution.json` : `https://git.kisakay.com/k/mc/raw/branch/main/atlas/root/distribution.json`
(valide : parsé avec `helios-core`, 34 modules, vérifié le 18/10/2026).

- Dev local : `cd atlas/root && python3 -m http.server 8931`
  (+ `.env` → `BASE_URL=http://localhost:8931/`, régénérer, ne pas committer).

## 6. TODO restants

- [ ] Discord Rich Presence : `root/meta/distrometa.json` → `discord.clientId` vide
      (+ `smallImageText/Key` vides) — mettre le vrai clientId ou supprimer l'objet.
- [ ] RSS : `root/meta/distrometa.json` → `rss` vide — mettre l'URL du flux ou laisser vide.
- [ ] Discord serveur : placeholder `SurviePote / seal-circle` dans `servermeta.json` —
      valider `largeImageKey` (asset du portail Discord).
- [ ] Icône : `SurviePote-26.3.png` = copie de `launcher/build/icon.png` (143 K) ;
      le champ `icon` de `servermeta.json` garde le texte d'aide (URL invalide),
      Nebula utilise donc le PNG (voir `Server.struct.ts` : fallback fichier).
      Remplacer par une vraie icône si besoin.
- [ ] `BASE_URL` finale : vérifier `https://mcpv.ihorizon.org/` + déploiement du contenu
      de `root/` à la racine web, puis tester le launcher en prod.
- [ ] Client-only exclus (sodium, iris, xaero…) : si les clients doivent les recevoir
      via le launcher, les ajouter en `fabricmods/optionalon/` (actuellement exclus,
      logique serveur).
- [ ] Ne pas committer les binaires (`root/servers/**`, `root/distribution.json` à
      décider) — ajouter au `.gitignore` si besoin.