PicoLimboBridge

PicoLimboBridge is the ultimate bridge between your Minecraft server and PicoLimbo—the ultra-lightweight Limbo server.

Designed for Paper, Folia, and Velocity, this plugin eliminates the hassle of setting up a separate fallback server. It seamlessly integrates a local PicoLimbo instance directly into your existing infrastructure, saving you time, money, and system resources.

⚠️ Transparency Notice: To function seamlessly, this plugin will automatically download the official PicoLimbo binary from GitHub and necessary runtime libraries (via Libby) upon its first startup.

🚀 Why PicoLimboBridge?

• 💸 Cost-Effective: Stop paying for an extra VPS or server slot just for a fallback/AFK server.
• ⚡ Ultra Lightweight: Runs a tiny, optimized process alongside your main server.
• 🛠️ Zero Friction: No manual binary downloads, no complex shell scripts. It just works.

✨ Features

• ⬇️ Automatic Installation: Smartly detects your OS (Windows, Linux, macOS) and architecture (x86_64, aarch64) to fetch the perfect PicoLimbo binary automatically.
• 🎮 Process Management: Effortlessly start, stop, and restart the PicoLimbo process via simple in-game or console commands.
• 📝 Console Integration: View PicoLimbo's logs directly in your main server's console—no need to switch windows.
• ⚙️ Dynamic Configuration: Change the binding port on the fly using command arguments; server.toml is updated automatically.
• 🔒 Integrity Protection: Automatically verifies the SHA-256 hash of the PicoLimbo binary against a trusted upstream source. If a mismatch or corruption is detected, it self-heals by re-downloading the correct version.
• 🔔 Update Checker: Stay informed with polite, non-intrusive notifications when a new version of the bridge is available on GitHub/Modrinth.
• 🔄 Auto-Binary-Update: built-in tools to reinstall or upgrade to the latest PicoLimbo binary with a single command.
• 🌐 Multi-Platform: One bridge to rule them all—fully compatible with Paper, Folia, and Velocity.

📦 Installation

1. Download the appropriate artifact for your platform from Modrinth:
   • Paper/Folia: picolimbobridge-paper-<version>.jar
   • Velocity: picolimbobridge-velocity-<version>.jar
2. Drop the jar file into your server's plugins folder.
3. Start your server. That's it!

🖥️ Usage

All commands require the picolimbobridge.admin permission.

Commands

Example

Start PicoLimbo on port 25566:

/picolimbo start 25566

🛠️ Building from Source

To build this project, you need JDK 17+ and Maven.

git clone https://github.com/vanes430/PicoLimboBridge.git
cd PicoLimboBridge
mvn clean install

🏆 Credits

• PicoLimbo by Quozul - The lightweight Limbo server implementation.
• PicoLimbo Wiki: Introduction & Documentation