sanctuary-beta/ressources-pack/Sanctuary-Resource-Pack-base-26.3-pre-2/HUD.md

Retoucher les cœurs et la faim / Editing health and hunger

Cette base contient les textures Minecraft d'origine, sans dessin Sanctuary ajouté : 53 PNG de 9 × 9 pixels, avec leur transparence. Elle cible Minecraft Java 26.3-pre-2, la version de ce dépôt.

Les fichiers à ouvrir en premier

Tous les chemins du tableau partent de assets/minecraft/textures/gui/sprites/hud/.

Fichier	À quoi il sert / Purpose
heart/full.png	Cœur plein / Full heart
heart/half.png	Demi-cœur / Half heart
heart/container.png	Fond de cœur vide / Empty heart background
food_full.png	Nourriture pleine / Full food icon
food_half.png	Demi-nourriture / Half food icon
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 pour les contours de saturation et l'épuisement. Si la silhouette de nourriture change, adapter également ses quatre contours ; FOOD.md donne les coordonnées exactes dans l'atlas. Ce fichier existant est conservé sans retouche. 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 :

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