PicoLimbo

Warning

This software is highly experimental. Use at your own risks and report any bugs by submitting an issue on GitHub.

An attempt at writing a lightweight Minecraft server from scratch in Rust. Currently, supports 1.7.2 up to 1.21.4.

Introduction

This project is a lightweight Minecraft server written in Rust designed to serve as an AFK or waiting server. Its primary focus is on efficiency, implementing only the essential packets required for client login and maintaining connection (keep alive) without unnecessary overhead.

The server does not aim to replicate every feature or packet supported by Minecraft servers. However, it aims to support all Minecraft versions from 1.7.2 up to the most recent ones.

This project only implements 23 different packets and support more than 44 different Minecraft versions.

Getting Started

Pterodactyl

To use in the Pterodactyl panel, you can import the egg file into your panel.

Using Docker

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

Using Docker Compose

A sample docker-compose.yml file is available in the repository.

Features

Velocity Modern Forwarding

PicoLimbo supports Velocity Modern Forwarding, to enable it, pass the secret key as a command line argument ot the pico_limbo binary.

pico_limbo --address 127.0.0.1:25565 --secret-key MyForwardingSecret

Similar Projects

• Limbo - Supports only one version of the game at a time
• NanoLimbo
• TyphoonLimbo - No longer active
• LiteLimbo - No longer active

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.