# OFModpack

Dépôt **packwiz** du modpack (base ATM10, Minecraft 1.21.1 / NeoForge) consommé
par [OFLauncher](../OFLauncher). C'est la **source de vérité** : versions du jeu,
liste des mods, configs. Quand tu pushes ici, les joueurs reçoivent le delta au
prochain lancement.

> Toutes les commandes ci-dessous se lancent **sur ta machine Windows**, dans ce
> dossier (`C:\Users\Lucas\Dev\OFModpack`), depuis PowerShell.

---

## 1. Installer packwiz (une fois)

Le plus simple avec [Scoop](https://scoop.sh) :

```powershell
scoop install packwiz
```

Sinon, télécharge `packwiz.exe` (build Windows) depuis
<https://nightly.link/packwiz/packwiz/workflows/go/main> et place-le dans un
dossier de ton `PATH`. Vérifie :

```powershell
packwiz --version
```

> packwiz embarque sa propre clé API CurseForge : tu n'as **pas** besoin de clé
> pour importer/ajouter des mods.

## 2. Récupérer le zip ATM10

Depuis CurseForge, télécharge le fichier **client** d'All The Mods 10 :
<https://www.curseforge.com/minecraft/modpacks/all-the-mods-10/files>
(bouton *Download* sur la version voulue). Mets le `.zip` dans ce dossier.

## 3. Importer ATM10 dans packwiz (une fois)

```powershell
packwiz cf import .\All-the-Mods-10-X.Y.Z.zip
packwiz refresh
```

Ça crée `pack.toml`, `index.toml`, un `mods\*.pw.toml` par mod, et copie les
configs (`config\`, etc.). `pack.toml` contient déjà les bonnes versions MC +
NeoForge lues depuis le manifeste ATM10.

## 4. Pousser sur GitHub (hébergement)

```powershell
git add -A
git commit -m "Import ATM10"
# crée le repo "OFModpack" sur github.com, puis :
git remote add origin https://github.com/<TON_USER>/OFModpack.git
git push -u origin main
```

Puis, dans **OFLauncher**, mets l'URL *raw* du `pack.toml` dans
`src/shared/config.ts` :

```ts
packTomlUrl: 'https://raw.githubusercontent.com/<TON_USER>/OFModpack/main/pack.toml',
```

> Variante : si tu préfères héberger sur ton serveur (tu as déjà `ldpt.fr`),
> sers ce dossier en statique et pointe `packTomlUrl` vers
> `https://.../OFModpack/pack.toml`. GitHub reste le plus simple pour commencer.

## 5. Mettre à jour le modpack (le geste récurrent)

```powershell
packwiz cf add <nom-ou-url-du-mod>   # ajouter un mod CurseForge
packwiz mr add <slug>                # ajouter un mod Modrinth
packwiz update --all                 # mettre à jour tous les mods
packwiz remove <mod>                 # retirer un mod
```

Puis publie en une commande avec le script fourni :

```powershell
.\update-pack.ps1 "message de commit"
```

Au prochain lancement du launcher, les joueurs ne téléchargent **que** les
fichiers changés (et les mods retirés disparaissent de leur instance).

## Mods CurseForge non-redistribuables

Quelques mods interdisent le téléchargement automatique. packwiz les importe
quand même (métadonnées), mais `packwiz-installer` ne pourra pas les récupérer
seul ; le joueur verra un message. Si la licence le permet, héberge le `.jar`
toi-même et ajoute un bloc `[download]` dans le `.pw.toml` du mod concerné. Pour
ATM10 la grande majorité passe sans souci.