HungerBridge

HungerBridge is a tiny, zero‑noise, multiloader HTTP bridge that lets external services communicate with your Minecraft server safely and efficiently. Designed for automation and engineered to stay completely out of your way.

---

What it does

• Exposes a minimal HTTP API for remote automation
• Supports Paper and Fabric with a shared common module
• Provides run and log endpoints (more coming soon!)
• Zero commands, zero chat output, zero clutter
• Safe by default — shared secret authentication, no open RCON, no exposed internals

---

Why it exists

Traditional RCON is slow, fragile, and unsafe to expose publicly.
HungerBridge replaces it with a modern, stateless, authenticated HTTP layer that works identically across loaders.

---

Features

• 🔌 Unified API across all loaders
• 🧩 Python library
• 🔐 Shared‑secret authentication
• ⚡ Fast, lightweight, no tick overhead
• 📝 Structured logging endpoint
• 🏃 Command execution endpoint

---

Usage

HungerBridge is designed to be paired with HungerLib or any external client that can send authenticated HTTP requests.

Example integrations:

• Automation scripts
• Server orchestration
• Custom dashboards
• Server monitoring tools

---

HungerLib support

While HungerBridge can be used by any HTTP client, HungerLib is a Python library built for queries.

Installation

pip install hungerlib

Usage

from hungerlib import BridgeClient

# Create the client
bridge = BridgeClient(url="http://example.com:1913", token="YOUR_SECRET")

# Run a command
out = bridge.runCommand("say Hello from HungerBridge!", silent=False)
print("Command output:", out)

# Log something
bridge.log("Example script ran successfully", level="info")

# Get status
bridge.getStatus()

# Get version
bridge.getVersion()

---

Supported Platforms

Platform	Supported	Version
Fabric	✔ Yes	1.21.10+
Quilt	✔ Yes	1.21.10+
Paper	✔ Yes	1.21.10+
Purpur	✔ Yes	1.21.10+