?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
PicoLimbo Java Wrapper

PicoLimbo Java Wrapper

The limbo server written in Rust supporting Minecraft versions from 1.7.2+. Now as a Velocity and BungeeCord plugin!

1,012
15
1,012
15

Compatibility

Minecraft: Java Edition

26.2
26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
1.12.x
1.11.x
1.10.x
1.9.x
1.8.x
1.7.x

Platforms

Supported environments

Dedicated servers only

Links

Report issues View source Visit wiki Join Discord server
Donate on Ko-fiSponsor on GitHubDonate on PayPal

Tags

Creators

Details

Licensed MIT
Published 5 months ago

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 the project on GitHub โ€ข ๐Ÿ’ฌ Join Discord โ€ข ๐Ÿ“– Read Docs

This image pictures a world loaded in PicoLimbo using a schematic. 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.

๐Ÿš€ Getting Started

Choose the installation method that best fits your setup:

๐Ÿ“ฆ The Easy Way (Recommended)

Best for: Most users, home hosting, and simple setups. Download the .jar wrapper from Modrinth. This is the easiest way to get up and running and helps support the development of the project.

โšก The High-Performance Way

Best for: Dedicated servers, high-traffic environments, and power users. For maximum performance and the lowest possible overhead, download the native binaries directly from our GitHub Releases. This method bypasses the JVM for the core process.

๐Ÿ’ป Platform Compatibility (Java Wrapper)

The Java wrapper is designed to be highly compatible. It works on:

  • Windows (x64)
  • macOS (M-series/Apple Silicon)
  • GNU/Linux (x64 AMD/Intel or arm64/Raspberry Pi)

Note: If you are using Docker or Pterodactyl, it is recommended to use the specific installation guides provided in the official documentation.

Documentation

Please read the installation instructions for the Java Wrapper and how to configure forwarding for PicoLimbo before reporting any issues.

๐Ÿ›  Features

Wide Version Compatibility

Supports all Minecraft versions from 1.7.2 to 26.2 (and beyond) natively, no need for ViaVersion or additional compatibility layers.

Built-in Proxy Support

Integrates with all major Minecraft proxies:

  • Velocity (Modern Forwarding)
  • BungeeCord (Legacy Forwarding)
  • BungeeGuard & BungeeGuardPlus authentication

Ultra-Lightweight & Highly Scalable

When running natively, PicoLimbo uses near 0% CPU while idle and can handle hundreds of players under 10 MB RAM. View benchmarks.

Skin Support

Player skins are supported out of the box.

Highly Configurable

Customize your server using a simple TOML configuration file, including welcome messages, spawn dimensions, server list MOTDs, and more. View configuration docs.

Schematic World (Experimental)

Load a custom world from a schematic file and customize the spawn location (1.16+ only).

Community & Support

If you have any questions, suggestions, or simply want to stay updated, please join the Discord server!