/NanoLimbo

The lightweight, high performance Minecraft limbo server

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

NanoLimbo

This is lightweight minecraft limbo server, written on Java with Netty. The main goal of the project is maximum simplicity with a minimum number of sent and processed packets. This limbo is empty, there are no ability to set schematic building since this is not necessary. You can send useful information in chat or BossBar.

No plugins, no logs. The server is fully clear. It only able keep a lot of players while the main server is down.

The general features:

  • High performance. The server not saves and not cached any useless (for limbo) data.
  • Doesn't spawn threads per player. Uses fixed threads pool.
  • Support for BungeeCord and Velocity info forwarding.
  • Support for BungeeGuard handshake format.
  • Multiple versions support.
  • Fully configurable.
  • Lightweight. App size around 2MB.

Versions support

Symbol X means all minor versions.

  • 1.7.X
  • 1.8.X
  • 1.9.X
  • 1.10.X
  • 1.11.X
  • 1.12.X
  • 1.13.X
  • 1.14.X
  • 1.15.X
  • 1.16.X
  • 1.17.X
  • 1.18.X
  • 1.19
  • 1.19.1
  • 1.19.2
  • 1.19.3

The server doesn't support snapshots.

Commands

  • help - Show help message
  • conn - Display amount of connections
  • mem - Display memory usage stats
  • stop - Stop the server

Note, that it also will be closed correctly if you just press Ctrl+C.

Installation

The installation process is simple.

  1. Download the latest version of program here
  2. Put jar file in the folder you want.
  3. Create a start script as you did it for Bukkit or BungeeCord with command like this: java -jar NanoLimbo-<version>.jar
  4. The server will create settings.yml file. It's a server configuration.
  5. Configure it as you want and restart server.

About player info forwarding

The server supports player info forwarding from the proxy. There are several types of info forwarding:

  • LEGACY - The BungeeCord IP forwarding.
  • MODERN - Velocity native info forwarding type.
  • BUNGEE_GUARD - BungeeGuard forwarding type.

If you use BungeeCord, or Velocity with LEGACY forwarding, just set this type in the config.
If you use Velocity with MODERN info forwarding, set this type and paste secret key from Velocity config into secret field. If you installed BungeeGuard on your proxy, then use BUNGEE_GUARD forwarding type. Then add your tokens to tokens list.

Contributing

You can create pull request, if you found some bug, optimization ability, or you want to add some functional, which is suitable for limbo server and won't significantly load the server.

Building

Required software:

  • JDK 1.8+
  • Gradle 7+

To build minimized .jar, go to project root and write in terminal:

./gradlew shadowJar

Contacts

If you have any question or suggestion, join to Discord server