Compatibility
Minecraft: Java Edition
Platforms
Links
Creators
Details
PicoLimbo Java Wrapper
A Java wrapper around PicoLimbo, a lightweight, multi-version Minecraft limbo server written in Rust. This allows you to run the PicoLimbo server directly inside your proxy or as a standalone jar file.
⭐ Star this repo • 💬 Join Discord • 📖 Read Docs
Schematic from Limbo, another great project
PicoLimbo is a lightweight limbo server written in Rust, designed primarily as an AFK or waiting server. Its core focus is on efficiency by implementing only essential packets required for client login and maintaining connection (keep-alive) without unnecessary overhead.
While not aiming to replicate every Minecraft server feature, PicoLimbo supports all Minecraft versions from 1.7.2 up until the latest stable version, excluding snapshots.
⚠️ IMPORTANT - READ BEFORE PROCEEDING ⚠️
This project uses native code and was not intended to be used as a plugin. For maximum performance and stability, it is recommended to use the binary instead. You can read more about alternative installation instructions on the official documentation website. The Java wrapper is provided to reach more people that have limited setup options.
Since the Java wrapper uses native code, it cannot run on all platforms. It is only compatible with:
- GNU/Linux (e.g., Debian, Ubuntu) - With x64 CPUs (AMD/Intel) or arm64 CPUs (e.g., Raspberry Pi)
- Windows - With x64 CPUs (AMD/Intel)
- macOS - M-series chips (M1/M2/M3+)
If you are unsure whether it'll work, try it. Most hosting providers uses GNU/Linux with x64 CPUs so you should be fine
Other Installations Platforms
PicoLimbo is also compatible with Docker and Pterodactyl. If you already have a Docker or Pterodactyl installation, it is recommended that you use that instead of the Java wrapper.
Documentation
Please read the installation instructions for the Java Wrapper from the documentation website and how to configure forwarding for PicoLimbo before reporting any issues.
Community & Support
If you have any questions, suggestions or simply want to stay updated, please join the Discord server!
Features
Wide Version Compatibility
Supports all Minecraft versions from 1.7.2 to 1.21.11 natively, no need for ViaVersion or additional compatibility layers.
Ultra-Lightweight & Highly Scalable
When running natively outside of the JVM, PicoLimbo uses 0% CPU while idle and can handles hundreds of players under 10 MB RAM. View benchmarks.
Skin Support
Player skins are supported. What else to say about that?
Built-in Proxy Support
Integrates with all major Minecraft proxies:
- Velocity (Modern Forwarding)
- BungeeCord (Legacy Forwarding)
- BungeeGuard & BungeeGuardPlus authentication
Highly Configurable
Customize your server using a simple TOML configuration file, including welcome message, spawn dimension, server list MOTD, and more. View configuration docs. When running as a plugin in a proxy, the generated configuration file is located in the same location as any other plugins.
Schematic World (Experimental)
Load a custom world from a schematic file and customize spawn location (1.16+ only).



