137 lines
6.9 KiB
Markdown
137 lines
6.9 KiB
Markdown
# Retoucher les cœurs et la faim / Editing health and hunger
|
||
|
||
Cette source beta.070 contient **47 cœurs vanilla** et **six sprites de faim
|
||
Sanctuary**, tous de 9 × 9 pixels avec transparence. Elle cible
|
||
**Minecraft Java 26.3-pre-2**. L’atlas de saturation a aussi été retouché.
|
||
Le [manifeste beta.070](releases/beta.070.json) fixe les fichiers livrés.
|
||
|
||
## Les fichiers à ouvrir en premier
|
||
|
||
Tous les chemins du tableau partent de
|
||
[`assets/minecraft/textures/gui/sprites/hud/`](assets/minecraft/textures/gui/sprites/hud/).
|
||
|
||
| Fichier | À quoi il sert / Purpose |
|
||
| --- | --- |
|
||
| [`heart/full.png`](assets/minecraft/textures/gui/sprites/hud/heart/full.png) | Cœur plein / Full heart |
|
||
| [`heart/half.png`](assets/minecraft/textures/gui/sprites/hud/heart/half.png) | Demi-cœur / Half heart |
|
||
| [`heart/container.png`](assets/minecraft/textures/gui/sprites/hud/heart/container.png) | Fond de cœur vide / Empty heart background |
|
||
| [`food_full.png`](assets/minecraft/textures/gui/sprites/hud/food_full.png) | Nourriture pleine / Full food icon |
|
||
| [`food_half.png`](assets/minecraft/textures/gui/sprites/hud/food_half.png) | Demi-nourriture / Half food icon |
|
||
| [`food_empty.png`](assets/minecraft/textures/gui/sprites/hud/food_empty.png) | Fond de nourriture vide / Empty food background |
|
||
|
||
Minecraft superpose les fichiers pleins ou à moitié remplis sur le fond vide.
|
||
Il faut donc garder leurs silhouettes alignées. Une icône pleine représente
|
||
deux points de vie ou de nourriture ; la moitié représente un point.
|
||
|
||
## Les variantes à adapter avec le même dessin
|
||
|
||
Les **47 fichiers** du dossier `heart/` couvrent tous les états natifs :
|
||
|
||
| Nom ou fragment du nom | État / State |
|
||
| --- | --- |
|
||
| `full`, `half`, `container` | Plein, moitié, fond vide / Full, half, empty background |
|
||
| `_blinking` | Clignotement de la vie / Health flash |
|
||
| `hardcore` | Apparence Hardcore / Hardcore appearance |
|
||
| `poisoned` | Poison / Poison |
|
||
| `withered` | Effet Wither / Wither effect |
|
||
| `absorbing` | Cœurs d'absorption / Absorption hearts |
|
||
| `frozen` | Gel / Freezing |
|
||
| `vehicle_` | Vie de la monture / Mount health |
|
||
|
||
Exemple : `poisoned_hardcore_half_blinking.png` est le demi-cœur empoisonné
|
||
qui clignote en Hardcore. Les fonds Hardcore ont leurs propres fichiers
|
||
`container_hardcore.png` et `container_hardcore_blinking.png`.
|
||
|
||
Les **six fichiers** de faim sont `food_empty.png`, `food_half.png`,
|
||
`food_full.png` et leurs variantes `food_empty_hunger.png`,
|
||
`food_half_hunger.png`, `food_full_hunger.png` pour l'effet **Faim / Hunger**.
|
||
Les icônes d'objets alimentaires dans l'inventaire sont des textures distinctes.
|
||
|
||
## Saturation et autres interfaces
|
||
|
||
Le mod utilise aussi
|
||
[`assets/sanctuary/textures/gui/food_details.png`](assets/sanctuary/textures/gui/food_details.png)
|
||
pour les contours de saturation et l'épuisement. Si la silhouette de nourriture
|
||
change, adapter également ses quatre contours ; [FOOD.md](FOOD.md) donne les
|
||
coordonnées exactes dans l'atlas. Cet atlas utilise les dessins fournis pour beta.070.
|
||
Les aperçus de nourriture et les infobulles du mod utilisent les mêmes sprites
|
||
`food_*` que la jauge.
|
||
|
||
Les menus existants se trouvent dans `assets/minecraft/textures/gui/` :
|
||
`title/` pour le logo et le panorama, `sprites/widget/` pour les boutons.
|
||
Les icônes du Blocodex sont dans `assets/sanctuary/textures/gui/progression/` ;
|
||
elles sont indépendantes des cœurs et de la faim du HUD.
|
||
Les bulles de respiration continuent de provenir du jeu.
|
||
|
||
## Méthode de retouche
|
||
|
||
1. Ouvrir les PNG dans l'éditeur de pixels de son choix.
|
||
2. Conserver les noms, les chemins, la transparence et, pour cette base,
|
||
la grille **9 × 9**. Agrandir la vue sans lisser les pixels.
|
||
3. Adapter le fond, le plein, la moitié et les variantes du même symbole.
|
||
Les icônes occupent 9 pixels, avec un pas horizontal de 8 pixels.
|
||
4. Pour essayer le pack, copier le dossier `sanctuary` dans le dossier
|
||
`resourcepacks/` de l'instance choisie, puis l'activer dans
|
||
**Options → Packs de ressources / Resource Packs**. Le placer au-dessus
|
||
des autres packs qui remplacent les mêmes textures.
|
||
5. Pendant les retouches, reporter les PNG modifiés dans cette copie et
|
||
recharger les ressources avec **F3 + T** ; selon le clavier Mac,
|
||
utiliser **Fn + F3 + T**. Modifier uniquement le dossier source de ce dépôt
|
||
ne met pas automatiquement à jour la copie installée.
|
||
|
||
Pour une vérification visuelle complète, utiliser un monde de développement :
|
||
vie pleine et demi-cœur, dégâts et clignotement, poison, Wither, absorption,
|
||
gel, Hardcore, monture, faim normale et effet Faim, puis contours de saturation.
|
||
|
||
## Export ZIP
|
||
|
||
Le dossier `sanctuary` est lui-même un resource pack. Dans un ZIP, `pack.mcmeta`,
|
||
`pack.png` et `assets/` doivent se trouver **directement à la racine**.
|
||
|
||
Pour recréer l'export local après des retouches, depuis la racine du dépôt :
|
||
|
||
```sh
|
||
python3 - <<'PY'
|
||
from pathlib import Path
|
||
from zipfile import ZipFile, ZIP_DEFLATED
|
||
source = Path('ressources-pack/sanctuary')
|
||
output = Path('ressources-pack/Sanctuary-Resource-Pack-base-26.3-pre-2.zip')
|
||
files = [source / name for name in
|
||
('pack.mcmeta', 'pack.png', 'README.md', 'HUD.md', 'FOOD.md', 'HUD-SOURCES.json')]
|
||
files += sorted(p for p in (source / 'assets').rglob('*')
|
||
if p.is_file() and p.name != '.DS_Store')
|
||
with ZipFile(output, 'w', ZIP_DEFLATED) as archive:
|
||
for path in files:
|
||
archive.write(path, path.relative_to(source).as_posix())
|
||
print(output)
|
||
PY
|
||
```
|
||
|
||
Ce ZIP est un export de travail local, ignoré par Git. Le pack reste séparé
|
||
du MRpack distribué par packwiz ; ce ticket ne livre pas une nouvelle version
|
||
du mod.
|
||
|
||
## Origine et compatibilité
|
||
|
||
Les 53 nouveaux PNG proviennent du `client.jar` officiel Mojang de
|
||
**26.3-pre-2**, déjà téléchargé par Fabric Loom pour ce projet. Ce sont des
|
||
ressources Minecraft de Mojang/Microsoft, pas des créations Sanctuary ;
|
||
elles ne sont pas placées sous la licence du code du dépôt.
|
||
|
||
[`HUD-SOURCES.json`](HUD-SOURCES.json) consigne la version, le SHA-256 du client
|
||
et celui de chaque PNG **avant retouche**. Conserver ce relevé comme référence
|
||
d'origine même après modification des dessins.
|
||
|
||
Le `version.json` de ce client indique un format de ressources **97.1**.
|
||
`pack.mcmeta` utilise donc `min_format: [97, 1]` et `max_format: [97, 1]`,
|
||
selon le lecteur `PackFormat` de cette version. La compatibilité d'une autre
|
||
version de Minecraft doit être vérifiée séparément.
|
||
|
||
**English:** Edit the original 9 × 9 PNGs listed above, keeping their paths,
|
||
filenames and transparency. Update full, half, empty and effect variants
|
||
together. Food saturation outlines live in `food_details.png`; see `FOOD.md`.
|
||
Copy the pack folder into your chosen instance's `resourcepacks/`, enable it
|
||
above overlapping packs, and reload with F3 + T. Source edits must be copied
|
||
to the installed pack. The ZIP recipe keeps the manifest and assets at its
|
||
root. This editable base targets Minecraft 26.3-pre-2, resource format 97.1.
|