?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings

Velocity-WoL

A wake-on-lan plugin for Minecraft Velocity proxy

5downloads
0followers
5downloads
0followers

Compatibility

Minecraft: Java Edition

26.3
26.2
26.1.x

Platforms

Links

View source

Tags

Creators

Details

Licensed MIT
Published 19 hours ago
Updated 2 weeks ago

Velocity-WoL

Velocity-WoL is a Velocity proxy plugin that wakes up offline backend servers on demand using Wake-on-LAN (WoL).

When a player connects to an offline server, the proxy sends a WoL magic packet, holds the player in a holding server (such as Limbo) with action bar notifications, and automatically transfers them once the server is reachable.

Features

  • On-demand wake-up: Sends WoL magic packets to wake physical hosts when players join.
  • Holding & auto-transfer: Keeps players on a waiting server with action bar updates and moves them once online.
  • Scheduled downtime: Optional time windows to disable wake-ups during maintenance or nighttime hours.

Requirements

  • A registered holding server in velocity.toml.
  • Target machine with Wake-on-LAN enabled in BIOS/UEFI and network adapter settings.

Configuration

The plugin generates plugins/velocity-wol/config.conf on first startup.

General Settings

Option Default Description
holding-server limbo Server registered in velocity.toml where waiting players are held.
ping-interval-seconds 2 Interval in seconds between ping checks to the target server.
wol-packet-interval-seconds 10 Interval in seconds to repeat WoL packets while players wait.
wake-timeout-seconds 60 Maximum time in seconds to wait before aborting an unresponsive wake cycle.
messages.waking-action-bar ⌛ Waking up... Action bar message shown while waking up (supports MiniMessage).
messages.downtime-action-bar <red>⌚ ...</red> Action bar message shown if a player joins during scheduled downtime.

Server Settings (servers.<name>)

Option Default Description
mac 00:00:00:00:00:00 MAC address of the target network interface (accepts : or -).
broadcast-ip 255.255.255.255 Subnet broadcast address (e.g., 192.168.1.255).
port 9 Target UDP port for the magic packet (usually 7 or 9).
downtime.enabled false Enables scheduled downtime for this server.
downtime.timezone UTC Time zone used to evaluate downtime (e.g., Europe/Berlin).
downtime.start-time 00:00 Start time in 24-hour notation (HH:mm).
downtime.end-time 08:00 End time in 24-hour notation (HH:mm). Supports overnight ranges crossing midnight.