FunTimeEvents SDK

Библиотека создана для проекта FunTimeEventsBot.

Клиентская библиотека для Minecraft Fabric — автоматически отслеживает игровые события на серверах FunTime и отправляет их на бэкенд через WebSocket Relay или HTTP REST.

---

Подключение

Способ 1: JitPack (рекомендуется)

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    modImplementation "com.github.Rizzener.FunTimeEventsSDK:fte-api:v1.0.5"
}

Способ 2: Локальная сборка (mavenLocal)

git clone https://github.com/Rizzener/FunTimeEventsSDK.git
cd FunTimeEventsSDK
.\gradlew :fte-api:publishToMavenLocal -Pmod_version=1.0.5-SNAPSHOT

repositories { mavenLocal() }

dependencies {
    modImplementation "net.funtimeevents:fte-api:1.0.5-SNAPSHOT"
}

3. Инициализация

FunTimeEventsAPI.builder()
    .userAgent("MyMod/1.0")
    .apiKey("sk-fte-...")
    .build();

Трекеры запускаются автоматически при входе в мир.

Прокси (скрытие IP клиента)

FunTimeEventsAPIProxy — прозрачный reverse proxy: форвардит запросы и ключ как есть, скрывая реальный IP клиента от бэкенда.

FunTimeEventsAPI.builder()
    .userAgent("MyMod/1.0")
    .apiKey("sk-fte-...")
    .baseUrl("http://proxy.example.com/v1/")
    .build();

Подробнее — в репозитории FunTimeEventsAPIProxy.

---

Возможности

• Баны — парсинг hover-текста из чата
• TAB-лист — имена и донат-префиксы
• Данжи — Медный данж и Город Вардена (сундуки + экипировка)
• Адская резня — мобов в боссбаре через рефлексию
• Авто-шахта — игроки вокруг на спавне
• Координаты ивентов — парсинг чата по регуляркам
• Капча — всегда через REST
• GET-запросы к бэкенду — события, шахты, игроки, баны, данжи
• User-ивенты — аирдропы, алтари нежити, загадочные маяки (getUserEvents())
• WSS (релеи, снапшоты каждую секунду) или REST (SSE-стримы)
• Любой трекер отключается в билдере

---

Лицензия

LICENSE — MIT with Backend Restriction