142 lines
6.3 KiB
Markdown
142 lines
6.3 KiB
Markdown
# Sanctuary
|
||
|
||
Sanctuary est une extension gratuite de Minecraft qui transforme le jeu en un
|
||
monde flottant d'exploration, de production et de progression collective.
|
||
Les joueurs commencent ensemble sur Sanctuary Island et construisent les
|
||
infrastructures qui permettront progressivement d'ouvrir de nouveaux continents.
|
||
|
||
> Sanctuary is a free expansion of Minecraft that reshapes the game around a
|
||
> floating world. Players begin together on Sanctuary Island, isolated in the
|
||
> void. By exploring, building infrastructure and producing resources, they
|
||
> progressively unlock new floating continents, each with its own geography.
|
||
> Rather than a linear campaign, the server itself becomes a world that grows
|
||
> through the action of its players.
|
||
|
||
Ce dépôt démarre la nouvelle base Fabric. La [vision complète](docs/vision.md)
|
||
conserve les intentions ; le [backlog](docs/backlog.md) prépare les premiers
|
||
tickets. Les systèmes d'expansion, d'économie, de progression et les dimensions
|
||
décrits dans la vision ne sont pas encore implémentés.
|
||
|
||
## Premier incrément
|
||
|
||
- Mod `sanctuary` indépendant et pack Sanctuary construit avec packwiz.
|
||
- Preset **Sanctuary** sélectionnable à la création d'un monde, avec une île
|
||
flottante finie, un cœur de départ et un extérieur vide.
|
||
- Forêt de départ avec végétation, minerais et animaux vanilla. Les formes de
|
||
terrain reprennent l'approche du générateur 26.2, adaptée à l'API 26.3.
|
||
- Spawn recherché sur le sol de l'île lors de la création. Les mondes ordinaires
|
||
et les choix ultérieurs de spawn ne sont pas remplacés.
|
||
|
||
L'île a une emprise nominale de 512 blocs de diamètre, avec une bordure déformée
|
||
par la seed. C'est un premier terrain technique à régler en jeu. Le catalogue
|
||
TerraMix, les continents déverrouillables, les lacs et rivières, les ruines et
|
||
les autres fonctionnalités restent à construire par tickets.
|
||
|
||
Les détails du terrain et de ses limites sont dans [Génération](docs/worldgen.md),
|
||
et la provenance dans [Audit 26.2](docs/migration-26.2.md).
|
||
|
||
## Versions et prérequis
|
||
|
||
Au 8 septembre 2026, la cible disponible est **26.3-pre-2**. Le dépôt ne prétend
|
||
pas cibler une version finale 26.3 déjà sortie. Le passage à la version finale
|
||
sera une mise à jour explicite, avec vérification des API et des sauvegardes.
|
||
|
||
| Composant | Version fixée |
|
||
| --- | --- |
|
||
| Minecraft Java | 26.3-pre-2 |
|
||
| Java JDK | 25 |
|
||
| Fabric Loader | 0.19.5 |
|
||
| Fabric API | 0.160.0+26.3 |
|
||
| Fabric Loom | 1.17.20 |
|
||
| Gradle Wrapper | 9.5.1, distribution vérifiée par SHA-256 |
|
||
| Sanctuary / pack | 0.1.0-alpha.1 |
|
||
|
||
Java 25 et Python 3.11 ou plus récent sont nécessaires. Le script pack utilise
|
||
uniquement la bibliothèque standard et repère aussi une installation Python
|
||
3.11–3.14 si `python3` désigne l'ancien Python fourni par macOS. Gradle est fourni
|
||
par le wrapper. `packwiz` est utile pour modifier les dépendances ou servir le
|
||
pack ; il n'est pas nécessaire pour le construire.
|
||
|
||
Références vérifiées : [Minecraft 26.3-pre-2](https://www.minecraft.net/en-us/article/minecraft-26-3-pre-release-2),
|
||
[Fabric](https://fabricmc.net/develop/),
|
||
[version Fabric API](https://modrinth.com/mod/fabric-api/version/o9uChmGq).
|
||
|
||
## Construire et lancer
|
||
|
||
```sh
|
||
git clone https://git.botsu.net/koka/sanctuary-beta.git
|
||
cd sanctuary-beta
|
||
./gradlew check build assemblePack
|
||
```
|
||
|
||
`check` inclut les tests de forme et le serveur de test automatisé de Fabric,
|
||
qui charge le vrai preset Sanctuary dans un monde de développement neuf.
|
||
Les scénarios couverts et les essais multijoueurs restant à effectuer sont
|
||
décrits dans [Validation](docs/testing.md).
|
||
|
||
Résultats :
|
||
|
||
- `mods/sanctuary/build/libs/sanctuary-0.1.0-alpha.1.jar` : mod à installer avec
|
||
Fabric API sur la version Minecraft indiquée.
|
||
- `build/packwiz/` : pack de développement complet, avec le mod construit et
|
||
l'index vérifié. Voir [Installation packwiz](packwiz/README.md).
|
||
|
||
Le pack peut aussi être exporté en `.mrpack` avec packwiz pour une importation
|
||
dans un lanceur compatible ; la commande est indiquée dans ce même guide.
|
||
|
||
Lancer le client de développement :
|
||
|
||
```sh
|
||
./gradlew :sanctuary:runClient
|
||
```
|
||
|
||
Créer un **nouveau monde**, puis sélectionner le type de monde **Sanctuary**.
|
||
L'installation du mod seule ne transforme pas un monde Minecraft ordinaire.
|
||
|
||
Pour un serveur de développement, lancer `./gradlew :sanctuary:runServer`, puis
|
||
suivre les indications du jeu concernant son EULA. Utiliser un dossier de monde
|
||
neuf et choisir dans `mods/sanctuary/run/server.properties` :
|
||
|
||
```properties
|
||
level-type=sanctuary:sanctuary
|
||
level-name=sanctuary-dev
|
||
level-seed=42
|
||
```
|
||
|
||
Relancer ensuite la même commande. Ne pas remplacer le générateur d'une
|
||
sauvegarde 26.2 : aucun outil de migration de ses chunks n'est livré ici.
|
||
|
||
## Organisation
|
||
|
||
| Chemin | Responsabilité |
|
||
| --- | --- |
|
||
| `mods/sanctuary/` | Code, ressources et tests du mod Sanctuary |
|
||
| `packwiz/` | Manifeste source, dépendances distantes et hashes |
|
||
| `ressources-pack/` | Sources graphiques existantes et futurs resource packs |
|
||
| `shaders-pack/` | Sources et réglages de shaders à venir |
|
||
| `docs/` | Vision, backlog, migration, génération et validation |
|
||
| `.gitea/ISSUE_TEMPLATE/` | Modèles de tickets fonctionnalités et bugs |
|
||
| `.gitea/workflows/` | Vérification sur un runner Gitea compatible |
|
||
|
||
It's Live, Only Fun et Master Key restent des modules autonomes prévus par la
|
||
vision. Leurs sources 26.2 ne sont pas copiées dans ce socle. Fabric API est la
|
||
seule dépendance de gameplay actuellement distribuée avec le mod.
|
||
|
||
## Travailler par tickets
|
||
|
||
Un ticket décrit un comportement à obtenir ou un bug à reproduire. On livre
|
||
un petit incrément, on le vérifie en jeu si nécessaire, puis on ajuste avec
|
||
le ticket suivant. Pour le terrain, joindre la seed et les coordonnées aide
|
||
à retrouver exactement le problème. Voir [Contribuer](CONTRIBUTING.md).
|
||
|
||
Le [backlog initial](docs/backlog.md) contient des propositions locales, pas des
|
||
issues déjà publiées. Le prochain travail après ce socle est le réglage de
|
||
l'île, puis le placement de continents et leur ouverture sans écraser les
|
||
constructions des joueurs.
|
||
|
||
## Licence et crédits
|
||
|
||
Sanctuary conserve la licence **GPL-3.0-or-later** du projet 26.2. Voir
|
||
[LICENSE](LICENSE) et [provenance et crédits](THIRD_PARTY_NOTICES.md).
|
||
Projet communautaire indépendant de Mojang Studios et Microsoft.
|