HungerBridge

HungerBridge — это крошечный, бесшумный, мультизагрузочный HTTP-мост, который позволяет внешним сервисам безопасно и эффективно общаться с вашим сервером Minecraft. Создан для автоматизации и спроектирован так, чтобы совершенно не мешать вам.

Что он делает

• Предоставляет минимальный HTTP API для удалённой автоматизации
• Поддерживает Paper и Fabric с общим модулем
• Предоставляет эндпоинты run и log (скоро будет больше!)
• Ноль команд, ноль вывода в чат, ноль беспорядка
• Безопасен по умолчанию — аутентификация по общему секрету, никакого открытого RCON, никаких открытых внутренностей

Зачем он нужен

Традиционный RCON медленный, хрупкий и небезопасный для публичного доступа. HungerBridge заменяет его современным, stateless, аутентифицированным HTTP-слоем, который работает одинаково на всех загрузчиках.

Возможности

• 🔌 Единый API для всех загрузчиков
• 🧩 Библиотека Python
• 🔐 Аутентификация по общему секрету
• ⚡ Быстрый, лёгкий, без нагрузки на тики
• 📝 Эндпоинт структурированного логирования
• 🏃 Эндпоинт выполнения команд

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

HungerBridge создан для работы в паре с HungerLib или любым внешним клиентом, умеющим отправлять аутентифицированные HTTP-запросы. Примеры интеграций:

• Скрипты автоматизации
• Оркестрация серверов
• Пользовательские дашборды
• Инструменты мониторинга серверов

Поддержка HungerLib

Хотя HungerBridge может использоваться любым HTTP-клиентом, HungerLib — это библиотека Python, созданная для запросов.

Установка

pip install hungerlib

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

from hungerlib import BridgeClient

# Создаём клиент
bridge = BridgeClient(url="http://example.com:1913", token="YOUR_SECRET")

# Выполнить команду
out = bridge.runCommand("say Hello from HungerBridge!", silent=False)
print("Command output:", out)

# Залогировать что-нибудь
bridge.log("Example script ran successfully", level="info")

# Получить статус
bridge.getStatus()

# Получить версию
bridge.getVersion()

Поддерживаемые платформы

Руководство по безопасности

HungerBridge спроектирован так, чтобы его можно было безопасно открывать при использовании вместе с Cloudflare. Это руководство показывает минимальную рекомендуемую настройку для защиты вашего API через HTTPS. Разместите HungerBridge за Cloudflare
Создайте DNS-запись:

Это даёт вам:

• HTTPS
• Защиту от DDoS
• Файрвол
• Маскировку IP Ваш API будет доступен по адресу:
  https://api.example.com:1913