Tango Web API

TangoWebAPI

Единый общий мод-вебсервер для Fabric/NeoForge, который избавляет другие моды от шаблонного кода. TangoWebAPI предоставляет один встроенный HTTP-сервер, который моды могут использовать для своих эндпоинтов или статических файлов.

Возможности

• Общий HTTP-сервер (Java HTTP) для всех модов, запуск/остановка в общем коде.
• Простой API для маршрутов: get/post/registerRoute с пространством имён мода (/modid/...).
• Раздача статических файлов для каждого мода (serveStatic с безопасной обработкой путей).
• Встроенные health/info/список маршрутов: /tango-webapi/health, /tango-webapi/info, /tango-webapi/routes.
• Настройка через файл (config/tango-webapi.properties) или env/системные свойства.
• Страницы ошибок (404/405/503) с простыми HTML-шаблонами.

Настройка

Файл: config/tango-webapi.properties

host=0.0.0.0
port=8080
maxRequestBytes=1000000

Или через env/системные свойства:

• TANGO_WEBAPI_HOST / tango.webapi.host
• TANGO_WEBAPI_PORT / tango.webapi.port
• TANGO_WEBAPI_MAX_BYTES / tango.webapi.max_bytes

API для других модов (примеры)

// Простой текстовый маршрут на /mymod/ping
TangoWebAPI.get("mymod", "/ping", ctx -> ctx.sendText(200, "pong"));

// JSON-ответ
TangoWebAPI.post("mymod", "/data", ctx -> ctx.sendJson(200, "{\"ok\":true}"));

// Статические файлы из config/mymod/static по пути /mymod/static/**
TangoWebAPI.serveStatic("mymod", "static", Path.of("config", "mymod", "static"));

Встроенные эндпоинты

• GET /tango-webapi/health – статус
• GET /tango-webapi/info – host/port/max-bytes
• GET /tango-webapi/routes – все зарегистрированные маршруты, включая префиксные

Тестирование

• После запуска игры: http://localhost:8080/tango-webapi/health / info / routes
• Зарегистрируйте свой маршрут и откройте его в браузере или через curl.
• Разместите статическую страницу по пути вашего мода и проверьте, что она загружается.