🌟 AuricNetwork

Zero-Proxy Network System

AuricNetwork allows you to create a full Minecraft server network without any proxy (BungeeCord, Velocity). It uses Paper's native Player#transfer method (1.20.5+) to move players directly between servers. Important: On the target server, you must set accepts-transfers=true in its server.properties file.

Download on Modrinth Discord Support YouTube Channel

✨ Key Features

No Proxy Required: Direct server‑to‑server transfers using Player#transfer().

Graphical Server Selector: Fully customizable chest GUI with player head, online player count and server status placeholders.

Rescue Server (Fallback): On graceful shutdown, all online players are automatically moved to a configured rescue server. Console logs detail the transfer.

Multi‑Lobby Balancing: /lobby can send players to a random lobby from a list – ideal for large networks.

Join & Respawn Spawns: Set teleport locations for join and respawn events.

Live Server Status: Fetches real‑time online players and online/offline/full status via api.mcsrvstat.us.

⚙️ Commands

/auricnetwork reload - Reloads config and language files.
Permission: auricnetwork.admin
/auricnetwork menu - Opens the server selector GUI.
Permission: auricnetwork.menu
/auricnetwork setjoinspawn - Sets the join spawn at your current location.
Permission: auricnetwork.admin
/auricnetwork setrespawnspawn - Sets the respawn spawn at your current location.
Permission: auricnetwork.admin
/server <name> - Transfers you to another server.
Permission: auricnetwork.server
/spawn [join|respawn] - Teleports to the configured spawn point.
Permission: auricnetwork.spawn
/lobby or /hub - Sends you to the lobby (supports random balancing).
Permission: auricnetwork.lobby

👑 Permissions

auricnetwork.admin - Reload command, set spawns, update notifications.
auricnetwork.server - Use /server to transfer.
auricnetwork.menu - Open the server selector GUI.
auricnetwork.spawn - Use /spawn.
auricnetwork.lobby - Use /lobby or /hub.

📄 Configuration Guide

The config.yml file controls every aspect of AuricNetwork. Below is a detailed explanation of each section.

🌐 Servers

List all servers in your network. The key is the name used in commands and the menu, the value is the IP:port.

Click to view code

servers:
  lobby: "127.0.0.1:25565"
  survival: "127.0.0.1:25566"

🎮 Transfer Immersion

Delay before transfer (in seconds), sound effect, and volume fade‑out.

Click to view code

transfer_immersion:
  delay: 3.0
  sound:
    enabled: true
    sound_id: "block.amethyst_block.hit"
    fade_out: true

🌍 Language

Set en (English) or es (Spanish). Leave empty to auto‑detect from the player's client.

Click to view code

language: "en"

🏠 Join & Respawn Spawn

Enable and set coordinates for where players spawn when they join or respawn.

Click to view code

join_spawn:
  enabled: false
  world: "world"
  x: 0.5
  y: 64.0
  z: 0.5
  yaw: 0.0
  pitch: 0.0

respawn_spawn:
  enabled: false
  world: "world"
  x: 0.5
  y: 64.0
  z: 0.5
  yaw: 0.0
  pitch: 0.0

🔄 Lobby Balancing

If enabled, /lobby will send the player to a random server from the list instead of the default lobby.

Click to view code

lobby:
  enabled: false
  servers:
    - "lobby1"
    - "lobby2"

📡 Server Status API

Fetches live player counts and online status from api.mcsrvstat.us. Update interval in seconds.

Click to view code

server_status_api:
  enabled: false
  update_interval_seconds: 60

🆘 Rescue Server (Fallback)

When a server shuts down gracefully (e.g., /stop or a restart), AuricNetwork automatically transfers all online players to a configured rescue server. This prevents disconnections and improves user experience.

The fallback logs a detailed message to the console:

========================================
[AuricNetwork] Rescue server active!
Transferred 12 players to lobby (127.0.0.1:25565)
Server is shutting down gracefully.
========================================

To enable it, add to config.yml:

Click to view code

rescue_server:
  enabled: true
  target: "lobby"

Note: Works only on controlled shutdowns (not on crashes or kill -9).