lucasdpt
95 lines
3.0 KiB
Markdown
95 lines
3.0 KiB
Markdown
# 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.
|