sanctuary-beta/docs/operator-inhabitant-stars-beta040.md

# beta.040 — opérateur, habitant et ciel partagé

Branche `codex/operator-inhabitant-beta040`. Ticket issu des demandes du 14 septembre 2026.

## Contrat du mode opérateur

Dans une partie intégrée, **World Options → Allow Commands → Apply Changes**
active ou désactive le mode opérateur Sanctuary. Le réglage natif enregistré
fait autorité ; le mode créatif seul ne constitue pas une autorisation.
Il n'existe plus de second interrupteur opérateur propre à la carte ou aux
recettes. Sur serveur dédié, les droits sont ceux des opérateurs Minecraft :
un joueur distant ne peut pas s'attribuer ces droits depuis son interface.

Sans commandes, les contrôles réservés aux opérateurs sont invisibles et leurs
actions sont refusées côté serveur. Avec commandes, l'inspection de la carte,
le catalogue complet, les recettes complètes, les remboursements de compétences
et la remise à disposition du pouvoir du familier deviennent accessibles.
Le catalogue indique explicitement son mode opérateur. Couper les commandes
rétablit les filtres de découvertes et recettes, efface le terrain inspecté et
retire les contrôles, y compris lorsque le serveur intégré est en pause.
Les inspections n'accordent ni aptitude, ni découverte, ni recette persistante.

Les commandes d'administration Sanctuary utilisent la même règle. Les
outils de configuration native du monde réservés aux opérateurs sont masqués
hors de ce mode ; le réglage Allow Commands reste accessible à l'hôte selon
les conditions natives du jeu (notamment démo et hardcore).

## Fiche Habitant

La page reprend la sobriété de Hello World : personnage à gauche, familier à
droite et, entre les deux, les sections Nom, Biographie et Familier suivies de
leur contenu. Le nom conserve faction et prestige. Le nom personnalisé du
familier vient de son œuf équipé. Les textes d'aide sur le renommage, les
raccourcis et le consentement sont retirés de cette page ; restent le réglage
compact d'aide alliée et l'accès à l'historique.

Les aperçus ne font apparaître aucune entité de jeu et ne déclenchent pas d'IA.
Les modèles de bébé sont privilégiés, comme pour les familiers du monde.

Le cadrage du personnage tient compte de la largeur disponible : la hauteur
se réduit avant que les bras soient coupés. Le familier dispose de son propre
cadrage, adapté aussi aux grands modèles. Les textures existantes sont reprises.

Le HUD d’armure affiche uniquement les icônes pleines et les demi-icônes : les
emplacements vides sont supprimés, sans modifier les points de protection.

## Étoiles gagnées

Le ciel Sanctuary remplace les étoiles décoratives natives par un ciel partagé.
Avant tout événement, il est vide. Les événements enregistrés sont :

- première arrivée d'un habitant : une étoile, une seule fois pour son UUID ;
- advancement Minecraft accompli et normalement annonçable dans le chat : une
  étoile pour une tâche, trois pour un objectif, cinq pour un défi. Les étoiles
  supplémentaires restent proches de l'étoile principale ;
- prestige : une étoile pour chaque rang effectivement atteint ;
- faction atteignant deux membres, fondateur compris : une étoile.

Les critères partiels, recettes techniques, reconnexions, messages libres du
chat et créations de factions solitaires ne créent pas d'étoile. Couper les
annonces d'advancements dans les règles du monde ne coupe pas leur mémoire.
Un même advancement accompli par deux habitants donne deux groupes distincts ;
le retirer puis l'obtenir à nouveau avec le même habitant ne crée aucun doublon.

Une faction ne reçoit qu'une étoile à son premier duo. Le duo initial est
mémorisé indépendamment du nom et de l'identifiant de faction : dissoudre puis
recréer une faction avec ces deux mêmes personnes ne crée pas une autre étoile.
Un nouveau duo peut marquer une autre faction. Départs, exclusions et dissolution
ne retirent aucune étoile existante. Ce seuil remplace la proposition initiale
d'une étoile dès la fondation solitaire.

Les directions sont stables et communes aux clients du serveur. Le ciel
accomplit une rotation en sept jours réels, sur une référence UTC commune
synchronisée par le serveur. Le soleil et la lune conservent leur fonctionnement.
La visibilité nocturne et les effets de l'environnement restent natifs.
Le maillage graphique est conservé entre les images : il est reconstruit
seulement à l'arrivée de nouvelles étoiles ou lors du rechargement graphique.
Les deltas sont envoyés par lots ; les mouvements de caméra ne demandent aucun
calcul serveur et ne réattribuent pas les positions.

Le dessin passe par la méthode native de rendu des étoiles, pour conserver les
points d'intégration des moteurs de shaders. Un premier traitement Vanilla Light
est disponible dans les options ; voir [le contrat graphique](shaders-beta040.md)
pour son fonctionnement et l'état encore non validé des moteurs externes.

## Sauvegarde et reprise

Nouveau fichier additif `data/sanctuary-stars.json`, schéma 1, limité à
100 000 événements et 32 Mio. Chaque événement garde sa clé stable, son type,
l'habitant, son nom au moment de l'événement, sa source, sa date et son nombre
d'étoiles. L'écriture atomique vérifie le contenu précédent ; un fichier invalide
est préservé et suspend les ajouts, sans être remplacé par un ciel vide sauvegardé.

À la première ouverture avec ce système, les arrivées déjà attestées et le
journal des prestiges/factions sont repris. Les advancements déjà accomplis
sont repris à la connexion de leur habitant. Leur date d'étoile correspond à
cette reprise lorsque la date exacte n'est pas disponible. Les historiques
source, les sauvegardes personnelles et la génération des chunks ne sont pas
réécrits. Le journal stellaire ne dépend pas de l'inventaire ni du personnage
courant : mort et New Game+ conservent ses événements.

Le dessin de constellations, la sélection à la longue-vue et la consultation
Web ne sont pas inclus. Les événements structurés préparent ces usages sans
leur inventer d'interface dans cette livraison.

## Vérification

Les contrôles portent sur les autorisations et leur révocation, les tirages
stellaires déterministes, la sauvegarde/relecture, les vrais advancements,
le prestige, le seuil de deux membres et la conservation après dissolution.
Le parcours client utilise les boutons natifs de World Options, les aperçus
de plusieurs familiers et le rendu réel du ciel. `check build assemblePack
assembleTestPack` et 50 tests serveur passent, ainsi que le parcours client
natif avec les dernières modifications. Le test observe les appels de dessin
du HUD et le nombre d’indices de la passe stellaire native. Captures et reçu :
`build/operator040-evidence/final/`, `build/operator040-artifact.json`.
La connexion réseau dédiée n’a pas été testée ; le client à froid et le serveur
intégré ont été vérifiés.