{"id":32663603,"url":"https://github.com/flyawaymaking/trackplayer","last_synced_at":"2026-04-21T00:02:44.517Z","repository":{"id":319380156,"uuid":"1078420739","full_name":"flyawaymaking/TrackPlayer","owner":"flyawaymaking","description":"TrackPlayer - плагин для отслеживания статистики игроков на серверах Minecraft (учет смертей, PvP-убийств и убийств враждебных мобов) с поддержкой PlaceholderAPI.","archived":false,"fork":false,"pushed_at":"2025-12-10T21:32:53.000Z","size":73,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-11T08:51:35.885Z","etag":null,"topics":["minecraf-plugins","minecraft","papermc","placeholderapi","plugins","statistics"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flyawaymaking.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-17T17:50:46.000Z","updated_at":"2025-12-10T21:25:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"020599b6-8f80-46af-9007-f226ede3005a","html_url":"https://github.com/flyawaymaking/TrackPlayer","commit_stats":null,"previous_names":["flyawaymaking/trackplayer"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/flyawaymaking/TrackPlayer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyawaymaking%2FTrackPlayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyawaymaking%2FTrackPlayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyawaymaking%2FTrackPlayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyawaymaking%2FTrackPlayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flyawaymaking","download_url":"https://codeload.github.com/flyawaymaking/TrackPlayer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyawaymaking%2FTrackPlayer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32071021,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T21:26:33.338Z","status":"ssl_error","status_checked_at":"2026-04-20T21:26:22.081Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["minecraf-plugins","minecraft","papermc","placeholderapi","plugins","statistics"],"created_at":"2025-10-31T22:01:07.560Z","updated_at":"2026-04-21T00:02:44.512Z","avatar_url":"https://github.com/flyawaymaking.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TrackPlayer - Плагин статистики для Minecraft\n\nПлагин для отслеживания статистики игроков на серверах Minecraft Paper 1.21.10. Ведет учет смертей, убийств игроков и враждебных мобов.\n\n## 📊 Функциональность\n\n### Отслеживаемые показатели:\n- **Количество смертей** игрока\n- **Количество убийств** других игроков\n- **Количество убитых враждебных мобов**\n\n## ⚡ Оптимизация производительности\n\n### Оптимизация использования памяти\n- **Ленивая загрузка данных** - данные загружаются только для онлайн-игроков\n- **Автоматическое управление памятью** - данные удаляются из памяти при выходе игрока\n- **Синхронизированные операции** - обеспечена потокобезопасность при работе с данными\n\n### Враждебные мобы которые отслеживаются:\n```\nZombie, Drowned, Husk, Skeleton, Stray, Wither Skeleton, Spider, Cave Spider,\nCreeper, Enderman, Witch, Blaze, Ghast, Magma Cube, Slime, Guardian, Elder Guardian,\nShulker, Endermite, Vex, Vindicator, Evoker, Pillager, Ravager, Hoglin, Zoglin,\nPiglin Brute, Warden, Breeze, Ender Dragon, Wither, Phantom, Silverfish\n```\n\n## 🛠️ Установка\n\n1. Скачайте **последний релиз** из раздела [Releases](../../releases)\n2. Поместите его в папку /plugins\n3. Перезапустите сервер\n4. Настройте config.yml при необходимости\n5. Используйте /trackplayer reload, чтобы применить изменения без перезапуска\n\n**Зависимости:**\n- Paper 1.21.10 (обязательно)\n- PlaceholderAPI (рекомендуется)\n\n## 💬 Placeholders\n\nПлагин предоставляет следующие плейсхолдеры для использования в других плагинах:\n\n```\n%trackplayer_kills%       - количество убийств игроков\n%trackplayer_deaths%      - количество смертей\n%trackplayer_mob_kills%   - количество убитых враждебных мобов\n```\n\n### Примеры использования:\n- В таблице лидеров: `%trackplayer_kills%`\n- В голограммах: `\"Убийств: %trackplayer_kills%\"`\n- В чат-плагинах: `\"Ваша статистика: K:%trackplayer_kills% D:%trackplayer_deaths%\"`\n\n## 🔧 Команды\n\n### Основные команды:\n```\n/trackplayer                    - посмотреть свою статистику\n/trackplayer \u003cник\u003e              - посмотреть статистику другого игрока\n/trackplayer reload             - перезагрузить конфигурацию\n```\n\n### Админ-команды:\n```\n/trackplayer admin list         - список убийств мобов всеми игроками\n/trackplayer admin resetmobs    - сбросить статистику мобов у всех игроков\n/trackplayer admin save         - принудительно сохранить данные\n/trackplayer admin status       - статус системы\n/trackplayer admin papi         - диагностика плейсхолдеров\n```\n\n## 📡 API для разработчиков\n\nПлагин предоставляет API для интеграции с другими плагинами (например его использует [TopsSystem](https://github.com/flyawaymaking/TopsSystem)):\n\n### Получение экземпляра плагина:\n```java\nTrackPlayer trackPlugin = (TrackPlayer) Bukkit.getPluginManager().getPlugin(\"TrackPlayer\");\n```\n\n### Основные методы API:\n```java\n// Получить статистику игрока (работает для онлайн и офлайн игроков)\nint deaths = trackPlugin.getDeaths(uuid);\nint playerKills = trackPlugin.getPlayerKills(uuid);\nint mobKills = trackPlugin.getMobKills(uuid);\n\n// Получить списки всех игроков (онлайн + офлайн)\nMap\u003cUUID, Integer\u003e mobKills = trackPlugin.getPlayerMobKills();\nMap\u003cUUID, Integer\u003e allDeaths = trackPlugin.getAllDeaths();\nMap\u003cUUID, Integer\u003e allPlayerKills = trackPlugin.getAllPlayerKills();\n\n// Сбросить статистику\ntrackPlugin.resetAllMobKills();\ntrackPlugin.resetAllDeaths();\ntrackPlugin.resetAllPlayerKills();\n```\n\n## ⚙️ Конфигурация\n\nФайл `config.yml` автоматически создается при первом запуске:\n\n```yaml\n# Интервал автосохранения в минутах\nauto-save-interval: 5\n\n# Отладка\ndebug: false\n\n# Настройки статистики\ntrack-mob-kills: true\ntrack-player-kills: true\ntrack-deaths: true\n```\n\n## 🔄 Автосохранение\n\nПлагин автоматически сохраняет данные каждые 5 минут (настраивается) для защиты от потери данных при сбоях сервера.\n\n## 📊 Хранение данных\n\nДанные хранятся в файле `plugins/TrackPlayer/playerdata.yml` в формате YAML.\n\n## 🐛 Поддержка\n\nПри возникновении проблем:\n1. Проверьте наличие PlaceholderAPI для работы плейсхолдеров\n2. Используйте `/trackplayer admin papi` для диагностики\n3. Включите `debug: true` в конфигурации для подробного лога\n\n## 📄 Лицензия\n\nПлагин распространяется под лицензией MIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflyawaymaking%2Ftrackplayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflyawaymaking%2Ftrackplayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflyawaymaking%2Ftrackplayer/lists"}