⚠️ 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 listand/ptero infowith 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 listand/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.
/forcestartallto 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.
alwaysOnlineservers are excluded from idle shutdown and will be started on proxy startup; periodic checks ensure they stay up.
Multi‑lobby/limbo support
- New
LobbyBalancerManagerfor 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 withmaxOnline. - Pre‑start early via
preStartThresholdPercentto avoid bottlenecks. - Scale‑up by players or CPU (
LEAST_CPU+cpuScaleUpThreshold).
- Maintain a minimum online (
- 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. lobbiesToUselimits to the first N lobbies.
- Choose whether lobbies/limbos count towards
- Legacy config migration:
limboServeris auto‑migrated intolobbyBalancer.limbosand 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:
shutdownOnProxyExitto stop specific servers on proxy shutdown (supports list orall; defaults to empty list). - Player server history.
Messages and formatting
- New
MessageManagerwith 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 = 0now correctly disables the cooldown.- Fixed a variable bug that caused
commandCooldownto 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:
Config keys touched (summary)
lobbyBalancer.*(lobbies, limbos,minOnline,maxOnline, strategies, health checks, scaling thresholds, counts,lobbiesToUse)resourceCacheSeconds,resourcePrefetchEnabledidleShutdownCheckIntervalsendToLimboOnStartforcedHostOfflineBehaviorshutdownOnProxyExitalwaysOnline
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
⚠️ Alpha build for branch: dev
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)
- 9186576 update formatting Took 7 minutes (TubYoub)
- 8377990 update formatting Took 4 minutes (TubYoub)
- 69ac46f update formatting Took 3 minutes (TubYoub)
- 98fd099 Merge pull request #22 from Tubs-Pluginz/workflow-test Workflows (TubYoub)
- 0aa1f08 Player connect to the server they started Took 32 minutes (TubYoub)
- 51ecd45 usage message fixed to have the correct placeholder Took 2 minutes (TubYoub)
- 236287c Merge remote-tracking branch 'GitHub/0.9.5' into 0.9.5 (TubYoub)
- 3865879 feat: more metrics for bstats ### Features - Added
recordServerStartSignalSentmethod to track the total number of server start signals sent. - Implemented bStats custom charts to monitor server metrics like managed servers, total starts since boot, and panel types. ### Improvements - EnhancedcompareVersionsto sanitize pre-release and build metadata in version strings. - Introduced helper methods (sanitizeVersion,safeParseInt) for cleaner and safer version handling. - Optimized proxy shutdown process by including normalization and cleanup of the server list configuration. - Updatedconfig.ymlwith clearer documentation for theshutdownOnProxyExitsetting. ### Fixes - Resolved potential issues in handling malformed or null version strings in version comparison logic. Took 40 minutes (TubYoub) - 4b444cd feat: configurable limbo and forced-host behavior ### Features - Introduced
sendToLimboOnStartconfiguration option to enable sending players to a limbo server when their target server is starting. - AddedforcedHostOfflineBehaviorconfiguration with options (DISCONNECT,LOBBY_OR_LIMBO,LIMBO_ONLY) for managing forced-host joins when the target server is offline. ### Improvements - Enhanced logic to redirect players to holding servers (lobby or limbo) during server start scenarios, avoiding unnecessary disconnections. - Optimized connection flow to prevent redundant actions for players already connected to a limbo or lobby. ### Fixes - Correctly handle forced-host join failures by logging errors and falling back to default behavior when no valid holding servers are available. - Fixed potential issues with players being redirected or disconnected incorrectly during auto-connect routines. Took 46 minutes (TubYoub) - c3fb5d6 fix: limbo redirection for player connections Took 12 minutes (TubYoub)
- 9796795 chor: added missing permissions and commands to README.md Took 19 minutes (TubYoub)
- 983b0ba fix: weird behaviour when the CommandCooldown is set to 0 now it will just be ignored Took 11 minutes (TubYoub)
- 3cc562a chor: eddited comments to include the new Peli key prefix Took 3 minutes (TubYoub)
- 48a3ae5 feat: If a player moves to a limbo server there is record of why and also a sweep to clear limbos if a player gets stuck. iF a player moved there by himself or got moved they will be ignored Took 21 minutes (TubYoub)
- 04ab066 feat: Server history for players Took 28 minutes (TubYoub)
- ee804e9 bug: Had the wrong variable the whole time so commandCooldown just always defaulted to 10 seconds Took 21 minutes (TubYoub)
- 3e4b427 bug: Fix player staying in limbo on first connect Took 6 minutes (TubYoub)
- d5b9a0b feat: added autoscalling for apithreads to support servers using larger amounts of servers Took 50 minutes (TubYoub)
- aa9a851 Merge branch 'dev' into 0.9.5 (TubYoub)
- 6992e40 Merge pull request #24 from Tubs-Pluginz/0.9.5 Version 0.9.5 (TubYoub)
Links
⚠️ Alpha build for branch: 0.9.5
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)
- 7a2ea82 Fixed a typo in the whitelistreload command Fixed a typo in the whitelistreload command that caused a mismatch between the help message and the in-game command (majoranimal)
- 0e88c3b Merge pull request #1 from majoranimal/whitelist-reload-fix Fixed a typo in the whitelistreload command (majoranimal)
- 713e041 Merge pull request #18 from majoranimal/dev Fixed a typo in the whitelistreload command (TubYoub)
- aa9a851 Merge branch 'dev' into 0.9.5 (TubYoub)
Links
⚠️ Alpha build for branch: 0.9.5
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)
- d5b9a0b feat: added autoscalling for apithreads to support servers using larger amounts of servers Took 50 minutes (TubYoub)
Links
⚠️ Alpha build for branch: 0.9.5
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)
- 9796795 chor: added missing permissions and commands to README.md Took 19 minutes (TubYoub)
- 983b0ba fix: weird behaviour when the CommandCooldown is set to 0 now it will just be ignored Took 11 minutes (TubYoub)
- 3cc562a chor: eddited comments to include the new Peli key prefix Took 3 minutes (TubYoub)
- 48a3ae5 feat: If a player moves to a limbo server there is record of why and also a sweep to clear limbos if a player gets stuck. iF a player moved there by himself or got moved they will be ignored Took 21 minutes (TubYoub)
- 04ab066 feat: Server history for players Took 28 minutes (TubYoub)
- ee804e9 bug: Had the wrong variable the whole time so commandCooldown just always defaulted to 10 seconds Took 21 minutes (TubYoub)
- 3e4b427 bug: Fix player staying in limbo on first connect Took 6 minutes (TubYoub)
Links
⚠️ Alpha build for branch: 0.9.5
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)
- c3fb5d6 fix: limbo redirection for player connections Took 12 minutes (TubYoub)
Links
⚠️ Alpha build for branch: 0.9.5
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)
- 3865879 feat: more metrics for bstats ### Features - Added
recordServerStartSignalSentmethod to track the total number of server start signals sent. - Implemented bStats custom charts to monitor server metrics like managed servers, total starts since boot, and panel types. ### Improvements - EnhancedcompareVersionsto sanitize pre-release and build metadata in version strings. - Introduced helper methods (sanitizeVersion,safeParseInt) for cleaner and safer version handling. - Optimized proxy shutdown process by including normalization and cleanup of the server list configuration. - Updatedconfig.ymlwith clearer documentation for theshutdownOnProxyExitsetting. ### Fixes - Resolved potential issues in handling malformed or null version strings in version comparison logic. Took 40 minutes (TubYoub) - 4b444cd feat: configurable limbo and forced-host behavior ### Features - Introduced
sendToLimboOnStartconfiguration option to enable sending players to a limbo server when their target server is starting. - AddedforcedHostOfflineBehaviorconfiguration with options (DISCONNECT,LOBBY_OR_LIMBO,LIMBO_ONLY) for managing forced-host joins when the target server is offline. ### Improvements - Enhanced logic to redirect players to holding servers (lobby or limbo) during server start scenarios, avoiding unnecessary disconnections. - Optimized connection flow to prevent redundant actions for players already connected to a limbo or lobby. ### Fixes - Correctly handle forced-host join failures by logging errors and falling back to default behavior when no valid holding servers are available. - Fixed potential issues with players being redirected or disconnected incorrectly during auto-connect routines. Took 46 minutes (TubYoub)
Links
⚠️ Alpha build for branch: 0.9.5
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)
- 0aa1f08 Player connect to the server they started Took 32 minutes (TubYoub)
- 51ecd45 usage message fixed to have the correct placeholder Took 2 minutes (TubYoub)
- 236287c Merge remote-tracking branch 'GitHub/0.9.5' into 0.9.5 (TubYoub)
Links
⚠️ Alpha build for branch: workflow-test
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)
- 8c95bbf Version checker now handles the new Version on Modrinth correctly (new version tags indroduced by automatic alpha builds) Took 17 minutes (TubYoub)
Links
- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commits/workflow-test
- This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit/8c95bbf70deffe4a22d0425a4e4510ded3ba70be
- Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compare/workflow-test~20...workflow-test
⚠️ Alpha build for branch: 0.9.5
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)
- bde7b1d workflow testing of auto upload alpha versions to modrinth on every commit Took 2 minutes (TubYoub)
- ccf8208 uhm wrong modrinth id Took 3 minutes (TubYoub)
- bbc2715 test Took 5 minutes (TubYoub)
- df6eeed updated changelog for alpha releases Took 10 minutes (TubYoub)
- ed5331a update formatting Took 5 minutes (TubYoub)
- 9186576 update formatting Took 7 minutes (TubYoub)
- 8377990 update formatting Took 4 minutes (TubYoub)
- 69ac46f update formatting Took 3 minutes (TubYoub)
- 98fd099 Merge pull request #22 from Tubs-Pluginz/workflow-test Workflows (TubYoub)
Links
VelocityPteroPower Update: Whitelists, McSS Support, and Major Improvements!
This version of VelocityPteroPower brings, expanded panel support, and a host of under-the-hood improvements for better performance and stability.
Highlights of this Release:
New Features
- Server Whitelist Management:
- Dynamically fetch, parse, and enforce server whitelists directly from your panel.
- Manually reload whitelists with the
/ptero whitelistReloadcommand. - Configure whitelist settings per-server in your
config.yml.
- Mc Server Soft Panel Support:
- VelocityPteroPower now supports Mc Server Soft panels alongside Pterodactyl and Pelican!
- Includes appropriate API handling (note: whitelist file fetching is not supported by McSS).
Key Improvements
- Major Code Refactor: Significant parts of the plugin have been rewritten to be more modular, reliable, and easier to maintain. This means a more stable experience for you.
- Enhanced Connection & Server Management:
- Improved logic for handling player connections and server switches.
- More robust server lifecycle management for starting and stopping servers.
- Smarter handling for players attempting to connect to offline servers, redirecting to a limbo server if available.
- Improved API Key Handling: More reliable API key validation across all supported panel types.
- Clearer Logging: Logging has been improved for better diagnostics and clearer information.
Important Fixes
- Resolved issues with API key validation occurring at the wrong time.
- Addressed several log redundancies and optimized instance creation.
- Fixed issues related to API rate limit processing.
- Ensured more consistent whitelist enforcement.
As always, please back up your configuration files before updating.
Thank you for using VelocityPteroPower!
What's Changed
- changed Pelican API key prefix by @TubYoub in https://github.com/BT-Pluginz/VelocityPteroPower/pull/12 fixed plugin not initiating when using Pelican panel
Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/v0.9.3.1-beta...v0.9.3.2-beta
VelocityPteroPower v0.9.3.1 - Release Notes
This release focuses on enhancing server management flexibility, configuration options, and overall stability within VelocityPteroPower.
✨ New Features
- Configurable Server Status Check Method:
- A new
serverStatusCheckMethodoption has been added toconfig.yml. - Choose between
VELOCITY_PING(uses Velocity's built-in ping) orPANEL_API(uses Pterodactyl/Pelican panel API for higher precision, mindful of API rate limits).
- A new
- Adjustable Logging Level:
- Control the plugin's log verbosity using the new
loggerLevelsetting inconfig.yml.
- Control the plugin's log verbosity using the new
- Customizable Initial Check Delay:
- The
startupInitialCheckDelayoption inconfig.ymlallows you to configure how long the plugin waits before the first server status check after startup.
- The
- Refined Limbo Server Handling:
- Improved logic for handling limbo servers, including dynamic checks to ensure they are usable before redirecting players.
- Enhanced Messages:
- Added new placeholders and messages to
messages.yml. - The
%limbo%placeholder can now be used in relevant messages. - New messages provide more detail during server startup and when encountering API rate limits.
- Added new placeholders and messages to
🚀 Improvements
- Updated Server Startup Flow:
- Players attempting to connect to a starting server will now be redirected to a configured limbo server (if available and usable).
- Added pre-checks for Pterodactyl API rate limits before attempting to start a server via the API.
- Enhanced Logging:
- Added detailed debug-level logging for server status checks and API interactions, aiding troubleshooting.
- Improved detection and logging of potential panel or server misconfigurations.
- Optimized Server Shutdown & Retries:
- Refined the server shutdown process and retry logic.
- Now considers API rate limits and whether a server is empty before attempting shutdown actions.
- Version Checker Update:
- De-duplicated critical update warnings.
- Merged
CRITICALandHIGHurgency levels for update notifications for clarity.
🐛 Bug Fixes
- Resolved an issue where players could be disconnected during target server startup if configured limbo servers were unavailable or unusable.
- Improved consistency in task handling and retries during the server shutdown sequence.
- Prevented unhandled exceptions during server status checks (both
PINGandAPI), ensuring graceful handling of rate limits and other unknown errors.
Issues: #10
Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/v0.9.2.4-alpha...v0.9.3.1
- isServerOnline() now catches the NullPointerExeption which is caused by the ping() when a server is offline. This should prevent the errors beeing printed to console
- added configurable messages
- added /ptero restart
Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/v0.9.2.3-alpha...v0.9.2.4-alpha
- isServerOnline() now uses built in RegisteredServer.ping() instead of the panel API to check if the server is online
- added config how long till a ping, to check if a server is online, times out
- Plugin now checks every 16 Seconds (instead of 5) if a server is Online to avoid to much useless pings
Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/v0.9.2.2-alpha...v0.9.2.3-alpha
- rate limit from Panel API getting automatically tracked
- if Panel server ends the connection Plugin retrys the request
- you can turn on rate limit logging in the console
Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/v0.9.2.1-alpha...v0.9.2.2-alpha



