Перейти к содержимому
Mineforgian

Velocity - Auto Reconnect

Keeps players online while your server restarts and reconnects them automatically on Velocity, with no limbo server needed.

Загрузки
347
Подписчики
2
Обновлён
27 июня 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 12 апреля 2026 г.

Support me on Ko-fi

VelocityReconnect

Keep players connected during backend restarts and automatically bring them back when the server is ready.

VelocityReconnect prevents players from being kicked from your network when a backend restarts, crashes, or goes down for maintenance. Players are held safely inside the proxy while the plugin waits for the backend to return.

By default, VelocityReconnect uses its built-in no-limbo mode. No additional backend, Limbo server, or backend-side plugin is required. A real holding server can still be used if preferred.

VelocityReconnect reconnecting screen

Features

  • Native Velocity reconnect handling
  • Built-in no-limbo mode enabled by default
  • No additional backend plugin required
  • Automatic backend availability detection
  • Automatic and manual reconnect modes
  • Global and per-server timing settings
  • Optional real holding-server support
  • Optional gradual reconnect queue
  • Configurable queue batch size and interval
  • Custom titles, subtitles, and actionbar messages
  • Animated reconnect messages
  • Configurable reconnect timing and retry behavior
  • Fallback server support
  • Per-server permission support
  • Simple Voice Chat compatibility in built-in holding mode
  • Clean player disconnect and proxy shutdown handling

Automatic Reconnecting

Automatic mode detects when a backend becomes available and reconnects waiting players without requiring manually matched startup times.

Manual mode is also available if you prefer fixed reconnect delays. Timing can be configured globally or separately for each backend.

Gradual Reconnect Queue

The optional reconnect queue prevents every waiting player from joining the backend at the same time.

When enabled, VelocityReconnect confirms that the backend is ready with one player before gradually reconnecting everyone else in configurable batches.

The queue is disabled by default and can be configured globally or per server.

Commands

Command Description
/velocityreconnect enable Enables reconnect handling.
/velocityreconnect disable Disables reconnect handling and restores normal Velocity disconnect behavior.
/velocityreconnect status Shows whether reconnect handling is enabled or disabled.
/velocityreconnect reload Reloads the configuration.

Setup

  1. Download VelocityReconnect and place it in your Velocity proxy's plugins folder.
  2. Restart the Velocity proxy.
  3. Open the generated configuration file.
  4. Keep automatic mode enabled, or configure manual reconnect timing to match your server.
  5. Ensure the shutdown message or regex matches the message sent by your backend.
  6. Enable and configure the gradual reconnect queue if desired.
  7. Run /velocityreconnect reload after making changes.
  8. Test a backend restart and enjoy smoother maintenance!

Credits

VelocityReconnect is based on and ported from tau's BungeeReconnect. Credit and thanks go to tau for the original plugin and concept.

VelocityReconnect includes additional Velocity-specific functionality, automatic backend detection, gradual reconnect queues, and built-in proxy holding support.

Anonymous Statistics

VelocityReconnect bStats

Ченджлог

1.1.0Альфа26.1.1, 26.1.2, 26.2 · 27 июня 2026 г.

VelocityReconnect 1.1.0

This update introduces automatic server detection and an optional gradual reconnect queue.

New Features

  • Automatic server detection is now the default.
  • No backend plugin or Limbo server is required.
  • Automatic and manual reconnect modes can be configured per server.
  • Optional per-server timing overrides.
  • Optional FIFO queue for gradually reconnecting players.
  • Configurable batch size and delay between batches.
  • Waiting players see Reconnecting once the backend is confirmed online.

Improvements

  • Players waiting for the same backend share one availability scanner.
  • A real Minecraft connection must succeed before queued batches begin.
  • Failed reconnects automatically return to the queue.
  • Queue and scanner tasks shut down cleanly.
  • Existing config versions 23 and 24 remain supported.
  • Improved configuration comments and safer example server names.

Configuration

  • Config version updated to 25.
  • Automatic mode uses the global scanner settings by default.
  • Manual settings are ignored when automatic mode is selected.
  • Queue settings can be configured globally or per server.
  • The reconnect queue is disabled by default.
  • /velocityreconnect reload applies changes to future reconnect sessions.

No Limbo server or backend plugin is required.

1.0.2Альфа26.1.1, 26.1.2, 26.2 · 9 мая 2026 г.
  • Fixed built-in virtual holding reconnects failing on backend restart.
  • Fixed players sometimes getting kicked instead of being held and reconnected.
  • Fixed reconnect loops where the plugin kept trying forever even after the backend was back online.
  • Fixed the reconnecting screen disappearing too early and ending in a timeout.
  • Fixed heavy reconnect screen flickering and repeated visual reloads while waiting.
  • Fixed stuck in-flight backend connections that could block reconnect completion.
  • Fixed cases where players timed out while sitting in built-in holding by adding proper keepalive handling.
  • Fixed ghost sessions where the proxy could think a player was still online after leaving during reconnecting/holding.
  • Fixed “already connected to the proxy” / stuck session issues after failed reconnect attempts.
  • Fixed cleanup of backend and in-flight connections when a player disconnects.
  • Fixed shutdown handling so plugin tasks are cancelled properly when the proxy stops.
  • Fixed the proxy shutdown warning about the plugin executor not closing in time.
  • Fixed disabled mode so backend restarts use a normal clean disconnect instead of a broken connection reset style disconnect.
  • Fixed reconnect completion handling to avoid false failure states after a successful reconnect.
  • Improved reconnect finalization timing so players are sent back faster once the backend is actually ready.
  • Improved built-in holding handoff logic for modern Velocity config/play switching.
  • Improved compatibility with voice chat reconnect behavior so voice chat can reinitialize correctly after reconnecting.

Added /velocityreconnect enable Added /velocityreconnect disable Added /velocityreconnect status Added bStats support. Improved config readability and setting descriptions.

1.0.1Альфа26.1, 26.1.1, 26.1.2 · 12 апреля 2026 г.

VelocityReconnect 1.0.1 Bug Fixes

  • Fixed built-in holding sessions not cleaning up correctly when a player disconnected
  • Fixed ghost proxy sessions that could cause “already connected to the proxy”
  • Fixed reconnect state getting stuck after successful backend reconnection
  • Fixed built-in holding disconnect handling so players are cleaned up properly instead of being left in a broken state
  • Fixed several reconnect flow issues that could cause players to be kicked during backend restart
  • Fixed reconnect timing issues where the plugin could keep showing reconnecting even after the backend had accepted the player
  • Fixed multiple built-in holding edge cases that caused unstable reconnect behavior during backend startup
  • Improved reconnect stability while the backend is still coming online
  • Improved overall handling of failed and repeated reconnect attempts
1.0.0-SNAPSHOTАльфа26.1, 26.1.1, 26.1.2 · 12 апреля 2026 г.

First Release

Комментарии

Загружаем…