sanctuary-beta/docs/initial-loading.md

STARTUP-01 — raccourcir la création de monde

Branche : codex/initial-loading. Minecraft 26.3-pre-2, Fabric Loader 0.19.5, Fabric API 0.160.0+26.3. Correctif local beta.022, préparé à partir du chantier beta.021 ; publication et instance Prism distinctes.

Problème observé

Les plans d’eau, de traversées et de structures sont calculés avant l’arrivée. Le profil JFR du serveur de développement situe le coût surtout dans les bruits Perlin du champ PopulationIslandDensity. Le message Minecraft Time elapsed arrive après la planification : il sous-estime donc la création totale.

Correctif

Les bruits restent identiques, mais leur évaluation devient conditionnelle :

• À l’intérieur de radius - 128, le facteur d’érosion du bord est exactement nul. Le bruit du bord n’est pas nécessaire.
• À partir de Y140, le facteur d’érosion inférieur est exactement nul, même avec les bruits à leurs bornes maximales. Le bruit du dessous est inutile.
• Lorsque ces deux conditions sont réunies, les bruits de sculpture et de détail ne contribuent plus au champ, sauf dans l’ancienne variante à terrasses.
• À partir de Y320, avec le repère vertical normal, l’érosion haute vaut au moins 2 pour un terrain borné à 1 : la densité de base vaut exactement -1. Les corps flottants sont toujours ajoutés ensuite par FloatingTerrain306. La variante historique 30.4, qui déplace le repère vertical, garde son calcul.

Aucun plan n’est supprimé ou différé, aucun cache disque n’est ajouté. Les codecs, identifiants, graines et formats de sauvegarde restent inchangés. La suppression de calculs doit conserver exactement les mêmes valeurs, pas une approximation visuelle. Les essais utilisent uniquement des mondes de développement neufs.

Mesures

Mac Apple M1, 8 Gio, Java Temurin 25.0.3, tas JVM 2 Gio. Profil de départ Moyen 724, graine 0, structures actives, nouveau dossier de monde à chaque essai.

Mesure	Résultat
CPU de 441 colonnes, référence beta.021	médiane 706,874 ms
CPU des mêmes colonnes, correctif	médiane 567,929 ms
Réduction de CPU sur ce travail	19,66 %
Création serveur finale, du lancement du serveur de test à sa disponibilité	89 s
Préparation finale du spawn seule, incluse dans ces 89 s	4,578 s

Le benchmark CPU utilise la graine 42, 183 456 densités par passage, un échauffement puis trois paires alternées dans la même JVM. Les six empreintes sont identiques : d47c98ab8f10169c. Il mesure du calcul de terrain, pas un gain universel de 20 % sur la durée totale du lancement.

Le premier serveur profilé demandait 171 s, puis la première optimisation 132 s. D’autres constructions et tests tournaient pendant ces essais. Le dernier essai sans JFR atteint 89 s : ces trois temps ne prouvent pas à eux seuls une division par deux du chargement. Ils excluent le lancement du client, l’interface de création, le réseau et le rendu graphique. La planification restante prend encore du temps ; ce correctif ne rend pas la création instantanée.

Vérifications réussies

• Référence beta.021 figée dans StartupDensityReference : 588 288 comparaisons bit à bit réussies, champs actuels et legacy27, capacités 5/10/20/100 et graines 0, 42, -7228211907433324401. Colonnes traversant les seuils et coordonnées positives/négatives, modes scalaire et volume.
• Mesure CPU alternée dans une même JVM, sur les mêmes 441 colonnes complètes, pour distinguer le gain de calcul des variations de charge de la machine.
• ./gradlew check build assemblePack réussit en 7 min 17 s, avec les sélecteurs ci-dessous : tous les contrôles purs et 10 tests serveur réussis. Couverture native : équivalence, mesure CPU, anciennes expéditions, plans aériens, traversées, village et ruines asséchées.
• Le correctif testé dans build/startup-lab est intégré aux sources principales après contrôle des empreintes avant modification. Les travaux préexistants restent conservés. build assemblePack -x :sanctuary:check y réussit en 18 s : cette seconde commande assemble l’intégration et ne remplace pas le check réussi dans l’espace isolé. Les classes optimisées du JAR intégré sont identiques octet par octet à celles du serveur testé.
• Pas d’essai graphique ni de validation Windows pour ce correctif.

Commande de validation complète utilisée :

./gradlew check build assemblePack \
  -PsanctuaryFocusedTests=startup,expeditions,aerial,transit,village,drained \
  -PsanctuaryAerial24Tests=true -PsanctuaryTransit29Tests=true

Les preuves restent ignorées dans build/startup-evidence/, build/startup-check-build.log et build/startup-integrated-build.log. Le profil initial reste dans build/startup-baseline-preserved.jfr. Le mod et le pack prennent ensemble la version beta.022. Aucun tag, canal public ou installation Prism n’est modifié.

Export local : Sanctuary-beta.022.mrpack. Intégrité ZIP, dépendances exactes, absence de tests et identité du JAR embarqué vérifiées. Reçu : build/startup-evidence/artifact.json.

SHA-256 JAR : 53203075916e1f494e5cb73b6a28959170c7f9df26b6edd4746b3531d404f3d1. SHA-256 MRpack : 97545339b9f7c2465a8248e7fad018e694190ba5acf46aa38c3b40774aa55b56.