https://github.com/flyawaymaking/trackplayer
TrackPlayer - плагин для отслеживания статистики игроков на серверах Minecraft (учет смертей, PvP-убийств и убийств враждебных мобов) с поддержкой PlaceholderAPI.
https://github.com/flyawaymaking/trackplayer
minecraf-plugins minecraft papermc placeholderapi plugins statistics
Last synced: about 2 months ago
JSON representation
TrackPlayer - плагин для отслеживания статистики игроков на серверах Minecraft (учет смертей, PvP-убийств и убийств враждебных мобов) с поддержкой PlaceholderAPI.
- Host: GitHub
- URL: https://github.com/flyawaymaking/trackplayer
- Owner: flyawaymaking
- License: mit
- Created: 2025-10-17T17:50:46.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-12-10T21:32:53.000Z (6 months ago)
- Last Synced: 2025-12-11T08:51:35.885Z (6 months ago)
- Topics: minecraf-plugins, minecraft, papermc, placeholderapi, plugins, statistics
- Language: Java
- Homepage:
- Size: 71.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TrackPlayer - Плагин статистики для Minecraft
Плагин для отслеживания статистики игроков на серверах Minecraft Paper 1.21.10. Ведет учет смертей, убийств игроков и враждебных мобов.
## 📊 Функциональность
### Отслеживаемые показатели:
- **Количество смертей** игрока
- **Количество убийств** других игроков
- **Количество убитых враждебных мобов**
## ⚡ Оптимизация производительности
### Оптимизация использования памяти
- **Ленивая загрузка данных** - данные загружаются только для онлайн-игроков
- **Автоматическое управление памятью** - данные удаляются из памяти при выходе игрока
- **Синхронизированные операции** - обеспечена потокобезопасность при работе с данными
### Враждебные мобы которые отслеживаются:
```
Zombie, Drowned, Husk, Skeleton, Stray, Wither Skeleton, Spider, Cave Spider,
Creeper, Enderman, Witch, Blaze, Ghast, Magma Cube, Slime, Guardian, Elder Guardian,
Shulker, Endermite, Vex, Vindicator, Evoker, Pillager, Ravager, Hoglin, Zoglin,
Piglin Brute, Warden, Breeze, Ender Dragon, Wither, Phantom, Silverfish
```
## 🛠️ Установка
1. Скачайте **последний релиз** из раздела [Releases](../../releases)
2. Поместите его в папку /plugins
3. Перезапустите сервер
4. Настройте config.yml при необходимости
5. Используйте /trackplayer reload, чтобы применить изменения без перезапуска
**Зависимости:**
- Paper 1.21.10 (обязательно)
- PlaceholderAPI (рекомендуется)
## 💬 Placeholders
Плагин предоставляет следующие плейсхолдеры для использования в других плагинах:
```
%trackplayer_kills% - количество убийств игроков
%trackplayer_deaths% - количество смертей
%trackplayer_mob_kills% - количество убитых враждебных мобов
```
### Примеры использования:
- В таблице лидеров: `%trackplayer_kills%`
- В голограммах: `"Убийств: %trackplayer_kills%"`
- В чат-плагинах: `"Ваша статистика: K:%trackplayer_kills% D:%trackplayer_deaths%"`
## 🔧 Команды
### Основные команды:
```
/trackplayer - посмотреть свою статистику
/trackplayer <ник> - посмотреть статистику другого игрока
/trackplayer reload - перезагрузить конфигурацию
```
### Админ-команды:
```
/trackplayer admin list - список убийств мобов всеми игроками
/trackplayer admin resetmobs - сбросить статистику мобов у всех игроков
/trackplayer admin save - принудительно сохранить данные
/trackplayer admin status - статус системы
/trackplayer admin papi - диагностика плейсхолдеров
```
## 📡 API для разработчиков
Плагин предоставляет API для интеграции с другими плагинами (например его использует [TopsSystem](https://github.com/flyawaymaking/TopsSystem)):
### Получение экземпляра плагина:
```java
TrackPlayer trackPlugin = (TrackPlayer) Bukkit.getPluginManager().getPlugin("TrackPlayer");
```
### Основные методы API:
```java
// Получить статистику игрока (работает для онлайн и офлайн игроков)
int deaths = trackPlugin.getDeaths(uuid);
int playerKills = trackPlugin.getPlayerKills(uuid);
int mobKills = trackPlugin.getMobKills(uuid);
// Получить списки всех игроков (онлайн + офлайн)
Map mobKills = trackPlugin.getPlayerMobKills();
Map allDeaths = trackPlugin.getAllDeaths();
Map allPlayerKills = trackPlugin.getAllPlayerKills();
// Сбросить статистику
trackPlugin.resetAllMobKills();
trackPlugin.resetAllDeaths();
trackPlugin.resetAllPlayerKills();
```
## ⚙️ Конфигурация
Файл `config.yml` автоматически создается при первом запуске:
```yaml
# Интервал автосохранения в минутах
auto-save-interval: 5
# Отладка
debug: false
# Настройки статистики
track-mob-kills: true
track-player-kills: true
track-deaths: true
```
## 🔄 Автосохранение
Плагин автоматически сохраняет данные каждые 5 минут (настраивается) для защиты от потери данных при сбоях сервера.
## 📊 Хранение данных
Данные хранятся в файле `plugins/TrackPlayer/playerdata.yml` в формате YAML.
## 🐛 Поддержка
При возникновении проблем:
1. Проверьте наличие PlaceholderAPI для работы плейсхолдеров
2. Используйте `/trackplayer admin papi` для диагностики
3. Включите `debug: true` в конфигурации для подробного лога
## 📄 Лицензия
Плагин распространяется под лицензией MIT.