sanctuary/CANAPLIA.md

Migration de Canaplia

Canaplia est désormais implémenté dans Sanctuary 26.2 par les tickets CANA-01 à CANA-09. Il reste un namespace de compatibilité réparti entre les propriétaires fonctionnels existants, et non un onzième sous-projet Gradle.

Architecture

Responsabilité	Propriétaire	Contrat public
cultures, variantes, récolte, compostage, résine, effets serveur et Codex	It's Alive	classes itsalive.canaplia, registres historiques canaplia:*
calendrier, météo, rendu visuel et accessibilité	Ambiance	AmbianceLunarHarvestApi, AmbianceVisualEffectApi et payloads bornés
événements de première découverte	Sanctuary	SanctuaryProgressionService.recordExternal
climat et biomes	Another World / It's Alive	ClimateCropForaging
exclusions Shop et récompenses aléatoires	Only Fun	OnlyFunItemPolicy

It's Alive fournit l'alias Fabric canaplia et dépend explicitement d'Another World, d'Ambiance et de Sanctuary. Ambiance dépend de Sanctuary mais jamais d'It's Alive ; aucun cycle n'est introduit.

Contenu et survie

Les seize clés stables sont common, tender, olive, dark, ashen, moss, gold, amber, bluish, pink, coral, purple, indigo, varieg, lunar et ember.

Les trois blocs historiques, le type de block entity et les 64 items historiques sont enregistrés une seule fois. Les cultures partagent une croissance à huit âges et conservent leur variante dans le blockstate. Dix têtes identiques dans un composteur produisent le bloc de résine correspondant ; une autre variante est refusée. La résine est posée éteinte, s'allume au briquet, à la charge de feu ou avec un projectile enflammé, émet une fumée visible et applique son aura serveur pendant 90 secondes avant de disparaître.

Les sources sauvages sont chargées depuis data/canaplia/canaplia_discovery/sources.json. Elles fonctionnent lors de la casse de flore dans les chunks existants. Ember est limitée à la flore native du Nether, Indigo aux chorus de l'End, et toutes les variantes Canaplia sont exclues du Shop et des récompenses ordinaires.

Les hybridations utilisent uniquement des parents matures dans un rayon de un bloc. Le serveur revalide climat, humidité, lumière, eau, horaire, nuit et ciel visible au moment de la récolte et n'effectue jamais plus d'un tirage. La règle Lunar passe par l'instantané public d'Ambiance.

Effets, rendu et accessibilité

La consommation démarre une session autoritaire serveur de 140 à 180 secondes. Un bad trip éventuel est tiré une seule fois, commence après un délai borné et dure de 25 à 40 secondes. Les rafraîchissements restent bornés ; mort, expiration et déconnexion nettoient la session. L'aura d'une résine ne relance jamais le tirage.

Ambiance possède les trois payloads historiques canaplia:hemp_visual_sync, canaplia:hemp_bad_trip et canaplia:hemp_visual_clear. Il compose un profil normal et un profil de bad trip avec sa météo, sa lightmap et son contrat Iris/Canon, sans shader privé concurrent. Les réglages locaux d'intensité, de réduction des mouvements, de wobble et de ghosting sont disponibles dans les contrôles via « Réglages d'accessibilité visuelle » et n'altèrent jamais le gameplay serveur.

Codex

Les monstres tués par un joueur peuvent laisser une canaplia:codex_page et, très rarement, le canaplia:codex complet. Quatre pages récupérées permettent aussi d'assembler le Livre interdit autour d'un livre vanilla. Un clic droit sur une page découvre au hasard une entrée encore inconnue et ne consomme la page qu'en cas de nouvelle découverte.

L'ID historique canaplia:codex est conservé, mais l'objet s'affiche désormais comme le « Livre interdit » : il utilise la couleur du livre enchanté, ouvre directement les seize entrées et les présente sur les pages claires du livre vanilla. En main, son contenu est strictement personnel. Posé sur un pupitre, il est temporairement inscrit au nom du joueur qui le pose et partage ses découvertes avec tous les lecteurs ; le récupérer en s'accroupissant ou casser le pupitre efface cette inscription.

Les données canaplia:codex restent en version 1. Les clés futures syntaxiquement valides et l'ancien champ partagé restent conservés lors d'un aller-retour afin qu'une migration ne perde aucune découverte, mais les nouvelles découvertes ne sont plus publiées globalement. Aucun payload de découverte n'est accepté du client vers le serveur et le protocole It's Alive reste en version 4.

Tickets livrés

Ticket	Fonction
#36 CANA-02	seize familles, ressources et compostage
#37 CANA-03	découvertes climatiques data-driven
#38 CANA-04	hybridations serveur
#39 CANA-05	Ember Nether et Indigo End
#40 CANA-06	récolte Lunar liée à Ambiance
#41 CANA-07	effets serveur et bad trips
#42 CANA-08	composition visuelle accessible
#43 CANA-09	Codex persistant personnel et partagé

Compatibilité, licence et migrations

Les IDs historiques, les clés et le namespace sont inchangés. L'ancien format non versionné de canaplia:hemp_bud_composters reste lisible et est réécrit sous une enveloppe v1. Le block entity de résine conserve remaining_burn_ticks et migre sa donnée v1 déjà active vers l'état allumé v2. Le Codex utilise sa propre donnée v1. Les protocoles restent It's Alive v4 et Ambiance v5.

La source historique 2.0.0 demeure All Rights Reserved, copyright KOKA99CAB. À la demande explicite du détenteur des droits, ses 224 textures 16×16 ont été restaurées dans l'alpha.209 ; leur provenance est documentée avec les ressources. Aucun fichier Java, modèle, son ou JSON historique n'est copié. Le code d'intégration reste sous GPL-3.0-or-later.

Les inventaires machine sont dans pack/migrations/canaplia-foundation-alpha32.json et pack/migrations/canaplia-gameplay-alpha33.json. La release 26.2.0-alpha.209 décrit la correction de gameplay et l'import autorisé dans pack/migrations/26.2.0-alpha.208-canaplia-fixes-to-alpha.209.json; l’alpha.210 décrit le Livre interdit et les autres changements distribués dans pack/migrations/26.2.0-alpha.209-forbidden-book-and-polish-to-alpha.210.json.