Skip to content

A lightweight Minecraft server written from scratch in Rust supporting Minecraft versions from 1.7.2 up to 1.21.8.

License

Notifications You must be signed in to change notification settings

Quozul/PicoLimbo

Repository files navigation

PicoLimbo

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

Supporting all Minecraft versions from 1.7.2 through 1.21.8

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 or suggestions, 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 1.21.8, excluding snapshots, with only 36 implemented packets covering over 47 different protocol versions or 75 Minecraft versions.

Features

🎮 Wide Version Compatibility

Supports all Minecraft versions from 1.7.2 to 1.21.8 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.19+ only).

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


Quick Start

Docker

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

Binary

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


Star History

Star History Chart

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.

About

A lightweight Minecraft server written from scratch in Rust supporting Minecraft versions from 1.7.2 up to 1.21.8.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages