Mineforgian
PterodactylPowerAction
Velocity plugin to automatically start and stop Minecraft servers based on player activity using the Pterodactyl API, redirecting players to a waiting server when necessary.
- Загрузки
- 509
- Подписчики
- 10
- Обновлён
- 7 ноября 2025 г.
- Лицензия
- MIT
Опубликован 14 ноября 2024 г.
PterodactylPowerAction
A resource-saving Velocity plugin that automatically manages your Minecraft servers by starting them on demand and shutting them down when idle, using either the Pterodactyl API or shell commands.
⚠️ Important:
Support for this project is limited as I don't use it in production anymore.
Community & Support
If you have any questions or suggestions, join the Discord server!
✨ Key Features
🔌 Energy & Resource Saving - Automatically shuts down empty servers after a configurable idle period (default: 1 hour)
🚀 On-Demand Server Startup - Starts servers only when players need them, optimizing resource usage
🔄 Seamless Player Experience:
- Redirects players to a lightweight waiting server during startup
- Automatically transfers players when their destination server is ready
- Keeps players informed with status messages throughout the process
🛡️ Kick Protection - Optionally redirects kicked players to your waiting server instead of disconnecting them
🧰 Flexible Implementation:
- Works with Pterodactyl Panel API for managed hosting
- Supports direct shell commands for self-hosted environments
⚙️ Highly Configurable:
- Customizable shutdown delay
- Multiple server status checking methods
- Configurable shutdown behavior on proxy restart
🌐 Multilingual Support - Automatically translates messages based on the client's language (English, German, French)
🔍 Diagnostic Tools - Built-in doctor command to validate your configuration and troubleshoot issues
How it Works
When a player tries to connect to a stopped server, they're temporarily sent to your waiting server while PterodactylPowerAction starts their requested destination. Once the server is ready, they're automatically transferred. The plugin monitors player activity and intelligently shuts down empty servers to save resources.
Shader is Photon.
Documentation
The documentation is available on the wiki of this GitHub repository.
Центр версий
7 версийЧенджлог
1.8.0-SNAPSHOTБета1.21.9, 1.21.10, 1.21.11 · 7 ноября 2025 г.
I haven't been able to throurouly test this version, as such, I mark it as a beta.
Starting today, I want to focus on working on my other project PicoLimbo. Expect limited support.
Regular version
Features
- Prevent un-whitelisted players from joining
Fixes
- Silently ignore unconfigured servers
- Allow using single quotes when using shell commands to start and stop servers
Plus version
The "plus" version is provided by dinushay. It adds the following features:
- Replace the players/ping text with server state when offline or starting
- Cache the backend MOTD and display it while the server is offline
- Show server state in the MOTD when offline or starting (disables MOTD cache)
- Global queue system, redirect player to the limbo server until a slot frees up
- Optional animated boss bar showing server startup progress (Pterodactyl API only)
Note that the "plus" version drops support for shell commands as many of these features are exclusive to Pterodactyl panel.
1.7.0Релиз1.21.9, 1.21.10, 1.21.11 · 31 мая 2025 г.
What's Changed
Added
- Waiting server is now optional. If not configured, players will be kicked from the proxy instead of being redirected.
- Waiting server can be started automatically on proxy startup if it is not already running.
Changed
- Pterodactyl ping method is now the default server status checking method.
- Documentation improved for better clarity and coverage.
- Added embedded documentation inside the default generated configuration file for easier setup.
Fixed
- Properly kick players from the proxy with a clear message if the waiting server is not reachable.
- When
redirect_to_waiting_server_on_kickis set to false, players will be kicked after the server has started if their connection is rejected. - Fixed an issue where empty servers were not always detected correctly.
- Enhanced error logging with detailed and properly formatted error messages.
- Improved overall stability and reliability of the plugin.
1.6.0Релиз1.21.3, 1.21.4, 1.21.5 · 17 мая 2025 г.
What's Changed
- Add a new way to check for when a server is online, using the Pterodactyl API, see ping methods for more details
- Improved documentation and project's README
Full Changelog: https://github.com/Pickaria/PterodactylPowerAction/compare/v1.5.0...1.6.0
1.5.0Релиз1.21.3, 1.21.4, 1.21.5 · 2 мая 2025 г.
- Configuration file validation
- German translations
/pterodactylpoweraction reloadcommand to reload the configuration file/pterodactylpoweraction doctorcommand to diagnose and validate the configuration/pterodactylpoweraction clear [delay=0]to shutdown all empty servers after a given delay- Shutdown all backend server when proxy shuts down
1.3-SNAPSHOTРелиз1.21.2, 1.21.3, 1.21.4 · 30 декабря 2024 г.
Full Changelog: https://github.com/Pickaria/PterodactylPowerAction/compare/v1.2-SNAPSHOT...v1.3-SNAPSHOT
I recently noticed that my plugin stopped sending power signals to my Pterodactyl panel. This is because my panel was running behind Cloudflare DNS proxy. There was no error sent to the player.
Also, when a player tries to connect to a server with the wrong version, the error message is not always displayed. This release fixes those two issues.
Changes
- Schedule shutdown if the player could not connect to a running server
- Send error message when player tries to connect to a server but gets kicked after the server has started
- Schedule shutdown if no player has been redirected after the server has just started
- Send error message to the player if the HTTP request to pterodactyl failed
1.2-SNAPSHOTРелиз1.21.2, 1.21.3, 1.21.4 · 7 декабря 2024 г.
Changes
- Do not redirect player to waiting server on kick if already connected to it, this could lead to a redirection loop
Комментарии
Загружаем…