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/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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](https://github.com/Tubs-Pluginz/VelocityPteroPower/issues… [#19](https://github.com/Tubs-Pluginz/VelocityPteroPower/issues… - 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](https://github.com/Tubs-Pluginz/VelocityPteroPower/issues… - Let everyone get into the Limbo not only the player who started the server [#21](https://github.com/Tubs-Pluginz/VelocityPteroPower/issues… - Fixed config comments (only update when recreating the config file) [#23](https://github.com/Tubs-Pluginz/VelocityPteroPower/issues…

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/compar…

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 recordServerStartSignalSent method 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 - Enhanced compareVersions to 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. - Updated config.yml with clearer documentation for the shutdownOnProxyExit setting. ### 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 sendToLimboOnStart configuration option to enable sending players to a limbo server when their target server is starting. - Added forcedHostOfflineBehavior configuration 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

- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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

- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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

- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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

- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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

- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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 recordServerStartSignalSent method 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 - Enhanced compareVersions to 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. - Updated config.yml with clearer documentation for the shutdownOnProxyExit setting. ### 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 sendToLimboOnStart configuration option to enable sending players to a limbo server when their target server is starting. - Added forcedHostOfflineBehavior configuration 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

- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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

- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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

- Branch history: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - This commit: https://github.com/Tubs-Pluginz/VelocityPteroPower/commit… - Compare (last 20): https://github.com/Tubs-Pluginz/VelocityPteroPower/compar…

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 whitelistReload command. * 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/…

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 serverStatusCheckMethod option has been added to config.yml. * Choose between VELOCITY_PING (uses Velocity's built-in ping) or PANEL_API (uses Pterodactyl/Pelican panel API for higher precision, mindful of API rate limits). Adjustable Logging Level:* * Control the plugin's log verbosity using the new loggerLevel setting in config.yml. Customizable Initial Check Delay:* * The startupInitialCheckDelay option in config.yml allows you to configure how long the plugin waits before the first server status check after startup. 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.

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 CRITICAL and HIGH urgency 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 PING and API), ensuring graceful handling of rate limits and other unknown errors. Issues: #10 Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/…

- 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/…

- 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/…

- 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/…

- The API clients now have a configurable thread count for the HTTP CLients so the Plugin doesnt create them into the infinite - configmanager now keeps previous made changes from the config while adding new things Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/…

- added the Console to use the COmmands of the Plugin - fixed an issue which occurd do to my stupidness of not testing and miss a crucial error because i hadnt changed a few variables. Thank for reporting the [issues](https://github.com/BT-Pluginz/VelocityPteroPower/issues/4) Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/…

Added Support for the [Pelican System](https://github.com/pelican-dev/) #2 Added updated Plugin, forgot to Change the Version for the Version Checking Full Changelog: https://github.com/BT-Pluginz/VelocityPteroPower/compare/…

Version 0.9

added eveything, the comming releases will get a proper Changelog