A lightweight Minecraft server written from scratch in Rust supporting Minecraft versions from 1.7.2 up to 26.2. https://picolimbo.quozul.dev/
  • Rust 94.9%
  • RenderScript 3.3%
  • Java 1%
  • Nix 0.6%
  • Dockerfile 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-05 14:20:44 +02:00
.github feat: preliminary support for 26.3-pre-2 2026-09-05 14:02:54 +02:00
crates feat: preliminary support for 26.3-pre-2 2026-09-05 14:02:54 +02:00
data_generator feat: preliminary support for 26.3-pre-2 2026-09-05 14:02:54 +02:00
docker chore: Upgrade Rust to 1.98.1 and dependencies 2026-09-05 14:20:44 +02:00
docs feat: preliminary support for 26.3-pre-2 2026-09-05 14:02:54 +02:00
java_wrapper chore: Upgrade velocity to 4.1.1 2026-09-05 14:07:57 +02:00
nix feat: Nix flake (#74) 2026-06-06 10:51:53 +02:00
pico_libraries feat: preliminary support for 26.3-pre-2 2026-09-05 14:02:54 +02:00
pico_limbo feat: preliminary support for 26.3-pre-2 2026-09-05 14:02:54 +02:00
pterodactyl/eggs chore: release v1.10.0+mc1.21.11 2026-01-10 21:01:45 +01:00
.dockerignore refactor: Data generator & registry provider 2026-09-02 18:10:37 +02:00
.gitignore refactor: Data generator & registry provider 2026-09-02 18:10:37 +02:00
Cargo.lock chore: Upgrade Rust to 1.98.1 and dependencies 2026-09-05 14:20:44 +02:00
Cargo.toml chore: Upgrade Rust to 1.98.1 and dependencies 2026-09-05 14:20:44 +02:00
CHANGELOG.md chore: Upgrade Rust to 1.98.1 and dependencies 2026-09-05 14:20:44 +02:00
CONTRIBUTING.md chore: add tutorials and update docs 2026-04-06 11:27:22 +02:00
docker-compose.yml fix: binary not present in Docker image 2026-01-11 11:37:40 +01:00
flake.lock feat: Nix flake (#74) 2026-06-06 10:51:53 +02:00
flake.nix feat: Nix flake (#74) 2026-06-06 10:51:53 +02:00
LICENSE chore: add project license #6 2025-05-15 09:13:53 +02:00
package-lock.json chore: update github actions 2026-07-24 19:35:33 +02:00
package.json feat: docs website 2025-07-02 15:37:45 +02:00
README.md feat: Added support for schematic for 1.13 onwards, fixed lighting for 1.16 and 1.17 2026-09-02 18:10:39 +02:00
rust-toolchain.toml chore: Upgrade Rust to 1.98.1 and dependencies 2026-09-05 14:20:44 +02:00

PicoLimbo

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

Supporting all Minecraft versions from 1.7.2 through 26.2

GitHub CI Latest Release License Discord

Star this repo💬 Join Discord📖 Read Docs

PicoLimbo.png
Schematic from LOOHP/Limbo


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.13+ only).

PicoLimbo.png
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

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

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.