Tracking
Visão geral
O Tracking registra a posição de cada jogador em intervalos regulares. Cada vez que um jogador entra, uma nova sessão começa, e a extensão adiciona a ela um ponto (coordenadas, mundo e horário) a cada poucos segundos até o jogador sair. As sessões são salvas em um artifact.
Os admins podem então inspecionar uma sessão. O caminho é reproduzido como uma trilha animada de partículas de poeira ao redor do admin e, se você usa o BlueMap, desenhado no mapa web como uma linha com um marcador em cada ponto. É uma boa ferramenta para entender como os jogadores se movem por uma construção, onde se perdem, ou para revisar uma sessão suspeita.
Recursos
- Gravação de sessões — uma sessão por jogador a cada login, com coordenadas, mundo e carimbo de data e hora.
- Intervalo configurável — um ponto a cada
pointIntervalSecondssegundos, 20 por padrão. - Replay no jogo — uma trilha animada de partículas que só o admin que inspeciona vê.
- Exibição no BlueMap — uma linha de caminho com uma cor tirada do jogador e marcadores de ponto opcionais.
- Armazenamento persistente — as sessões são gravadas em um artifact do TypeWriter alguns segundos após cada alteração.
- Tamanho limitado — no máximo 10.000 pontos são mantidos por sessão.
- Compatível com Folia — os loops de gravação e de partículas usam schedulers seguros para regiões.
Instalação
- Instale o PacketEvents, que o TypeWriter já exige. A trilha de partículas é enviada por meio dele.
- Opcional: instale o BlueMap para ver as sessões no mapa web.
- Coloque o JAR do Tracking em
plugins/Typewriter/extensions/e reinicie o servidor.
Primeiros passos
- No painel web do TypeWriter, abra uma page manifest e adicione um Tracking Artifact. Mantenha o
artifactIddele (o padrão étracking_storage). - Adicione um Tracking Manifest e ligue o artifact em
storage. Sem um artifact ligado, nada é gravado. - Defina
pointIntervalSeconds(por exemplo10) e verifique setrackingEnabledestá ativado. - Publique. Os jogadores que entrarem a partir de agora terão uma sessão. Os jogadores que já estavam online quando você publicou não terão uma até se reconectarem.
- Depois de um tempo, execute
/tracking sessions <player>para listar os ids de sessão de um jogador. - Execute
/tracking inspect <player> <session>para reproduzir uma sessão. Com o BlueMap instalado, o caminho também aparece no mapa. - Execute
/trackingsem argumentos para encerrar a inspeção.
O Tracking armazena as coordenadas exatas dos seus jogadores, sem expiração. Mencione isso nas suas regras quando a legislação local exigir e apague o arquivo do artifact quando não precisar mais dos dados.
Como funciona
Os ids de sessão são números distribuídos em ordem entre todos os jogadores (1, 2, 3...), e não por jogador. Uma sessão termina quando o jogador sai.
Comandos
O comando é um comando de servidor padrão registrado como /tracking (também /typewriter:tracking), e não um subcomando de /typewriter. Ele só pode ser usado por jogadores e exige typewriter.tracking.inspect.
| Comando | Descrição |
|---|---|
/tracking sessions <player> | Lista os ids de sessão gravados para um jogador. |
/tracking inspect <player> | Lista os ids de sessão de um jogador. |
/tracking inspect <player> <session> | Inicia a inspeção de uma sessão: trilha de partículas para você e, se ativado, marcadores no BlueMap. |
/tracking | Encerra a sua inspeção e remove seus marcadores do BlueMap. |
Você pode inspecionar jogadores que estão offline, desde que o nome deles seja conhecido pelo servidor.
Permissões
| Permissão | Concede |
|---|---|
typewriter.tracking.inspect | Todos os comandos /tracking. |
Configuração
Todas as configurações ficam na entry Tracking Manifest. Apenas o primeiro manifest encontrado é usado, e as alterações são aplicadas em poucos segundos.
trackingEnabledliga ou desliga a gravação. Desligá-lo interrompe a adição de pontos. Novas sessões só são criadas para jogadores que entram enquanto ele está ligado.blueMapEnabled,showBlueMapPointseshowBlueMapPathcontrolam o que é desenhado no BlueMap. Se as duas opções de exibição estiverem desativadas, nada é desenhado.- A trilha é desenhada apenas para segmentos a cerca de 30 blocos do admin, no mundo em que o admin está.
Entries
2 entradas, geradas a partir do código-fonte da extensão.
Artefatos1
- Tracking ArtifactStores player tracking sessions and points
Manifestos1
- Tracking ManifestMaster configuration for Player Tracking
Solução de problemas
Nenhuma sessão é gravada. O manifest deve existir, ter trackingEnabled ativado e um artifact storage ligado. As sessões começam quando um jogador entra, então os jogadores que estavam online antes de você publicar precisam se reconectar.
/tracking inspect diz "No tracking sessions found". O jogador ainda não tem sessão gravada, ou o nome está errado. Execute /tracking sessions <player>. As sessões precisam de pelo menos um ponto para serem úteis: o primeiro ponto é gravado após pointIntervalSeconds.
A trilha de partículas está invisível. Você precisa de pelo menos 2 pontos no mundo em que está e deve estar a cerca de 30 blocos do caminho. A trilha só é visível para o admin que executa a inspeção.
Nada aparece no BlueMap. O BlueMap deve estar instalado e ativado, blueMapEnabled deve estar ligado com pelo menos uma das opções de exibição, e o mundo dos pontos deve ser um mundo conhecido pelo BlueMap. Os marcadores são removidos quando você executa /tracking.
Uma sessão para de crescer. Uma sessão mantém no máximo 10.000 pontos. No intervalo padrão, isso equivale a mais de 55 horas de jogo.
Dados desapareceram após uma falha. Os dados são salvos 5 segundos após a última alteração e ao descarregar. Uma falha dentro dessa janela pode perder os pontos mais recentes.