Tracking
Présentation
Tracking enregistre la position de chaque joueur à intervalle régulier. Chaque fois qu'un joueur se connecte, une nouvelle session démarre, et l'extension y ajoute un point (coordonnées, monde et heure) toutes les quelques secondes jusqu'à ce que le joueur quitte. Les sessions sont sauvegardées dans un artifact.
Les administrateurs peuvent ensuite inspecter une session. Le trajet est rejoué sous forme de traînée animée de particules de poussière autour de l'administrateur et, si vous utilisez BlueMap, dessiné sur la carte web sous la forme d'une ligne avec un marqueur sur chaque point. C'est un bon outil pour comprendre comment les joueurs se déplacent dans une construction, où ils se perdent, ou pour examiner une session suspecte.
Fonctionnalités
- Enregistrement de sessions — une session par joueur et par connexion, avec coordonnées, monde et horodatage.
- Intervalle configurable — un point tous les
pointIntervalSecondssecondes, 20 par défaut. - Rejeu en jeu — une traînée animée de particules que seul l'administrateur qui inspecte voit.
- Affichage BlueMap — une ligne de trajet dans une couleur tirée du joueur, et des marqueurs de points facultatifs.
- Stockage persistant — les sessions sont écrites dans un artifact TypeWriter quelques secondes après chaque modification.
- Taille bornée — au plus 10 000 points sont conservés par session.
- Compatible Folia — les boucles d'enregistrement et de particules utilisent des schedulers sûrs par région.
Installation
- Installez PacketEvents, que TypeWriter exige déjà. La traînée de particules est envoyée grâce à lui.
- Facultatif : installez BlueMap pour voir les sessions sur la carte web.
- Placez le JAR de Tracking dans
plugins/Typewriter/extensions/et redémarrez le serveur.
Premiers pas
- Dans le panneau web de TypeWriter, ouvrez une page manifest et ajoutez un Tracking Artifact. Conservez son
artifactId(par défauttracking_storage). - Ajoutez un Tracking Manifest et liez l'artifact dans
storage. Sans artifact lié, rien n'est enregistré. - Définissez
pointIntervalSeconds(par exemple10) et vérifiez quetrackingEnabledest activé. - Publiez. Les joueurs qui se connectent à partir de maintenant obtiennent une session. Les joueurs déjà en ligne au moment de la publication n'en ont pas tant qu'ils ne se reconnectent pas.
- Après un moment, exécutez
/tracking sessions <player>pour lister les identifiants de session d'un joueur. - Exécutez
/tracking inspect <player> <session>pour rejouer une session. Avec BlueMap installé, le trajet apparaît aussi sur la carte. - Exécutez
/trackingsans argument pour arrêter l'inspection.
Tracking stocke les coordonnées exactes de vos joueurs, sans date d'expiration. Mentionnez-le dans votre règlement là où la loi locale l'exige, et videz le fichier de l'artifact lorsque vous n'avez plus besoin des données.
Fonctionnement
Les identifiants de session sont des nombres attribués dans l'ordre pour l'ensemble des joueurs (1, 2, 3...), et non par joueur. Une session se termine lorsque le joueur quitte le serveur.
Commandes
La commande est une commande de serveur standard enregistrée sous /tracking (ainsi que /typewriter:tracking), et non une sous-commande de /typewriter. Elle n'est utilisable que par des joueurs et nécessite typewriter.tracking.inspect.
| Commande | Description |
|---|---|
/tracking sessions <player> | Liste les identifiants de session enregistrés pour un joueur. |
/tracking inspect <player> | Liste les identifiants de session d'un joueur. |
/tracking inspect <player> <session> | Commence l'inspection d'une session : traînée de particules pour vous et, si activés, marqueurs BlueMap. |
/tracking | Arrête votre inspection et retire ses marqueurs BlueMap. |
Vous pouvez inspecter des joueurs hors ligne, tant que leur nom est connu du serveur.
Permissions
| Permission | Autorise |
|---|---|
typewriter.tracking.inspect | Toutes les commandes /tracking. |
Configuration
Tous les paramètres se trouvent dans l'entrée Tracking Manifest. Seul le premier manifest trouvé est utilisé, et les modifications sont prises en compte en quelques secondes.
trackingEnabledactive ou désactive l'enregistrement. Le désactiver arrête l'ajout de points. De nouvelles sessions ne sont créées que pour les joueurs qui se connectent tant qu'il est activé.blueMapEnabled,showBlueMapPointsetshowBlueMapPathcontrôlent ce qui est dessiné sur BlueMap. Si les deux options d'affichage sont désactivées, rien n'est dessiné.- La traînée n'est dessinée que pour les segments situés à environ 30 blocs de l'administrateur, dans le monde où il se trouve.
Entrées
2 entrées, générées depuis la source de l'extension.
Artefacts1
- Tracking ArtifactStores player tracking sessions and points
Manifestes1
- Tracking ManifestMaster configuration for Player Tracking
Dépannage
Aucune session n'est enregistrée. Le manifest doit exister, avoir trackingEnabled activé et un artifact storage lié. Les sessions démarrent lorsqu'un joueur se connecte ; les joueurs qui étaient en ligne avant votre publication doivent donc se reconnecter.
/tracking inspect indique « No tracking sessions found ». Le joueur n'a pas encore de session enregistrée, ou le nom est erroné. Exécutez /tracking sessions <player>. Une session a besoin d'au moins un point pour être utile : le premier point est enregistré après pointIntervalSeconds.
La traînée de particules est invisible. Il vous faut au moins 2 points dans le monde où vous vous trouvez, et vous devez être à environ 30 blocs du trajet. La traînée n'est visible que par l'administrateur qui lance l'inspection.
Rien ne s'affiche sur BlueMap. BlueMap doit être installé et activé, blueMapEnabled doit être activé avec au moins une des options d'affichage, et le monde des points doit être un monde connu de BlueMap. Les marqueurs sont retirés lorsque vous exécutez /tracking.
Une session cesse de grandir. Une session conserve au plus 10 000 points. À l'intervalle par défaut, cela représente plus de 55 heures de jeu.
Des données ont disparu après un plantage. Les données sont sauvegardées 5 secondes après la dernière modification et au déchargement. Un plantage dans cette fenêtre peut faire perdre les derniers points.