# 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](https://github.com/Quozul/PicoLimbo) • [💬 Join Discord](https://discord.gg/M2a9dxJPRy) • [📖 Read Docs](https://picolimbo.quozul.dev/) ![This image pictures a world loaded in PicoLimbo using a schematic.](https://cdn.modrinth.com/data/cached_images/e3568bfb7089598e6b85d3871a7724584b382615_0.webp) *Schematic from [Limbo](https://modrinth.com/mod/limbo-server), another great project*

PicoLimbo is a lightweight [limbo server](https://quozul.dev/posts/2025-05-14-what-are-minecraft-limbo-servers/) 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](https://picolimbo.quozul.dev/about/installation.html). 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](https://picolimbo.quozul.dev/about/installation.html#java-wrapper) from the documentation website and [how to configure forwarding for PicoLimbo](https://picolimbo.quozul.dev/config/proxy-integration.html) before reporting any issues. ## Community & Support If you have any questions, suggestions or simply want to stay updated, please join the [Discord server](https://discord.gg/M2a9dxJPRy)! ## 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](https://picolimbo.quozul.dev/about/benchmarks.html). ### 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](https://picolimbo.quozul.dev/config/introduction.html). 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).

Pico Limbo Java Wrapper

v1.11.0+mc1.21.11

What's Changed

Added

Fixed

v1.10.0+mc1.21.11

External resources

Project members

Technical information