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

GitHub CI Latest Release License Discord

An ultra-lightweight, multi-version Minecraft limbo server written in Rust. It currently supports all Minecraft versions from 1.7.2 through 1.21.8.


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.

When idle, PicoLimbo uses almost no resources: 0% CPU and less than 10 MB of memory, making it extremely lightweight.

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 28 implemented packets covering over 47 different protocol versions or 75 Minecraft versions.

Features

⚙️ Highly Configurable

Customize your server using a simple TOML configuration file, including welcome message, spawn dimension, server list MOTD, and more.

🔀 Built-in Proxy Support

Seamlessly integrates with major Minecraft proxies:

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

🎮 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 under 10 MB RAM, enabling thousands of concurrent players thanks to Rust’s asynchronous runtime and efficient design.

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:master

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


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