# 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.