NanoLimbo | 1.7 - 1.21 icon

NanoLimbo | 1.7 - 1.21 -----

The lightweight, high performance limbo server




NanoLimbo 1.12.0 — Minecraft 1.21.2 → 1.21.11 / 26.1

Major update bringing NanoLimbo up to the current Minecraft protocol line, plus a significant modernization pass. Huge thanks to @BoomEaro for doing the heavy lifting on the protocol rewrite, and to @YueMi-Development and @Biquaternions for small but neat patches on top.

NEW PROTOCOL SUPPORT
  • Minecraft 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11 and 26.1
  • Rewrote the login → configuration phase for the post-1.20.5 known-packs handshake (PacketKnownPacks, PacketUpdateTags, per-version PacketRegistryData)
  • New play packets: PacketLogin (replaces PacketJoinGame), PacketChunkWithLight with real heightmaps + biome palette + light update, PacketGameEvent with start_waiting_for_chunks
  • Redesigned PacketPlayerPositionAndLook for the 1.21.2 teleport-flags bitset

NEW FEATURES
  • MiniMessage text format in every text field (chat, title, subtitle, boss bar, player-list header/footer, MOTD). Legacy &-codes and raw JSON are still accepted.
  • Native Netty transportsepoll, io_uring (Linux x86_64/aarch64) and kqueue (macOS x86_64/aarch64), with automatic NIO fallback
  • Per-connection packet rate limiting — new traffic config block limits packet count and byte rate per player
  • External secret files — load Velocity secret and BungeeGuard tokens from a file via @-prefix:

    Code (YAML):

    infoForwarding
    :
      type
    : MODERN
      secret
    : '@secret.txt'         # read from ./secret.txt

    # or for BungeeGuard:
    infoForwarding
    :
      type
    : BUNGEE_GUARD
      tokens
    : '@tokens.txt'         # one token per line, '#' comments allowed
     
  • Privacy-friendly logging — new logPlayersIp config flag. Set to false to redact player IP addresses from connect logs (GDPR-friendly).
  • New version (alias: ver) console command
  • Improved VarIntFrameDecoder and pipeline robustness

BREAKING CHANGES (upgrading from 1.8.x)
  • Requires Java 17 or higher (was Java 11)
  • dimension: NETHERdimension: THE_NETHER
  • useEpoll: truenetty.transportType: EPOLL (also accepts NIO, IO_URING, KQUEUE)
  • Built jar is now NanoLimbo.jar — update your start script:

    Code (Bash):

    # Before
    java -jar NanoLimbo-1.8.1-all.jar

    # After
    java -jar NanoLimbo.jar
     
  • New optional keys: secureProfile, logPlayersIp, and the traffic block. Defaults are safe — no edit required if you don't care.
  • Your existing legacy &-codes and raw-JSON text values keep working unchanged — migration to MiniMessage is optional.

UNDER THE HOOD
  • Build modernization: Gradle Kotlin DSL, version catalog, Lombok, GitHub Actions for CI + release
  • Netty 4.1.101 netty-all → Netty 4.2.11 split modules with native transports bundled in the shadow jar
  • Adventure stack added (api / gson / legacy / plain / json / nbt + MiniMessage, all 4.26.1)
  • Configuration serializers refactored into dedicated classes
  • 17 per-version dimension codecs + matching tag NBT files (for 1.20.5+)

CREDITS
  • BoomEaro (Valentine) — the 1.21.2 → 26.1 protocol rewrite, MiniMessage stack, native transports, build modernization
  • YueMi-Development@-prefix for external secret/token files
  • BiquaternionslogPlayersIp privacy flag

LINKS
----------, Apr 15, 2026

Added MC 1.21 support.
----------, Jun 14, 2024

  • Support for MC 1.20.5, 1.20.6.
  • Rewritten packet limiter.
  • Improved VarInt writing.
  • Added Logback logger to make it possible to write logs to file and see logs from other libraries, like Netty.
Remember to recreate config file, because it has breaking changes.
To run this version of limbo, you need at least JRE 11.

Thanks to all contributors for keeping this project alive!
----------, May 2, 2024

Added MC 1.20.3-1.20.4 support (thanks to @BoomEaro)
----------, Dec 30, 2023

  • MC 1.20.2 support (thanks to @BoomEaro).
  • Console command to check current limbo version (version, ver).
  • Experimental function to limit incoming traffic. Update the settings.yml manually for this.
----------, Oct 1, 2023

  • Support for MC 1.20
  • Option to return static protocol version on a ping (to support ViaVersion).
----------, Jun 10, 2023

Added 1.19.4 support (thanks to @BoomEaro)
----------, Mar 15, 2023

  • Added MC 1.19.3 support (thanks to @BoomEaro);
  • Added MC 1.7.X support (thanks to @RaphiMC);
  • Removed useless spawnPosition from config. Now spawn position depends on client version, to avoid crashes. This should resolve problems for Pterodaktyl users with incorrect configuration parsing.
----------, Dec 11, 2022

  • Support for MC 1.19.1
  • Fixed join packet for 1.9.1
  • Minor changes in sources
----------, Jul 28, 2022

  • Added support for MC 1.18.2 and 1.19
  • Added console commands
  • Fixed bugs
Thanks to all contributors who keep this project alive!
----------, Jul 2, 2022

Fixed crash on 1.16.5 clients due missing PlayerInfo packet
----------, Feb 7, 2022

  • Ability to hide and show player list (hidden by default)
  • Added player list header and footer (disabled by default)
  • Ability to set brand name under F3 (disabled by default)
  • Reformatted debug levels
  • Updated Netty to the latest stable version
  • Fixed crashing for Forge clients on 1.18+
  • Fixed connection for networks with ViaVersion on proxy side
  • Other minor optimizations
Important: Don't forget to delete old settings file. Server will create new one with new or changed parameters. You also should save old config to paste required data in the new one.

Thanks everyone who contributed to this project!
----------, Feb 7, 2022

Added test support for 1.18
----------, Nov 30, 2021

Added BungeeGuard support. Don't forget to recreate settings file.
----------, Nov 13, 2021

Hello everyone! This update comes with new cool features:

* Multiple versions support (1.8 - 1.17). Now you don't need to use protocol hack on proxy side!
* Ability to send title on join.
* Optimizations and code improvements.
----------, Oct 31, 2021

Fixed compatibility with OptiFine clients. Previously, clients with OptiFine crashes due to the lack of some dimension data.
----------, Dec 27, 2020

This is multiple update since server was a bit changed while waiting confirmation.

  • Added gamemode switching in the configuration;
  • Added new params in the configuration to configure Netty (for advanced users);
  • Added pre-encoding of some packets for more fast sending;
  • Added native Epoll transport support for Linux;
  • Optimized connections and threads using;
  • Added Declare Commands packet to support proxy's tab-complete.
----------, Dec 15, 2020

Resource Information
Author:
----------
Total Downloads: 14,899
First Release: Dec 14, 2020
Last Update: Apr 15, 2026
Category: ---------------
All-Time Rating:
39 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings