Fivemanage Logger

Universal logger for Hytale. Supports Grafana Loki, Disk and Fivemanage

7.0 загрузок

Обновлён 6 дней назад

Библиотека Утилиты Разное Улучшение Качества Жизни

Скачать последнюю версию (309.9 КБ)

Описание

Fivemanage Logger: Hytale Server Logging & Analytics

Окончательное решение для регистрации выделенных серверов Hytale. Отслеживайте активность игрока, отслеживайте события на сервере и отправляйте журналы в Fivemanage, Grafana Loki или локальные файлы.

Зачем использовать Fivemanage Logger?

Отследить все - Игрок присоединяется, отключается, блокирует перерывы и пользовательские события
Несколько Backends Отправить журналы в Fivemanage, Grafana Loki или локальные файлы
Создано для производительности Async пакетная регистрация с нулевым воздействием на сервер TPS
Простая настройка Drop-in JAR, простой конфигуратор JSON, работает из коробки

Особенности

Особенность	Описание
Многопрофильная поддержка	Fivemanage, Grafana Loki, файлообменник
Заготовка	Настраиваемый размер буфера и интервалы промывки
Отслеживание событий игрока	Автоматическая регистрация подключения, отключения, готовых событий
Отслеживание событий Block	Отслеживание, когда игроки ломают блоки
Двойная заготовка	Написать на диск при отправке удаленным провайдерам
Богатые метаданные	Прикрепить пользовательские метаданные ко всем входам в журнал

установка

Скачать последнюю версию из выпуски
Место .джар файл в вашем Сервер Hytale мод справочник
Создайте файл Config в Моды/Fivemanage_Logger/config.json

Быстрый старт

Облако FiveManage

{
"LogProvider": {
"Поставщик": "пятименеджер",
"ApiKey": "ваш пять менеджеров-апи-ключ",
"WriteToDisk": ложный,
«EnableBatching»: правда
"BufferSize": 10,
"FlushIntervalMs": 5000
?
"Игровые события": {
«Датасет»: «игровые события»,
"Включено": правда
?
?

Получите ключ API от FiveManage.com.

Графана Локи / Grafana Cloud

{
"LogProvider": {
"Поставщик": "графана-локи",
"Конечный пункт":https://logs-prod-us-central1.grafana.net&quot;,
"Имя пользователя": "ваша графана-имя пользователя",
"Пароль": "ваш-графана-апи-ключ",
"WriteToDisk": ложный,
«EnableBatching»: правда
"BufferSize": 10,
"FlushIntervalMs": 5000
?
"Игровые события": {
«Датасет»: «игровые события»,
"Включено": правда
?
?

Ссылка на конфигурацию

Варианты Log Provider

Вариант	Тип	Описание
`поставщик`	струна	`пятикомнатный`, `Графана-локи`или `файл`
`ApiKey`	струна	Ключ API для Fivemanage
`Конечная точка`	струна	Loki push endpoint URL
`Имя пользователя`	струна	Основное имя пользователя auth (Loki)
`Пароль`	струна	Базовый пароль auth (Loki)
`Дискография`	булевый	Также записывайте журналы в локальные файлы
`Позволяет играть`	булевый	Буферные журналы перед отправкой
`размер буфера`	целое число	Логи для буферизации перед промывкой (по умолчанию: 10)
`FlushIntervalMs`	целое число	Max Time Before Flush in ms (по умолчанию: 5000)

Варианты событий игрока

Вариант	Тип	Описание
`Набор данных`	струна	Набор данных/наименование метки для событий игрока
`включенный`	булевый	Включите автоматическую регистрацию событий игрока

Использование в Hytale Mod

Используйте FiveManageLogger API для отправки собственных журналов Моды Hytale:

импортировать org.fivemanage.FivemanageLogger;
Импорт java.util. Карта;

// Журнал с метаданными
Map<String, Object> metadata = Map.of()
"игрок", "Стив",
"местоположение", "x:100, y:64, z:200"
);

FivemanageLogger.info («мой набор данных», «Игрок нерест», метаданные);
FivemanageLogger.warn («мой набор данных», «Низкое предупреждение о здоровье», метаданные);
FivemanageLogger.error («мой набор данных», «Что-то пошло не так», метаданные);
FivemanageLogger.debug("my-dataset", "Debug info", метаданные);

Автоматическое отслеживание событий

Когда Игровые события. включенный это истинныйЭти события регистрируются автоматически:

Событие	Описание
Игрок подключается	Когда игрок подключается к серверу
Игрок готов	Когда игрок полностью заряжен и готов
Игрок отключается	Когда игрок покидает сервер

Случаи использования

Управление сервером Мониторинг активности игроков и здоровья сервера
Борьба с мошенничеством Отслеживание подозрительного поведения игрока
Аналитическая панель инструментов - Построить приборные панели с Grafana
Следы аудита Храните записи всех событий сервера
Отладка Отслеживайте проблемы в своем Моды Hytale

связанный

Кредс

Поддержка

Сайт: FiveManage.com
Электронная почта: support@fivemanage.com

Лицензия

МТИ

Показать оригинальное описание (English)

Fivemanage Logger - Hytale Server Logging & Analytics

The ultimate logging solution for Hytale dedicated servers. Track player activity, monitor server events, and send logs to Fivemanage, Grafana Loki, or local files.

Why Use Fivemanage Logger?

Track Everything — Player joins, disconnects, block breaks, and custom events
Multiple Backends — Send logs to Fivemanage, Grafana Loki, or local files
Built for Performance — Async batched logging with zero impact on server TPS
Easy Setup — Drop-in JAR, simple JSON config, works out of the box

Features

Feature	Description
Multi-Provider Support	Fivemanage, Grafana Loki, file-based logging
Batched Logging	Configurable buffer size and flush intervals
Player Event Tracking	Automatic logging of connect, disconnect, ready events
Block Event Tracking	Track when players break blocks
Dual Logging	Write to disk while sending to remote providers
Rich Metadata	Attach custom metadata to all log entries

Installation

Download the latest release from Releases
Place the .jar file in your Hytale server's mods directory
Create a config file at mods/Fivemanage_Logger/config.json

Quick Start

Fivemanage Cloud

{
  "LogProvider": {
    "Provider": "fivemanage",
    "ApiKey": "your-fivemanage-api-key",
    "WriteToDisk": false,
    "EnableBatching": true,
    "BufferSize": 10,
    "FlushIntervalMs": 5000
  },
  "PlayerEvents": {
    "Dataset": "player-events",
    "Enabled": true
  }
}

Get your API key from fivemanage.com.

Grafana Loki / Grafana Cloud

{
  "LogProvider": {
    "Provider": "grafana-loki",
    "Endpoint": "https://logs-prod-us-central1.grafana.net&quot;,
    "Username": "your-grafana-username",
    "Password": "your-grafana-api-key",
    "WriteToDisk": false,
    "EnableBatching": true,
    "BufferSize": 10,
    "FlushIntervalMs": 5000
  },
  "PlayerEvents": {
    "Dataset": "player-events",
    "Enabled": true
  }
}

Configuration Reference

Log Provider Options

Option	Type	Description
`Provider`	string	`fivemanage`, `grafana-loki`, or `file`
`ApiKey`	string	API key for Fivemanage
`Endpoint`	string	Loki push endpoint URL
`Username`	string	Basic auth username (Loki)
`Password`	string	Basic auth password (Loki)
`WriteToDisk`	boolean	Also write logs to local files
`EnableBatching`	boolean	Buffer logs before sending
`BufferSize`	integer	Logs to buffer before flush (default: 10)
`FlushIntervalMs`	integer	Max time before flush in ms (default: 5000)

Player Events Options

Option	Type	Description
`Dataset`	string	Dataset/label name for player events
`Enabled`	boolean	Enable automatic player event logging

Usage in Your Hytale Mod

Use the FivemanageLogger API to send custom logs from your own Hytale mods:

import org.fivemanage.FivemanageLogger;
import java.util.Map;

// Log with metadata
Map<String, Object> metadata = Map.of(
    "player", "Steve",
    "location", "x:100, y:64, z:200"
);

FivemanageLogger.info("my-dataset", "Player spawned", metadata);
FivemanageLogger.warn("my-dataset", "Low health warning", metadata);
FivemanageLogger.error("my-dataset", "Something went wrong", metadata);
FivemanageLogger.debug("my-dataset", "Debug info", metadata);

Automatic Event Tracking

When PlayerEvents.Enabled is true, these events are logged automatically:

Event	Description
Player Connect	When a player connects to the server
Player Ready	When a player is fully loaded and ready
Player Disconnect	When a player leaves the server

Use Cases

Server Administration — Monitor player activity and server health
Anti-Cheat Logging — Track suspicious player behavior
Analytics Dashboard — Build dashboards with Grafana
Audit Trails — Keep records of all server events
Debugging — Track down issues in your Hytale mods

Creds

Support

Website: fivemanage.com
Email: support@fivemanage.com

License

MIT

Последние версии