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.tomlis 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
- Download the appropriate artifact for your platform from Modrinth:
- Paper/Folia:
picolimbobridge-paper-<version>.jar - Velocity:
picolimbobridge-velocity-<version>.jar
- Paper/Folia:
- Drop the jar file into your server's
pluginsfolder. - Start your server. That's it!
🖥️ Usage
All commands require the picolimbobridge.admin permission.
Commands
| Command | Description |
|---|---|
/picolimbo start [port] |
🟢 Starts the PicoLimbo process. If provided, [port] updates the server.toml configuration. If the binary is missing, it will be downloaded automatically. |
/picolimbo stop |
🔴 Gracefully stops the PicoLimbo process. |
/picolimbo update |
🔍 Manually checks for plugin updates. |
/picolimbo reinstall [force] |
🔄 Stops the process and re-downloads the latest binary. Use force to delete existing configurations (server.toml) as well. |
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
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
PicoLimboBridge 1.1.1 1.1.1 |
1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2
|
velocity
|
Download |
|
PicoLimboBridge 1.1.1 1.1.1 |
1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2
|
folia, paper, purpur
|
Download |
|
PicoLimboBridge 1.0.1 1.0.1 |
1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
folia, paper, purpur, spigot
|
Download |
|
PicoLimboBridge 1.0.1 1.0.1 |
1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
velocity
|
Download |
|
PicoLimboBridge 1.0.0 1.0.0 |
1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
velocity
|
Download |
|
PicoLimboBridge 1.0.0 1.0.0 |
1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
folia, paper, purpur, spigot
|
Download |