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. |
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Velocity-WoL 1.0.0 1.0.0 |
26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
velocity
|
Download |