饥饿之桥

Paper和Fabric的安全、轻量级HTTP桥接

HungerBridge 是一个微小、零噪声、多加载器的 HTTP 桥接器，可让外部服务安全高效地与您的 Minecraft 服务器通信。专为自动化设计，并致力于完全不影响您的正常使用。

功能

  • 暴露一个极简 HTTP API 用于远程自动化
  • 通过共享公共模块支持 Paper 和 Fabric
  • 提供 run 和 log 端点 (更多内容即将推出)
  • 零命令、零聊天输出、零杂乱
  • 默认安全 — 共享密钥认证，无开放 RCON，不暴露内部细节

为何存在

传统 RCON 速度慢、不稳定且公开暴露不安全。 HungerBridge 用现代、无状态、经过认证的 HTTP 层取代它，该层在所有加载器上的运行方式完全相同。

特性

  • 🔌 所有加载器上的统一 API
  • 🧩 Python 库
  • 🔐 共享密钥认证
  • ⚡ 快速、轻量、无 Tick 开销
  • 📝 结构化日志端点
  • 🏃 命令执行端点

用法

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("命令输出:", out)

# 记录日志
bridge.log("示例脚本运行成功", level="info")

# 获取状态
bridge.getStatus()

# 获取版本
bridge.getVersion()

支持平台

平台 支持情况 版本
Fabric ✔ 是 1.21.10+
Quilt ✔ 是 1.21.10+
Paper ✔ 是 1.21.10+
Purpur ✔ 是 1.21.10+

安全指南

HungerBridge 设计为在与 Cloudflare 配合使用时可以安全暴露。 本指南展示了通过 HTTPS 保护您的 API 的最简推荐设置。

将 HungerBridge 置于 Cloudflare 之后 创建 DNS 记录：

类型 名称 值 代理
A api 已代理（橙色云）

这将为您提供：

  • HTTPS
  • DDoS 防护
  • 防火墙
  • IP 隐藏

您的 API 将在以下地址可用： https://api.example.com:1913