Tracking
Обзор
Tracking записывает позицию каждого игрока через регулярные интервалы. Каждый раз, когда игрок заходит на сервер, начинается новая сессия, и расширение добавляет в неё точку (координаты, мир и время) каждые несколько секунд, пока игрок не выйдет. Сессии сохраняются в артефакте.
Затем администраторы могут просмотреть сессию. Путь воспроизводится в виде анимированного следа из частиц пыли вокруг администратора и, если вы используете BlueMap, рисуется на веб-карте линией с маркером на каждой точке. Это хороший инструмент, чтобы понять, как игроки перемещаются по постройке, где они теряются, или чтобы проверить подозрительную сессию.
Возможности
- Запись сессий — одна сессия на игрока за каждый вход, с координатами, миром и временной меткой.
- Настраиваемый интервал — одна точка каждые
pointIntervalSecondsсекунд, по умолчанию 20. - Воспроизведение в игре — анимированный след из частиц, который видит только проверяющий администратор.
- Отображение на BlueMap — линия пути цвета, взятого у игрока, и необязательные маркеры точек.
- Постоянное хранение — сессии записываются в артефакт TypeWriter через несколько секунд после каждого изменения.
- Ограниченный размер — в каждой сессии хранится не более 10 000 точек.
- Совместимость с Folia — циклы записи и частиц используют планировщики, безопасные для регионов.
Установка
- Установите PacketEvents, который уже требуется для TypeWriter. След из частиц отправляется с его помощью.
- По желанию: установите BlueMap, чтобы видеть сессии на веб-карте.
- Поместите JAR-файл Tracking в
plugins/Typewriter/extensions/и перезапустите сервер.
Начало работы
- В веб-панели TypeWriter откройте страницу manifest и добавьте Tracking Artifact. Сохраните его
artifactId(по умолчаниюtracking_storage). - Добавьте Tracking Manifest и свяжите артефакт в
storage. Без связанного артефакта ничего не записывается. - Задайте
pointIntervalSeconds(например,10) и убедитесь, чтоtrackingEnabledвключён. - Опубликуйте. Игроки, которые зайдут с этого момента, получат сессию. У игроков, которые уже были в сети в момент публикации, её не будет, пока они не переподключатся.
- Через некоторое время выполните
/tracking sessions <player>, чтобы вывести список идентификаторов сессий игрока. - Выполните
/tracking inspect <player> <session>, чтобы воспроизвести сессию. Если установлен BlueMap, путь также появится на карте. - Выполните
/trackingбез аргументов, чтобы остановить просмотр.
Tracking хранит точные координаты ваших игроков без срока хранения. Упомяните об этом в правилах, если этого требует местное законодательство, и очищайте файл артефакта, когда данные вам больше не нужны.
Как это работает
Идентификаторы сессий — это числа, выдаваемые по порядку для всех игроков (1, 2, 3...), а не для каждого игрока отдельно. Сессия заканчивается, когда игрок выходит.
Команды
Команда — это стандартная серверная команда, зарегистрированная как /tracking (также /typewriter:tracking), а не подкоманда /typewriter. Её могут использовать только игроки, и ей нужно typewriter.tracking.inspect.
| Команда | Описание |
|---|---|
/tracking sessions <player> | Вывести список идентификаторов сессий, записанных для игрока. |
/tracking inspect <player> | Вывести список идентификаторов сессий игрока. |
/tracking inspect <player> <session> | Начать просмотр сессии: след из частиц для вас и, если включено, маркеры BlueMap. |
/tracking | Остановить просмотр и убрать его маркеры BlueMap. |
Вы можете просматривать игроков, которых нет в сети, если их имя известно серверу.
Права
| Право | Что даёт |
|---|---|
typewriter.tracking.inspect | Все команды /tracking. |
Конфигурация
Все параметры находятся в записи Tracking Manifest. Используется только первый найденный манифест, а изменения подхватываются в течение нескольких секунд.
trackingEnabledвключает или выключает запись. Выключение прекращает добавление точек. Новые сессии создаются только для игроков, которые зашли, пока запись включена.blueMapEnabled,showBlueMapPointsиshowBlueMapPathуправляют тем, что рисуется на BlueMap. Если обе опции показа выключены, ничего не рисуется.- След рисуется только для отрезков примерно в 30 блоках от администратора, в том мире, где находится администратор.
Записи
Записей: 2, сгенерированы из исходного кода расширения.
Артефакты1
- Tracking ArtifactStores player tracking sessions and points
Манифесты1
- Tracking ManifestMaster configuration for Player Tracking
Устранение неполадок
Ни одна сессия не записывается. Манифест должен существовать, у него должен быть включён trackingEnabled и связан артефакт storage. Сессии начинаются, когда игрок заходит, поэтому игрокам, которые были в сети до публикации, нужно переподключиться.
/tracking inspect сообщает «No tracking sessions found». У игрока ещё нет записанной сессии или имя неверно. Выполните /tracking sessions <player>. Чтобы сессия была полезной, в ней должна быть хотя бы одна точка: первая точка записывается через pointIntervalSeconds.
След из частиц не виден. Вам нужно как минимум 2 точки в мире, в котором вы находитесь, и вы должны быть в пределах примерно 30 блоков от пути. След виден только администратору, запустившему просмотр.
На BlueMap ничего не показывается. BlueMap должен быть установлен и включён, blueMapEnabled должен быть включён вместе по крайней мере с одной из опций показа, а мир точек должен быть известен BlueMap. Маркеры убираются, когда вы выполняете /tracking.
Сессия перестаёт расти. В сессии хранится не более 10 000 точек. При интервале по умолчанию это более 55 часов игры.
Данные пропали после сбоя. Данные сохраняются через 5 секунд после последнего изменения и при выгрузке. Сбой в этот промежуток может привести к потере последних точек.