v1.0.1

Cette mise à jour corrige des bugs et renforce le Quantum Digital Miner, le Contrôleur de réseau quantique et le Digital Miner Companion. Elle n’ajoute aucune machine et ne change aucun ingrédient ni résultat de recette. Un comportement change, à la demande du propriétaire : le Digital Miner Companion oublie désormais un mineur qui a été cassé (voir Changements).

Pourquoi la 1.0.1 est un grand pas

Mesuré par rapport au code de la 1.0.0 sur les mêmes benchmarks automatisés :

• Recherche du Quantum Digital Miner : de 63 % à 94 % de mémoire en moins sur le thread principal du serveur, un tick le plus chargé environ 59 % plus court pendant une recherche de rayon 128, et une recherche sans rien à trouver environ 88 % plus rapide une fois à chaud, pour les mêmes blocs trouvés.
• Écran du Contrôleur de réseau quantique : environ 72 % de mémoire en moins et plus d’un tiers de temps en moins pour construire sa vue.
• Écran du Digital Miner Companion : environ 71 % de mémoire en moins et environ 45 % de temps en moins pour se rafraîchir avec 128 filtres, 84 % de mémoire en moins après un scan terminé, et plus aucune allocation lors des clics de navigation.
• 16 corrections (plantages évités dans le tick du serveur, objets qui ne se perdent plus au craft, chunk qui n’est plus chargé par un écran ouvert, recettes qui fonctionnent avec des ingrédients configurés, liste des fréquences et dernière destination du téléporteur portable).
• Qualité du code : alertes d’analyse statique passées de 619 à 385 (−38 %), et tests automatisés en monde passés de 397 à 514.

La version 1.0.2 poursuit l’optimisation du mod.

Compatibilité

• Minecraft 1.21.1, Java 21 et NeoForge 21.1.200 ou plus récent dans la série 21.1. Testé avec les cinq builds stables de Mekanism, de 10.7.15.81 à 10.7.19.85. Mekanism 10.7.20 et les versions suivantes sont hors de la plage acceptée par ce build.
• Testé avec Mekanism Extras 1.3.4 et 1.4.1.
• Installer la 1.0.1 à la fois sur le client et sur le serveur. Le protocole réseau suit la version du mod : un client 1.0.0 ne peut pas rejoindre un serveur 1.0.1, et un client 1.0.1 ne peut pas rejoindre un serveur 1.0.0. Mettre à jour les deux côtés ensemble.
• Les mondes créés avec la 1.0.0 s’ouvrent sans changement : aucun changement du format de sauvegarde, et un monde créé avec la 1.0.0 est rouvert par la 1.0.1 dans le test de migration sur serveur dédié du projet. Sauvegarder les mondes avant de mettre à jour des mods, comme toujours.

Changements

• Digital Miner Companion : il oublie désormais un Mineur digital ou un Quantum Digital Miner qui a été cassé ou remplacé et repasse de lui-même à l’état non lié, qu’il soit en main, dans l’écran ouvert ou dans l’inventaire. Un mineur simplement hors de portée, ou dans un chunk ou une dimension non chargés, garde son lien. Les filtres en brouillon et les réglages du Companion restent.

Corrections

• Recette du Quantum Digital Miner : il se fabrique désormais quand ses ingrédients sont déjà configurés. La recette à données de Mekanism ne donnait aucun résultat dans une grille de craft, y compris le Crafting Terminal d’Applied Energistics 2, quand les améliorations des ingrédients dépassaient ensemble ce qu’une machine accepte (par exemple 8 Mises à niveau de la vitesse dans le Mineur digital et dans un Importeur du OQO), quand les ingrédients avaient des propriétaires différents, ou quand un Mineur digital au tampon plein tenait dans son emplacement d’énergie un objet que le résultat refuse. Le Quantum Digital Miner garde les améliorations, les objets, l’énergie et le propriétaire du Mineur digital ; les améliorations des autres ingrédients, installées ou rangées dans leurs emplacements, et tout objet que le résultat ne peut pas prendre reviennent sous forme d’objets dans le résultat du craft, sans rien perdre ni dupliquer. Ingrédients, motif et résultat sont inchangés.
• Même chose pour les recettes de la Quantum Fluid Pump, du Petrogenic Synthesizer, de la Petrogenic Synthesis Plant, des Récepteurs d’énergie quantique Advanced, Elite et Ultimate, du Quantum Portable Teleporter et du Quantum Chargepad : la grille affiche toujours un résultat (elle n’en affichait aucun quand les ingrédients avaient des propriétaires différents, trop d’améliorations, une amélioration que la machine n’accepte pas, ou un objet ou un fluide que le résultat refuse), et ce que le résultat ne peut pas prendre revient dans le résultat du craft : les améliorations en objets, les objets stockés, les fluides en seaux. Les objets dans les emplacements d’un Cube d’énergie, les améliorations et les fluides d’un Entangloporteur quantique sont aussi rendus quand le résultat n’a pas d’emplacements, d’améliorations ou de réservoir pour eux (ils disparaissaient). Seul ce qu’un seau ne peut pas contenir (moins de 1 000 mB d’un fluide) est perdu. Si les restes ne tiennent pas dans les neuf cases de la grille, celle-ci n’affiche aucun résultat plutôt que de perdre quoi que ce soit.
• Contrôleur d’améliorations de précision : les types d’améliorations ajoutés par Mekanism Extras restent désormais dans l’écran. Utiliser les flèches ou la molette de la souris sur les tuiles d’améliorations pour atteindre la page suivante. Les actions du contrôleur gèrent désormais les types d’améliorations supplémentaires.
• Quantum Fluid Pump et Petrogenic Synthesis Plant : elles gardent les améliorations prévues quand Mekanism Extras remplace la liste des améliorations acceptées par les machines.
• Les quatre Récepteurs d’énergie quantique, le Quantum Entangloporter radioactif, le Contrôleur de réseau quantique et le Quantum Chargepad se récupèrent désormais quand on les mine à la pioche en survie. Ils demandaient le bon outil, comme toute machine de Mekanism, mais manquaient au tag des pioches et ne lâchaient rien. Le Quantum Entangloporter radioactif reste incassable tant que sa fréquence contient des déchets.
• Quantum Digital Miner, recherche : si l’analyse d’un chunk échouait au moment précis où la recherche était jugée terminée, le mineur pouvait prendre la zone partielle pour une zone complète et la miner. Il s’arrête désormais, comme pour toute recherche échouée.
• Quantum Digital Miner, déplacement : si la sauvegarde d’un bloc voisin du site de déplacement échouait, le déplacement pouvait laisser un enregistrement d’annulation que le démarrage suivant du serveur rejouait par-dessus tout ce qui avait été sauvegardé depuis. L’enregistrement d’annulation n’est désormais écrit qu’une fois ces blocs voisins lus avec succès. Le format de l’enregistrement et l’ordre des sauvegardes sont inchangés.
• Quantum Digital Miner, minage : un bloc d’un autre mod qui arrête ou réinitialise le mineur pendant qu’il est miné pouvait faire lever une exception au mineur dans le tick du serveur. Il garde désormais les drops du bloc déjà miné et abandonne ou garde la recherche comme l’arrêt ou la réinitialisation le demande. Un deuxième mineur (ou laser) qu’un autre mod lance depuis un tel bloc ne fait plus perdre au premier le collecteur de drops partagé de Mekanism, si bien que les drops supplémentaires du premier mineur (comme la moitié haute d’une porte ou d’une plante) ne tombent plus dans le monde au lieu d’aller dans son tampon.
• Contrôleur de réseau quantique : un écran ouvert ne charge plus le chunk d’un bloc voisin pour nommer l’endroit où un Entangloporteur quantique éjecte. Un objet, un fluide ou un chemical d’un autre mod dont le nom ne peut pas être lu ne lève plus d’exception dans le tick du serveur : l’entrée est listée sous son nom de registre.
• Contrôleur de réseau quantique : la fréquence choisie est désormais identifiée par son type, son nom, son mode et son propriétaire au lieu de sa place dans la liste triée, si bien qu’une fréquence qui apparaît ou disparaît ne fait plus basculer l’écran sur un autre réseau. Une fréquence invisible pour le joueur est traitée exactement comme avant : rien n’est révélé à son sujet.
• Digital Miner Companion : cliquer sur « page suivante » dans le même tick que l’ajout d’un filtre pouvait faire lever une exception au menu dans le tick du joueur ; le numéro de page ne peut plus déborder.
• Digital Miner Companion : une erreur en signalant la fin d’un déplacement ne saute plus les signalements des autres déplacements qui se terminent dans le même tick, et un aperçu de déplacement qui lit des blocs d’un autre mod ne peut plus arrêter la vue du Companion.
• L’index du Quantum Digital Miner et les files du Contrôleur de réseau quantique restent bornés lors d’un chargement de chunks intense ou simultané, et un coût fractionnaire invalide ne peut plus fausser l’estimation du Companion.
• Réglages du serveur : le réglage maxReach du Companion (section surveyor) est supprimé. Il n’avait aucun effet ; le Companion utilise la portée propre à Minecraft. Une valeur laissée dans un fichier de configuration existant est ignorée.
• Quantum Portable Teleporter, liste des Téléporteurs : un clic sur une fréquence n’était pas toujours pris en compte. Les trois champs de coordonnées, masqués dans ce mode, gardaient leur zone de clic au-dessus de la liste et avalaient la plupart des clics (un clic droit à cet endroit effaçait ce qui avait été saisi, et le clavier restait capturé). La ligne cliquée reste aussi en surbrillance pendant que le serveur répond, au lieu de revenir un instant à l’ancienne fréquence.
• Quantum Portable Teleporter, dernière destination : elle suit désormais chaque saut effectué, l’arrivée d’un saut vers un Téléporteur ou vers un endroit aléatoire comme les coordonnées saisies pour un saut vers des coordonnées. Elle ne suivait que ces dernières : après tout autre saut, l’écran affichait encore une destination plus ancienne.

Performances

Ces chiffres viennent des benchmarks automatisés du projet sur une seule machine de développement, pas d’un modpack, et décrivent le travail fait par le thread du serveur, pas les images par seconde. Ils comparent la 1.0.1 au code de la 1.0.0 exécuté sur les mêmes tests, en trois séries de cinq exécutions alternées ; une différence n’est signalée que si elle dépasse l’écart entre les exécutions.

• Recherche du Quantum Digital Miner : le thread principal du serveur ne copie plus les sections de chunk dont chaque état de bloc est déjà refusé par les workers de recherche. Dans les zones du benchmark, il alloue de 63 % à 94 % de mémoire en moins sur ce thread, son tick le plus chargé pendant une recherche de rayon 128 est environ 59 % plus court (1,3 ms contre 0,55 ms) et une recherche à chaud dans une zone sans rien à trouver prend environ 88 % de temps en moins, et la recherche trouve les mêmes blocs. La toute première recherche après le démarrage du serveur, dans une zone où beaucoup de sections de chunk doivent être lues, peut prendre environ 1 ms de temps serveur de plus qu’en 1.0.0, une seule fois ; chaque recherche suivante est aussi rapide ou plus rapide.
• Contrôleur de réseau quantique : la construction de la vue de l’écran examine chaque machine liée une seule fois au lieu de plusieurs et ne construit les détails des machines que pour les lignes envoyées. Avec 32 fréquences et 50 machines sur une même fréquence, un rafraîchissement alloue environ 72 % de mémoire en moins et prend plus d’un tiers de temps en moins, et les données envoyées au client sont identiques octet pour octet.
• Digital Miner Companion : le rafraîchissement de son écran trie une seule fois les types de blocs d’un scan terminé, garde les filtres décodés du brouillon tant que la liste ne change pas et ne lit l’objet que lorsqu’un clic en a besoin. Un rafraîchissement avec 128 filtres en brouillon alloue environ 71 % de mémoire en moins et prend environ 45 % de temps en moins ; après un scan terminé de 200 types de blocs, il alloue environ 84 % de moins ; un clic de navigation n’alloue plus rien. Les données envoyées au client sont identiques octet pour octet.
• Les benchmarks des machines, des menus et des vérifications du téléporteur qui existent dans les deux versions ont aussi été exécutés sur le code de la 1.0.0 : aucun n’était plus lent de façon reproductible qu’en 1.0.0 au-delà de l’écart entre les exécutions.
• Minage actif du Quantum Digital Miner : aucun gain n’est revendiqué ; mesuré à chaud ou isolément, il coûte autant qu’en 1.0.0.
• Le premier Quantum Digital Miner posé après le démarrage du jeu coûte au serveur autant qu’en 1.0.0 : environ 35 ms contre 33 ms dans un benchmark de démarrage à froid, dans l’écart entre les exécutions, avec une classe chargée en moins et 1 % de mémoire allouée en moins. Les poses suivantes coûtent aussi autant.

Validation et périmètre

Le code source final a passé les neuf tâches automatiques de la CI du projet sous Linux, y compris les quatre versions antérieures de Mekanism. Sous Windows, il a passé 211 tests unitaires, 514 GameTests en monde sur des mondes neufs (deux fois) avec 186 compteurs de performance déterministes, la migration d’un monde créé avec la 1.0.0 (258 vérifications), la reprise après un déplacement interrompu (26 scénarios : kill, exception, erreur fatale et arrêt normal), le banc d’écrans en anglais et en français (72 cas), et deux builds propres qui ont produit le même JAR. Avec Mekanism Extras 1.3.4 et 1.4.1 chargés, le banc d’écrans passe (72 cas chacun) et les 514 tests en monde aussi. La comparaison avec la 1.0.0 ci-dessus a été faite avant les dernières corrections de recette, d’écran du téléporteur et du Companion, qui ne touchent pas au code mesuré.

Le propriétaire a joué avec ce JAR exact dans une copie de sa base All the Mods 10, sur un serveur dédié : les corrections de recette, du téléporteur et du Companion viennent de ce test et y ont été vérifiées à nouveau.

Le code de recherche, de déplacement et de block entity du Quantum Digital Miner, la vue et l’index du Contrôleur de réseau quantique, et l’écran et les adaptateurs du Digital Miner Companion ont été réorganisés en classes plus petites pour la maintenabilité, avec les mêmes résultats, les mêmes coûts et le même format de sauvegarde. Chaque correction ci-dessus a été reproduite par un test qui échouait sur l’ancien code et passe désormais. Non testé : deux clients LAN authentifiés, et une charge prolongée dans une grosse base de modpack.

Mekanism: Engineering est un addon non officiel, indépendant de l’équipe de Mekanism. Guides des joueurs · Notes de version et validation.