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.
Автор: Quozul69010обновлён 7 нояб. 2025 г.
Управление
Описание
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.
Галерея
Последние версии
Все версии →beta
PterodactylPowerAction 1.8.0-SNAPSHOT
1.8.0-SNAPSHOT7 нояб. 2025 г.203Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11velocity
Что нового
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](https://github.com/Quozul/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](https://github.com/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.
release
PterodactylPowerAction 1.7.0
1.7.031 мая 2025 г.201Minecraft: 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11velocity
Что нового
## 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_kick` is 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.
release
PterodactylPowerAction 1.6.0
1.6.017 мая 2025 г.53Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5velocity
Что нового
## What's Changed
* Add a new way to check for when a server is online, using the Pterodactyl API, see [ping methods](https://github.com/Pickaria/PterodactylPowerAction/blob/master/docs/configuration.md#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
release
PterodactylPowerAction 1.5.0
1.5.02 мая 2025 г.50Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5velocity
Что нового
- Configuration file validation
- German translations
- `/pterodactylpoweraction reload` command to reload the configuration file
- `/pterodactylpoweraction doctor` command 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
release
PterodactylPowerAction 1.3-SNAPSHOT
1.3-SNAPSHOT30 дек. 2024 г.77Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4velocity
Что нового
**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
release
PterodactylPowerAction 1.2-SNAPSHOT
1.2-SNAPSHOT7 дек. 2024 г.50Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4velocity
Что нового
## Changes
+ Do not redirect player to waiting server on kick if already connected to it, this could lead to a redirection loop
beta
PterodactylPowerAction 1.1-SNAPSHOT
1.1-SNAPSHOT14 нояб. 2024 г.56Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3velocity