sanctuary-beta/docs/spawn-eggs-catalogue-beta107.md

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