VelocityPteroPower

⚠️ Alpha build for branch: 0.9.6-rework

This build is generated automatically on every commit and may be unstable or untested. Need help? Join the Discord: https://discord.pluginz.dev

What's in testing (commits in this push)

• edb3549 fuck you 7 .... Took 6 minutes (TubYoub)

Links

• Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commits/0.9.6-rework
• This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit/edb35499d97daf67121908330edd668f642c1d53
• Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compare/0.9.6-rework~20...0.9.6-rework

⚠️ Alpha build for branch: 0.9.6-rework

This build is generated automatically on every commit and may be unstable or untested. Need help? Join the Discord: https://discord.pluginz.dev

What's in testing (commits in this push)

• 1e419a7 testing package release for api Took 5 minutes (TubYoub)

Links

• Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commits/0.9.6-rework
• This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit/1e419a72fbd5d43d1fb2756d476ecaf600c2b467
• Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compare/0.9.6-rework~20...0.9.6-rework

⚠️ Alpha build for branch: 0.9.6-rework

This build is generated automatically on every commit and may be unstable or untested. Need help? Join the Discord: https://discord.pluginz.dev

What's in testing (commits in this push)

• d7fac19 testing package release for api Took 5 minutes (TubYoub)

Links

• Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commits/0.9.6-rework
• This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit/d7fac1966171ecfea0d6b555e84db3ec638758d6
• Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compare/0.9.6-rework~20...0.9.6-rework

⚠️ Alpha build for branch: 0.9.6-rework

This build is generated automatically on every commit and may be unstable or untested. Need help? Join the Discord: https://discord.pluginz.dev

What's in testing (commits in this push)

• fd0077c testing package release for api Took 49 minutes (TubYoub)

Links

• Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commits/0.9.6-rework
• This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit/fd0077c5e724943ec2ed76231669c29214bbdd46
• Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compare/0.9.6-rework~20...0.9.6-rework

Sorry for the absence but here yall go guys:

[0.9.5]

TL;DR

• Smarter networks at scale: multi‑lobby/limbo balancing with auto‑start and dynamic scaling, resource‑aware commands with live metrics, and sturdier idle shutdown and limbo handling.

Highlights

• New: Multi‑lobby/limbo balancing with auto‑start and scaling
• New: Resource‑aware /ptero list and /ptero info with live metrics
• New: Command to start everything: /forcestartall
• New: Player server history and smarter connection routing
• Stability: More robust idle shutdowns, limbo handling, and cooldown logic
• Quality: MiniMessage message system, better suggestions, and bStats metrics

Commands

• /ptero list and /ptero info <server> with MiniMessage formatting.
  • Live metrics: CPU, memory, disk, network, uptime.
  • Resource caching with configurable TTL (default 10s) and optional prefetch.
  • List shows TTL to auto‑shutdown and respects alwaysOnline.
• /forcestartall to start all managed servers at once.
• Enhanced chat command suggestions.

Resource usage and scheduling

• Live resource fetch for Pelican and Pterodactyl with rate‑limit, caching, and fallback to "unavailable" on errors.
• Periodic idle shutdown sweep via idleShutdownCheckInterval.
• Only online servers are eligible for idle shutdown scheduling.
• alwaysOnline servers are excluded from idle shutdown and will be started on proxy startup; periodic checks ensure they stay up.

Multi‑lobby/limbo support

• New LobbyBalancerManager for routing and scaling across multiple lobbies/limbos.
• Strategies: ROUND_ROBIN, LEAST_PLAYERS, LEAST_CPU.
• Auto‑start/scale:
  • Maintain a minimum online (minOnline) and optionally cap with maxOnline.
  • Pre‑start early via preStartThresholdPercent to avoid bottlenecks.
  • Scale‑up by players or CPU (LEAST_CPU + cpuScaleUpThreshold).
• Health checks and fallback:
  • If a lobby fails to come online, automatically try another.
  • Cooldowns to avoid spamming failing instances: startFailureFallbackSeconds, startFailureCooldownSeconds.
• Cap control:
  • Choose whether lobbies/limbos count towards maxOnlineServers: countLobbiesInMaxOnline, countLimbosInMaxOnline.
  • lobbiesToUse limits to the first N lobbies.
• Legacy config migration:
  • limboServer is auto‑migrated into lobbyBalancer.limbos and the old key is removed.

Connection handling and UX

• Start initiator tracking and periodic cleanup.
• Players attempting to join a starting server are placed in a connection queue.
• Connection reattempt logic; players reconnect to the server they started.
• Configurable limbo and forced‑host behavior:
  • sendToLimboOnStart: optionally send a player to a limbo after starting a server from a lobby.
  • forcedHostOfflineBehavior: choose how to handle connections when a forced‑host target is offline.
• New config: shutdownOnProxyExit to stop specific servers on proxy shutdown (supports list or all; defaults to empty list).
• Player server history.

Messages and formatting

• New MessageManager with MiniMessage; placeholder rendering fixed. #16 #19
• Status color handled in code; tag casing corrected.
• Multi‑language groundwork and migration to MiniMessage keys.

Panel support and automation

• Pelican API key prefix detection updated (recognizes Pelican again).
• Autoscaling API threads for large networks.
• Version checker updated for alpha versioning via GitHub Actions.
• Alpha builds auto‑published to Modrinth on every commit.

Metrics

• bStats: added metrics for
  • Servers managed by VPP
  • Servers started by VPP
  • PanelType

Fixes

• Limbo
  • Fixed players staying in limbo on first connect.
  • Fixed redirection to limbo for player connections.
  • Added limbo "why" tracking and a periodic sweep to clear stuck players; ignores players who moved themselves.
• Cooldowns
  • commandCooldown = 0 now correctly disables the cooldown.
  • Fixed a variable bug that caused commandCooldown to always default to 10s.
• Whitelist and shutdowns
  • Whitelist check cancels events and informs players properly.
  • Idle shutdown improved for servers that never receive players after start.
• Messages and docs
  • Usage message placeholder fixed.
  • README updated with missing permissions and commands.
  • Comments updated for the new Pelican key prefix.
• Consistency in general:
  • Improved server management #17
  • Let everyone get into the Limbo not only the player who started the server #21
  • Fixed config comments (only update when recreating the config file) #23

Config keys touched (summary)

• lobbyBalancer.* (lobbies, limbos, minOnline, maxOnline, strategies, health checks, scaling thresholds, counts, lobbiesToUse)
• resourceCacheSeconds, resourcePrefetchEnabled
• idleShutdownCheckInterval
• sendToLimboOnStart
• forcedHostOfflineBehavior
• shutdownOnProxyExit
• alwaysOnline

New Contributors

• @majoranimal made their first contribution in https://github.com/Tubs-Pluginz/VelocityPteroPower/pull/18

Full Changelog: https://github.com/Tubs-Pluginz/VelocityPteroPower/compare/v0.9.4-beta...v0.9.5-beta