Integrate verified Sanctuary beta.110 with clay workshop, eggs and seasonal snow

docs/spawn-eggs-catalogue-beta107.md

@@ -0,0 +1,155 @@
+# Acquisition des 88 œufs — catalogue à valider
+
+Demande du créateur : **valider les voies spéciales avant de les implémenter**.
+Ce catalogue utilise les 88 identifiants de `CompanionType`, pour Minecraft 26.3.
+Les œufs natifs servent aussi aux familiers. Aucun nouvel œuf propriétaire.
+
+**28 espèces** ont une voie par reproduction/duplication dans EGGS-107,
+**7** par les générateurs classiques des structures vanilla,
+et **53** attendent une voie spéciale.
+
+Les structures doivent être présentes et accessibles dans la partie : cette
+livraison n’ajoute aucun donjon, ne régénère aucun chunk et ne garantit pas ces
+structures dans un monde plat. Un générateur classique configuré autrement
+remet aussi l’œuf de son type, s’il existe ; cela ne crée pas une voie naturelle
+pour toutes les espèces. Les générateurs d’épreuves ont une proposition distincte.
+
+## Voies intégrées à EGGS-107
+
+Une reproduction donne **un œuf**, jamais simultanément un bébé. Les règles
+natives d’accouplement, d’apprivoisement, de nourriture et de délai restent
+applicables. Les poissons crus ne remplacent pas un seau quand le jeu exige un
+poisson vivant. Les œufs de bébé restent bébés après stockage ; le temps de
+croissance commence à l’éclosion.
+
+| Espèce (identifiant natif) | Obtention |
+| --- | --- |
+| `cat` | Deux chats apprivoisés, morue ou saumon crus. |
+| `chicken` | Deux poules, graines. |
+| `cow` | Deux vaches, blé. |
+| `donkey` | Deux ânes apprivoisés, carottes ou pommes dorées. |
+| `fox` | Deux renards, baies sucrées ou lumineuses ; confiance héritée. |
+| `horse` | Deux chevaux apprivoisés, carottes ou pommes dorées ; caractéristiques héritées. |
+| `llama` | Deux lamas apprivoisés, bottes de paille ; force et variante héritées. |
+| `mule` | Croisement cheval × âne. La mule reste stérile. |
+| `pig` | Deux cochons, carotte, pomme de terre ou betterave. |
+| `rabbit` | Deux lapins, carotte, carotte dorée ou pissenlit. |
+| `sheep` | Deux moutons, blé ; mélange de couleurs natif. |
+| `tadpole` | Deux grenouilles, boules de slime ; œuf de têtard à la place de la ponte aquatique. |
+| `armadillo` | Deux tatous, yeux d’araignée. |
+| `bee` | Deux abeilles, fleurs. |
+| `camel` | Deux dromadaires, cactus. |
+| `goat` | Deux chèvres, blé. |
+| `ocelot` | Deux ocelots, morue ou saumon crus. |
+| `panda` | Deux pandas, bambou et environnement de reproduction natif ; gènes hérités. |
+| `strider` | Deux arpenteurs, champignons biscornus. |
+| `turtle` | Deux tortues, herbes aquatiques ; œuf de bébé à la place de la ponte. |
+| `villager` | Reproduction native des villageois : nourriture suffisante et lit libre accessible. L’œuf donne un bébé. |
+| `wolf` | Deux loups apprivoisés, nourriture native ; propriétaire hérité. |
+| `allay` | Duplication native : allay dansant avec un jukebox, éclat d’améthyste. Délai de 5 minutes conservé. |
+| `axolotl` | Deux axolotls, poissons tropicaux en seau. |
+| `hoglin` | Deux hoglins, champignons carmin. |
+| `mooshroom` | Deux champimeuhs, blé. |
+| `nautilus` | Deux nautiles apprivoisés, nourriture acceptée par la reproduction native. |
+| `sniffer` | Deux renifleurs, graines de plante torche ; œuf d’apparition à la place de l’œuf bloc. |
+
+Pour les suivants : casser le générateur avec un outil adapté, sans Toucher de
+soie. Un œuf par générateur ; Fortune ne multiplie pas le résultat. Les outils
+avec Toucher de soie ne donnent pas d’œuf ; cette livraison ne leur ajoute pas
+non plus une récupération du bloc générateur.
+
+| Espèce (identifiant natif) | Source vanilla si présente |
+| --- | --- |
+| `skeleton` | Générateur de donjon. |
+| `spider` | Générateur de donjon. |
+| `zombie` | Générateur de donjon. |
+| `cave_spider` | Générateur de mine abandonnée. |
+| `blaze` | Générateur de forteresse du Nether. |
+| `magma_cube` | Générateur de salle au trésor de bastion. |
+| `silverfish` | Générateur de la salle du portail du stronghold. |
+
+## Propositions — pas encore implémentées
+
+Les pourcentages ci-dessous sont des valeurs de départ à valider. Les captures
+**convertissent le mob en œuf** et ne laissent pas son double dans le monde.
+Pour les butins et récompenses, un mob né d’un œuf ne pourra pas produire son
+propre œuf par cette voie. Les récompenses uniques devront avoir un suivi serveur
+persistant : contrat de migration à définir lors du prochain ticket. Ces règles
+ne sont pas encore ajoutées au jeu.
+
+| Espèce | Type de voie | Proposition concrète |
+| --- | --- | --- |
+| `bat` | Interaction | Capturer une chauve-souris endormie avec un sac et une boule de slime. Le mob devient un œuf ; sac rendu. |
+| `cod` | Capture | Morue en seau + œuf de poule : convertir le poisson en œuf d’apparition ; seau vide rendu. |
+| `frog` | Interaction | Élever un têtard jusqu’à la métamorphose, puis donner une boule de slime : un œuf de grenouille, une seule fois par grenouille élevée. |
+| `salmon` | Capture | Saumon en seau + œuf de poule ; seau vide rendu. |
+| `slime` | Butin conditionnel | Tuer un petit slime au corps à corps : 5 % de chance, uniquement sur la génération issue d’un slime naturel. |
+| `squid` | Capture | Interagir avec un poulpe sous l’eau avec un sac et une morue : le convertir en œuf ; sac rendu. |
+| `tropical_fish` | Capture | Poisson tropical en seau + œuf de poule ; conserver exactement ses couleurs et son motif. |
+| `copper_golem` | Construction | Construire un golem de cuivre puis lui faire terminer 16 tris réels : un œuf, une seule fois par golem construit. |
+| `dolphin` | Exploration | Nourrir un dauphin et atteindre le trésor qu’il indique : un œuf à la découverte, une fois par trésor et joueur. |
+| `drowned` | Butin conditionnel | Noyé naturel tué sous l’eau par un joueur : 5 %. |
+| `glow_squid` | Capture | Même capture que le poulpe, dans une caverne immergée ; conversion du mob en œuf lumineux. |
+| `husk` | Butin conditionnel | Zombie momifié naturel tué dans le désert en plein jour : 5 %. |
+| `parrot` | Interaction | Apprivoiser un perroquet puis lui offrir des graines pendant sa danse au jukebox : un œuf, une seule fois par perroquet sauvage apprivoisé. |
+| `pufferfish` | Capture | Poisson-globe en seau + œuf de poule ; seau vide rendu. |
+| `polar_bear` | Interaction | Donner du saumon à deux adultes sur neige : reproduction Sanctuary spécifique donnant un œuf de bébé, délai de 5 minutes. |
+| `snow_golem` | Construction | Monter le golem de neige natif puis l’emballer avec une citrouille sculptée : conversion du golem en œuf. |
+| `bogged` | Épreuve | Après une vague terminée, toucher son générateur d’épreuves avec un œuf de poule : un œuf de bogged, une fois par joueur et recharge native. |
+| `parched` | Butin conditionnel | Parched naturel vaincu dans le désert avec un bouclier après avoir bloqué sa flèche : 5 %. |
+| `breeze` | Épreuve | Même extraction après victoire sur les vagues de Breeze ; coût d’un œuf de poule, recharge native du générateur d’épreuves. |
+| `camel_husk` | Rencontre | Désarçonner les cavaliers hostiles puis apprivoiser la monture avec sa nourriture native : un œuf, une seule fois pour cette monture sauvage. |
+| `creeper` | Butin conditionnel | Creeper naturel tué par un squelette, comme pour les disques : 10 %. |
+| `endermite` | Interaction | Toucher une endermite apparue d’une perle avec un fruit de chorus : conversion en œuf avant sa disparition. |
+| `guardian` | Butin conditionnel | Gardien naturel vaincu à proximité d’un monument : 5 %. |
+| `phantom` | Butin conditionnel | Phantom naturel vaincu dans les airs avec une arme de mêlée : 10 %. |
+| `piglin` | Troc | Ajouter l’œuf au troc contre un lingot d’or : 2 %, poids exact à équilibrer. |
+| `pillager` | Butin conditionnel | Pillard capitaine naturel vaincu par un joueur : 10 %. |
+| `sulfur_cube` | Capture | Cube de soufre en seau + œuf de poule : convertir le contenu du seau en œuf, avec taille et contenu conservés. |
+| `trader_llama` | Commerce | Offre rare du marchand ambulant : œuf de lama de marchand contre émeraudes et botte de paille. Les lamas ordinaires restent obtenus par reproduction. |
+| `wandering_trader` | Commerce | Terminer toutes les offres d’un marchand : une offre finale d’œuf contre 32 émeraudes. Une fois par marchand naturel. |
+| `zombie_horse` | Rencontre | Libérer puis apprivoiser un cheval-zombie sauvage avec la nourriture native : un œuf, une seule fois par monture. |
+| `zombie_villager` | Guérison | Guérir un villageois zombie naturel : un œuf de villageois zombie remis au soigneur ; un seul par individu, sans boucle de réinfection. |
+| `zombified_piglin` | Butin conditionnel | Piglin zombifié naturel vaincu au Nether par un joueur : 5 %. |
+| `stray` | Butin conditionnel | Vagabond naturel vaincu pendant une chute de neige : 10 %. |
+| `vindicator` | Butin conditionnel | Vindicator vaincu dans un manoir ou un raid : 5 %. |
+| `zoglin` | Transformation | Amener un hoglin dans l’Overworld et le voir devenir zoglin : première interaction avec un champignon carmin remet un œuf, une seule fois. |
+| `creaking` | Exploration | Neutraliser un grinceur lié puis casser son cœur actif sans Toucher de soie : un œuf. Le cœur ne donne pas simultanément sa version récupérable. |
+| `elder_guardian` | Boss | Vaincre un grand gardien du monument : un œuf garanti, uniquement pour les gardiens générés avec le monument. |
+| `enderman` | Butin conditionnel | Enderman naturel vaincu dans l’End par un joueur : 5 %. |
+| `evoker` | Butin conditionnel | Évocateur vaincu dans un manoir ou un raid : 10 %. |
+| `ghast` | Défi | Tuer un ghast naturel en lui renvoyant sa propre boule de feu : 25 %. |
+| `happy_ghast` | Élevage | Réhydrater un ghast desséché puis élever le ghastling : premier nourrissage adulte avec une boule de neige remet un œuf de ghastling, une fois par ghast élevé. |
+| `iron_golem` | Construction | Construire un golem de fer puis lui offrir un coquelicot et un lingot : conversion volontaire du golem en œuf. |
+| `piglin_brute` | Exploration | Piglin barbare du bastion vaincu par un joueur : 10 %. |
+| `ravager` | Raid | Dernier ravageur vaincu dans un raid remporté : un œuf au vainqueur, une récompense par raid. |
+| `shulker` | Exploration | Shulker d’une cité de l’End vaincu par un joueur : 10 % ; les copies par projectiles ne déclenchent pas cette voie. |
+| `skeleton_horse` | Événement | Survivre au piège de cavaliers squelettes puis monter un cheval libéré : un œuf, une récompense par piège. |
+| `vex` | Défi | Tuer un vex invoqué après avoir vaincu l’évocateur qui l’a invoqué : 10 %, une récompense maximum par évocateur. |
+| `witch` | Butin conditionnel | Sorcière naturelle vaincue pendant qu’elle boit une potion : 10 %. |
+| `wither_skeleton` | Butin conditionnel | Wither squelette naturel vaincu dans une forteresse : 5 %, indépendant du crâne. |
+| `zombie_nautilus` | Rencontre | Libérer un nautile-zombie de son cavalier puis l’apprivoiser : un œuf, une seule fois par monture sauvage. |
+| `ender_dragon` | Boss | Vaincre le dragon invoqué par le cycle natif de l’End : un œuf au participant désigné ; jamais pour un dragon apparu avec un œuf. |
+| `warden` | Défi | Vaincre un Warden sorti d’un hurleur naturel : un œuf garanti pour ce combat ; aucun œuf sur un Warden issu d’œuf. |
+| `wither` | Boss | Vaincre un Wither invoqué par sable des âmes et crânes : un œuf garanti ; aucun œuf sur un Wither issu d’œuf. |
+
+## Points à décider ensemble
+
+- Le principe de conversion avec un sac / un seau pour les espèces capturables.
+- La place des défis et du butin rare, et leurs chances exactes.
+- Les récompenses de boss garanties, avec exclusion des boss issus d’œuf.
+- Les offres du marchand et le troc restent de simples échanges natifs ; aucun
+  système d’économie, de banque ou de marché n’est introduit ici.
+
+Cas à ne pas confondre : nourrir ne veut pas toujours dire reproduire.
+Le ghast heureux, le dromadaire momifié et le cheval-zombie refusent le mode
+amoureux natif ; le nautile-zombie n’a pas de descendance native. Le lama de
+marchand suit la reproduction du lama et ne garantit pas un nouvel œuf de
+`trader_llama`. Le cube de soufre n’emprunte pas la reproduction d’`Animal`.
+Les œufs pondus naturellement par une poule et leur lancer natif restent inchangés :
+c’est l’accouplement nourri par le joueur qui produit le nouvel œuf garanti.
+
+Sources de vérification : catalogue `CompanionType`, classes et données du JAR
+Minecraft **26.3** installé (méthodes de reproduction, composants d’items et
+aliments natifs), tests intégrés EGGS-107. Le catalogue ne prétend pas qu’un
+comportement proposé est déjà une règle vanilla.