Tracking
Descripción general
Tracking registra la posición de cada jugador a intervalos regulares. Cada vez que un jugador entra, empieza una nueva sesión, y la extensión le añade un punto (coordenadas, mundo y hora) cada pocos segundos hasta que el jugador se va. Las sesiones se guardan en un artefacto.
Los administradores pueden entonces inspeccionar una sesión. El recorrido se reproduce como un rastro animado de partículas de polvo alrededor del administrador y, si usas BlueMap, se dibuja en el mapa web como una línea con un marcador en cada punto. Es una buena herramienta para entender cómo se mueven los jugadores por una construcción, dónde se pierden, o para revisar una sesión sospechosa.
Características
- Registro de sesiones: una sesión por jugador y por inicio de sesión, con coordenadas, mundo y marca de tiempo.
- Intervalo configurable: un punto cada
pointIntervalSecondssegundos, 20 por defecto. - Reproducción en el juego: un rastro animado de partículas que solo ve el administrador que inspecciona.
- Visualización en BlueMap: una línea de recorrido con un color tomado del jugador y marcadores de punto opcionales.
- Almacenamiento persistente: las sesiones se escriben en un artefacto de TypeWriter unos segundos después de cada cambio.
- Tamaño acotado: se conservan como máximo 10 000 puntos por sesión.
- Compatible con Folia: los bucles de registro y de partículas usan planificadores seguros por región.
Instalación
- Instala PacketEvents, que TypeWriter ya requiere. El rastro de partículas se envía con él.
- Opcional: instala BlueMap para ver las sesiones en el mapa web.
- Coloca el JAR de Tracking en
plugins/Typewriter/extensions/y reinicia el servidor.
Primeros pasos
- En el panel web de TypeWriter, abre una página de manifiesto y añade un Tracking Artifact. Conserva su
artifactId(el valor por defecto estracking_storage). - Añade un Tracking Manifest y enlaza el artefacto en
storage. Sin un artefacto enlazado, no se registra nada. - Establece
pointIntervalSeconds(por ejemplo10) y comprueba quetrackingEnabledestá activado. - Publica. Los jugadores que entren a partir de ese momento tendrán una sesión. Los jugadores que ya estaban conectados cuando publicaste no la tendrán hasta que se reconecten.
- Pasado un tiempo, ejecuta
/tracking sessions <player>para listar los ids de sesión de un jugador. - Ejecuta
/tracking inspect <player> <session>para reproducir una sesión. Con BlueMap instalado, el recorrido también aparece en el mapa. - Ejecuta
/trackingsin argumentos para detener la inspección.
Tracking almacena las coordenadas exactas de tus jugadores, sin caducidad. Menciónalo en tus normas cuando la legislación local lo exija, y borra el archivo del artefacto cuando ya no necesites los datos.
Cómo funciona
Los ids de sesión son números asignados en orden entre todos los jugadores (1, 2, 3...), no por jugador. Una sesión termina cuando el jugador se desconecta.
Comandos
El comando es un comando de servidor estándar registrado como /tracking (también /typewriter:tracking), no un subcomando de /typewriter. Solo pueden usarlo los jugadores y requiere typewriter.tracking.inspect.
| Comando | Descripción |
|---|---|
/tracking sessions <player> | Lista los ids de sesión registrados de un jugador. |
/tracking inspect <player> | Lista los ids de sesión de un jugador. |
/tracking inspect <player> <session> | Empieza a inspeccionar una sesión: rastro de partículas para ti y, si está activado, marcadores de BlueMap. |
/tracking | Detiene tu inspección y elimina sus marcadores de BlueMap. |
Puedes inspeccionar a jugadores que estén desconectados, siempre que el servidor conozca su nombre.
Permisos
| Permiso | Concede |
|---|---|
typewriter.tracking.inspect | Todos los comandos /tracking. |
Configuración
Todos los ajustes están en la entrada Tracking Manifest. Solo se usa el primer manifiesto encontrado, y los cambios se aplican en unos pocos segundos.
trackingEnabledactiva o desactiva el registro. Al desactivarlo se dejan de añadir puntos. Solo se crean nuevas sesiones para los jugadores que entran mientras está activado.blueMapEnabled,showBlueMapPointsyshowBlueMapPathcontrolan lo que se dibuja en BlueMap. Si las dos opciones de visualización están desactivadas, no se dibuja nada.- El rastro solo se dibuja para los tramos situados a unos 30 bloques del administrador, en el mundo en el que se encuentra.
Entradas
2 entradas, generadas a partir del código fuente de la extensión.
Artefactos1
- Tracking ArtifactStores player tracking sessions and points
Manifiestos1
- Tracking ManifestMaster configuration for Player Tracking
Resolución de problemas
No se registra ninguna sesión. El manifiesto debe existir, tener trackingEnabled activado y un artefacto storage enlazado. Las sesiones empiezan cuando un jugador entra, así que los jugadores que estaban conectados antes de publicar deben reconectarse.
/tracking inspect dice "No tracking sessions found". El jugador aún no tiene ninguna sesión registrada, o el nombre es incorrecto. Ejecuta /tracking sessions <player>. Las sesiones necesitan al menos un punto para ser útiles: el primer punto se registra tras pointIntervalSeconds.
El rastro de partículas es invisible. Necesitas al menos 2 puntos en el mundo en el que te encuentras, y debes estar a unos 30 bloques del recorrido. El rastro solo es visible para el administrador que ejecuta la inspección.
No se muestra nada en BlueMap. BlueMap debe estar instalado y activado, blueMapEnabled debe estar activado con al menos una de las opciones de visualización, y el mundo de los puntos debe ser un mundo conocido por BlueMap. Los marcadores se eliminan cuando ejecutas /tracking.
Una sesión deja de crecer. Una sesión conserva como máximo 10 000 puntos. Con el intervalo por defecto, eso equivale a más de 55 horas de juego.
Los datos desaparecieron tras un fallo del servidor. Los datos se guardan 5 segundos después del último cambio y al descargar. Un fallo dentro de ese margen puede hacer perder los últimos puntos.