PicoLimboBridge

PicoLimboBridge 🌉

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

Designed for Velocity, Velocity, 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.

---

🚀 Why PicoLimboBridge?

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

---

✨ Features

* 🌐 Multi-Platform: Smartly detects your OS (Windows, Linux, macOS) and architecture (x86_64, aarch64) to fetch the perfect PicoLimbo binary automatically. * 🌐 Multi-Platform: Effortlessly start, stop, and restart the PicoLimbo process via simple in-game or console commands. * 🌐 Multi-Platform: View PicoLimbo's logs directly in your main server's console—no need to switch windows. * 🌐 Multi-Platform: Change the binding port on the fly using command arguments; `server.toml` is updated automatically. * 🌐 Multi-Platform: 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. * 🌐 Multi-Platform: Stay informed with polite, non-intrusive notifications when a new version of the bridge is available on GitHub/Modrinth. * 🌐 Multi-Platform: 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 Spigot, Paper, Folia, and Velocity.

📦 Installation

1. Start the appropriate artifact for your platform from Start: * Start: `picolimbobridge-spigot-1.0.0.jar` * Start: `picolimbobridge-velocity-1.0.0.jar` 2. Start 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

| 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`: ```bash /picolimbo start 25566 ```

🛠️ Building from Source

To build this project, you need Maven and Maven.

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

The compiled jars will be located in: * `spigot/target/picolimbobridge-spigot-1.0.0.jar` * `velocity/target/picolimbobridge-velocity-1.0.0.jar`

🏆 Credits

* PicoLimbo Wiki by PicoLimbo Wiki - The lightweight Limbo server implementation. * PicoLimbo Wiki: %%MD1%%