Fiw Clock

Tickwatch

Отслеживание времени игры, AFK, сессий, убийств игроков и мобов, смертей и серий убийств — серверный, лёгкий, устойчивый к крашам, с поддержкой LuckPerms. Tickwatch незаметно записывает, сколько каждый игрок наиграл (без учёта AFK) и сколько убийств и смертей он набрал, а затем сохраняет всё это в аккуратный JSON-файл. Клиентский мод не нужен, на TPS не влияет — а ещё есть команда /tickwatch, когда захочется посмотреть.

✨ Почему Tickwatch?

• 🪶 Невесомый — отслеживание это одно целое число на онлайн-игрока за тик. И всё.
• 🖥️ Только серверный — игроки заходят с ванильным клиентом. Поставь на сервер и забудь.
• 🔀 Fabric, NeoForge и Forge — Minecraft 1.21.11, 1.21.1 и 1.20.1.
• 💾 Устойчив к крашам по своей архитектуре — атомарная запись с ротацией бэкапов. Внезапное отключение питания или жёсткий краш не смогут повредить твою статистику.
• ⚡ Никогда не блокирует сервер — вся запись на диск идёт в отдельном фоновом потоке.
• 💤 Учитывает AFK — бездействующие игроки перестают накапливать время игры; AFK-зоны тоже не помогут его фармить.
• 🏆 Команда /tickwatch — статистика любого игрока (даже офлайн) и таблицы лидеров по любой характеристике.
• 📣 Оповещения о достижениях — необязательные объявления вроде «Notch наиграл 100 часов!».
• 🔑 Интеграция с LuckPerms — статистика становится мета-данными LuckPerms (tickwatch_kills, tickwatch_playtime, tickwatch_afk, …), так что любой мод для чата, таба или таблицы очков, читающий мета-данные LuckPerms, сможет их отображать, а у каждой команды есть свой узел прав.
• 🧩 Публичный API — другие моды могут читать статистику, таблицы лидеров и слушать события убийств, смертей и изменений AFK.

📊 Что отслеживается

Для каждого игрока, по каждому миру:

Хранится в `/fiw-clock/stats.json`:

{
  "players": {
    "069a79f4-44e9-4726-a5be-fca90e38aaf5": {
      "name": "Notch",
      "playTimeTicks": 144000,
      "playTimeFormatted": "2h 00m 00s",
      "afkTicks": 14400,
      "kills": 12,
      "playerKills": 2,
      "mobKills": 10,
      "deaths": 3,
      "killStreak": 4,
      "bestKillStreak": 9,
      "joins": 27,
      "firstJoin": 1767225600000,
      "lastSeen": 1769904000000,
      "longestSessionTicks": 72000
    }
  }
}

Идеально для таблиц лидеров, веб-панелей, Discord-ботов или чего угодно, что умеет читать JSON.

💬 Команды

📦 Требования

• Fabric: Fabric API + Fabric Language Kotlin
• NeoForge / Forge: Kotlin for Forge Опционально: LuckPerms — включает синхронизацию мета-данных (`/lp user meta info` показывает статистику). Architectury или другие моды-обёртки не требуются.

🚀 Установка

1. Установи Fabric, NeoForge или Forge на свой сервер.
2. Добавь соответствующие зависимости в mods/ — Fabric: Fabric API + Fabric Language Kotlin; NeoForge / Forge: Kotlin for Forge.
3. Закинь jar-файл Tickwatch для своего загрузчика и версии Minecraft.
4. Запусти сервер — статистика начнёт отслеживаться сразу.

💡 Tickwatch полностью серверный. Игрокам не нужно его устанавливать, чтобы зайти.

📖 Ссылки

• 📜 Исходный код и проблемы: https://github.com/Fi3w0/Fiw-Clock
• 🆓 Лицензия: MIT