HyTari Studios · Guide officiel de configuration

Server Diagnostics

Des correctifs ciblés toujours actifs, des diagnostics lourds seulement quand nécessaire.

Server Diagnostics corrige des cas spécifiques et validés sans devenir un système de nettoyage générique. Le profil recommandé est opérationnel et discret : correctifs automatiques ON, diagnostics profonds OFF.

COMMENCER LE GUIDE PAGE DU MOD

AVANT DE COMMENCER

Bien démarrer

ÉTAPE 01

Installer et démarrer

La configuration générée est déjà le profil recommandé.

ÉTAPE 02

Garder les correctifs actifs

Rotation Fix et Tracker Cleanup sont les modules automatiques validés.

ÉTAPE 03

Activer le debug seulement si nécessaire

EntityTracker Diagnostics est un outil d'enquête, pas une obligation.

Server Diagnostics suit une philosophie fail-open avec des correctifs étroits : les cas incertains sont laissés à Hytale au lieu d'appliquer un nettoyage générique.

CHAPITRE 01 · 1 EXEMPLES

Profil de production

Une configuration propre est déjà prête pour une utilisation normale.

01PROPERTIES

Profil de production recommandé

Sur une installation propre, les correctifs validés sont actifs tandis que les outils coûteux restent désactivés.

PROPERTIES
enabled=true

module.flyingNpcRotationFix.enabled=true
module.flyingNpcRotationFix.debug=false

module.droppedItemTrackerCleanup.enabled=true
module.droppedItemTrackerCleanup.dryRun=false

module.entityTrackerDiagnostics.enabled=false
module.entityTrackerDiagnostics.debug=false

mods/ServerDiagnostics/config.properties

CE QUE ÇA FAIT

Sur une installation propre, les correctifs validés sont actifs tandis que les outils coûteux restent désactivés.

COMPORTEMENT IMPORTANT

  • dryRun=false signifie que le cleanup validé est réellement actif.
  • Les diagnostics profonds ne sont pas requis pour le fonctionnement du cleanup.
  • Le profil normal est conçu pour être discret et léger.

CHAPITRE 02 · 1 EXEMPLES

Flying NPC Rotation Fix

Répare uniquement les valeurs de roll non finies NaN/Infinity sur les modèles volants configurés.

01PROPERTIES

Correction de rotation des NPC volants

Vérifie les modèles configurés à leur entrée dans l'ECS et ne corrige que les rotations non finies.

PROPERTIES
module.flyingNpcRotationFix.enabled=true
module.flyingNpcRotationFix.debug=false

config.properties

CE QUE ÇA FAIT

Vérifie les modèles configurés à leur entrée dans l'ECS et ne corrige que les rotations non finies.

COMPORTEMENT IMPORTANT

  • Ne modifie pas l'IA, le pathfinding, la vitesse, les règles de spawn ni les rotations valides.
  • Le préfixe de modèle éligible par défaut reste NPC/Flying_.
  • Laissez le debug désactivé sauf enquête sur un cas précis.

CHAPITRE 03 · 1 EXEMPLES

Dropped Item Tracker Cleanup

Supprime uniquement les updates déjà invalides pouvant être corrélées en toute sécurité à des dropped items supprimés.

01PROPERTIES

Cleanup EntityTracker des dropped items

Intervient entre la mise en file des updates et l'envoi des paquets, uniquement si une référence invalide peut être corrélée en sécurité à un dropped item déjà supprimé.

PROPERTIES
module.droppedItemTrackerCleanup.enabled=true
module.droppedItemTrackerCleanup.dryRun=false
module.droppedItemTrackerCleanup.logToFile=true
module.droppedItemTrackerCleanup.summaryIntervalSeconds=300

config.properties

CE QUE ÇA FAIT

Intervient entre la mise en file des updates et l'envoi des paquets, uniquement si une référence invalide peut être corrélée en sécurité à un dropped item déjà supprimé.

COMPORTEMENT IMPORTANT

  • Ne modifie pas les dropped items vivants, ItemStacks, quantités, timers pickup/despawn ni les updates valides.
  • Les conditions inattendues sont fail-open afin que Hytale traite le cas normalement.
  • L'intervalle de résumé de 300 secondes évite le spam en production.

CHAPITRE 04 · 1 EXEMPLES

Diagnostics profonds

Outils d'observation uniquement pour les enquêtes EntityTracker/ECS.

01PROPERTIES

Activer les diagnostics profonds temporairement

Lors d'une enquête sur EntityTracker/ECS, le module d'observation peut être activé.

PROPERTIES
module.entityTrackerDiagnostics.enabled=true
module.entityTrackerDiagnostics.debug=true

config.properties

CE QUE ÇA FAIT

Lors d'une enquête sur EntityTracker/ECS, le module d'observation peut être activé.

COMPORTEMENT IMPORTANT

  • Il peut produire beaucoup plus de télémétrie locale et des fichiers plus volumineux.
  • Il enregistre du contexte sur les archétypes ECS, composants, cycles de vie, viewers et corrélations.
  • Après l'enquête, revenez au profil minimal.

CHAPITRE 05 · 1 EXEMPLES

Logs et rétention

Un fichier persistant par catégorie, compacté au démarrage et à l'arrêt.

01PROPERTIES

Rétention par catégorie

Le mod conserve un fichier par catégorie et retire les anciens enregistrements du même fichier.

PROPERTIES
logs.retention.enabled=true
logs.retention.entityTrackerDays=3
logs.retention.entityArchetypesDays=5
logs.retention.dropTrackerCleanupDays=3
logs.retention.flyingNpcRotationDays=5

config.properties

CE QUE ÇA FAIT

Le mod conserve un fichier par catégorie et retire les anciens enregistrements du même fichier.

COMPORTEMENT IMPORTANT

  • La compaction s'effectue à l'initialisation et lors d'un arrêt propre.
  • Il ne crée pas une infinité de fichiers quotidiens uniquement pour la rétention.
  • Les logs restent locaux au serveur et ne sont pas envoyés par le mod.

Avant d'utiliser un exemple

Aucune commande joueur ni permission n'est requise.

Les logs peuvent contenir du contexte utile au diagnostic ; vérifiez-les avant publication.

Des compteurs de cleanup à zéro ne signifient pas nécessairement que le mod ne fonctionne pas : le cas ciblé peut simplement ne pas s'être produit.

RETOUR EN HAUT