# PicoLimboBridge \ud83c\udf09<\/p>\n
  <\/p>\n
**PicoLimboBridge** is the ultimate bridge between your Minecraft server and PicoLimbo\u2014the ultra-lightweight Limbo server.<\/p>\n
Designed for **Spigot\/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.<\/p>\n
—<\/p>\n
### \ud83d\ude80 Why PicoLimboBridge?<\/p>\n
* **\ud83d\udcb8 Cost-Effective**: Stop paying for an extra VPS or server slot just for a fallback\/AFK server.
\n* **\u26a1 Ultra Lightweight**: Runs a tiny, optimized process alongside your main server.
\n* **\ud83d\udee0\ufe0f Zero Friction**: No manual binary downloads, no complex shell scripts. It just works.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
* **\u2b07\ufe0f Automatic Installation**: Smartly detects your OS (Windows, Linux, macOS) and architecture (x86_64, aarch64) to fetch the perfect PicoLimbo binary automatically.
\n* **\ud83c\udfae Process Management**: Effortlessly start, stop, and restart the PicoLimbo process via simple in-game or console commands.
\n* **\ud83d\udcdd Console Integration**: View PicoLimbo’s logs directly in your main server’s console\u2014no need to switch windows.
\n* **\u2699\ufe0f Dynamic Configuration**: Change the binding port on the fly using command arguments; `server.toml` is updated automatically.
\n* **\ud83d\udd12 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.
\n* **\ud83d\udd14 Update Checker**: Stay informed with polite, non-intrusive notifications when a new version of the bridge is available on GitHub\/Modrinth.
\n* **\ud83d\udd04 Auto-Binary-Update**: built-in tools to reinstall or upgrade to the latest PicoLimbo binary with a single command.
\n* **\ud83c\udf10 Multi-Platform**: One bridge to rule them all\u2014fully compatible with Spigot, Paper, Folia, and Velocity.<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. **Download** the appropriate artifact for your platform from Releases:
\n * **Spigot\/Paper\/Folia**: `picolimbobridge-spigot-1.0.0.jar`
\n * **Velocity**: `picolimbobridge-velocity-1.0.0.jar`
\n2. **Drop** the jar file into your server’s `plugins` folder.
\n3. **Start** your server. That’s it!<\/p>\n
## \ud83d\udda5\ufe0f Usage<\/p>\n
All commands require the `picolimbobridge.admin` permission.<\/p>\n
### Commands<\/p>\n
| Command | Description |
\n| :— | :— |
\n| `\/picolimbo start [port]` | \ud83d\udfe2 Starts the PicoLimbo process. If provided, `[port]` updates the `server.toml` configuration. If the binary is missing, it will be downloaded automatically. |
\n| `\/picolimbo stop` | \ud83d\udd34 Gracefully stops the PicoLimbo process. |
\n| `\/picolimbo update` | \ud83d\udd0d Manually checks for plugin updates. |
\n| `\/picolimbo reinstall [force]` | \ud83d\udd04 Stops the process and re-downloads the latest binary. Use `force` to delete existing configurations (`server.toml`) as well. |<\/p>\n
### Example<\/p>\n
Start PicoLimbo on port `25566`:
\n“`bash
\n\/picolimbo start 25566
\n“`<\/p>\n
## \ud83d\udee0\ufe0f Building from Source<\/p>\n
To build this project, you need **JDK 17+** and **Maven**.<\/p>\n
“`bash
\ngit clone https:\/\/github.com\/vanes430\/PicoLimboBridge.git
\ncd PicoLimboBridge
\nmvn clean install
\n“`<\/p>\n
The compiled jars will be located in:
\n* `spigot\/target\/picolimbobridge-spigot-1.0.0.jar`
\n* `velocity\/target\/picolimbobridge-velocity-1.0.0.jar`<\/p>\n
## \ud83c\udfc6 Credits<\/p>\n
* **PicoLimbo** by Quozul – The lightweight Limbo server implementation.
\n* **PicoLimbo Wiki**: Introduction & Documentation<\/p>\n","protected":false},"excerpt":{"rendered":"
PicoLimboBridge is a management plugin for PicoLimbo<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"picolimbobridge","_minecraft_project_id":"GwMXBP7z","_minecraft_author":"vanes430","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":60,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"picolimbobridge.zip","_minecraft_size_bytes":1322628,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T20:47:23.548696Z","_minecraft_date_created":"2026-01-14T22:41:38.416197Z","_minecraft_date_modified":"2026-01-17T01:35:12.557773Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/picolimbobridge","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T03:06:29+00:00","_minecraft_import_hash":"e52a39ba7d56c0661e7ff2de7f0f5548","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,873,126,127,128,129,92,985],"mod_loader":[131,132,133,134,986],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-121207","mod","type-mod","status-publish","hentry","mod_category-folia","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-velocity","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n