promotional bannermobile promotional banner
premium banner
Server-driven reconnect/transfer for Forge 1.20.1. A server can instruct the client to disconnect and connect to another address (ideal for lobby → main setups behind a proxy).

Description

NeoBoxReconnect (Forge 1.20.1)

NeoBoxReconnect is a lightweight client + server mod that lets a Forge server trigger a seamless reconnect to another server address.

This is especially useful for networks that run a lobby server and want to send players to a main server after login, tutorials, or queue checks — typically behind Velocity or similar proxies.


How it works

  • The server sends a small network packet to the client containing a target host/port.

  • The client receives it and starts Minecraft’s normal connection flow to the target server.


Features

  • /neoboxreconnect command (run by the player) to reconnect to a configured default target

  • Optional host/port arguments:
    /neoboxreconnect <host> <port>

  • Configurable default target host/port

  • Optional automatic redirect after join (recommended OFF for Auth plugins)


Recommended setup (Auth / Lobby networks)

For setups using authentication plugins/mods (e.g. AuthMe), the safest approach is:

  • Keep auto redirect disabled

  • Trigger /neoboxreconnect after successful login

  • Optionally add a delay (e.g. 2–5 seconds)

This avoids redirecting too early before the client is fully ready.