feat: initial commit

2026-06-14 01:24:29 +02:00
commit 0d40f88ab2
5815 changed files with 703860 additions and 0 deletions
@@ -0,0 +1,94 @@
+# 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.