<div align="center">

PicoLimbo

An ultra-lightweight, multi-version Minecraft limbo server written in Rust

Supporting all Minecraft versions from 1.7.2 through 26.2

⭐ Star this repo • 💬 Join Discord • 📖 Read Docs

Schematic from LOOHP/Limbo

</div>

---

Community & Support

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

Introduction

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
through 26.2, excluding snapshots.

Features

🎮 Wide Version Compatibility

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

⚡ Ultra-Lightweight & Highly Scalable

Uses 0% CPU while idle and 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.

🌍 Schematic World (Experimental)

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

The screenshot shows just a few of the supported Minecraft versions.

---

Quick Start

Pterodactyl

Official eggs for Pterodactyl are provided in the pterodactyl directory. More information about PicoLimbo's Pterodactyl eggs.

Docker

shellCopy
docker run --rm -p "25565:25565" ghcr.io/quozul/picolimbo:latest

Java Wrapper

For user wishing to run PicoLimbo inside your Velocity, BungeeCord proxy as a plugin or as a standalone jar file, you can download the Java Wrapper from Modrinth.

Binary / Standalone

Download from GitHub Releases

For more detailed installation and configuration instructions, please refer to
the documentation website.

Documentation

Complete documentation is available at https://picolimbo.quozul.dev/

For detailed installation instructions, configuration options, and usage examples, please visit the documentation
website.

---

Similar Projects

• Limbo: Supports only one Minecraft version at a time
• NanoLimbo: Actively maintained
  (see BoomEaro's fork)

---

Star History

Contributing

Contributions are welcome! If you encounter any issues or have suggestions for improvement, please submit an issue or
pull request on GitHub. Make sure to follow the existing code style and include relevant tests.

1. Fork the repository.
2. Create a new branch git checkout -b <branch-name>.
3. Make changes and commit git commit -m 'Add some feature'.
4. Push to your fork git push origin <branch-name>.
5. Submit a pull request.