PteroControl

Tired of alt-tabbing to a web browser just to start, stop, or restart your Pterodactyl-hosted game server? PteroControl is the solution!

This powerful, client-side utility mod seamlessly integrates your Pterodactyl panel directly into Minecraft’s multiplayer screen, giving you essential server controls right where you need them.

Watch a short video about the features in the gallery.

✨ Key Features

• In-Game Server Controls: Adds Start, Stop, and Restart buttons directly to your server entries in the multiplayer list.
• Smart Display: Buttons only appear for servers that match the configurable node address, keeping your server list clean.
• Dynamic Status: The buttons are intelligent! They automatically enable or disable based on the server’s live ping status in Minecraft (Online, Offline, or Pinging) to prevent mistakes.
• Offline? Only the “Start” button is active.
• Online? Only “Restart” and “Stop” are active.
• Pinging? All buttons are temporarily disabled.
• Automatic Refresh: After sending a command, the buttons will temporarily disable and then automatically update to reflect the server’s new state after a few seconds.
• Easy Configuration: A simple in-game settings screen (via Mod Menu) lets you set up your Pterodactyl panel URL, API key, and node address in seconds.

⚙️ How to Set Up

1. Install the mod and all required dependencies (see below).
2. Launch Minecraft and go to the Mods menu from the main screen.
3. Find PteroControl in the list and click the gear icon (⚙️).
4. Enter your Pterodactyl Panel URL (e.g., https://panel.yourdomain.com).
5. Enter your Client API Key. This must be generated from your user account’s “API Credentials” page on the panel and usually starts with ptlc_.
6. Enter the Node Address of your servers (e.g., node.yourdomain.com). The buttons will only appear for servers matching this address.
7. Click Save, and you’re all set!

⚠️ Requirements

This mod is for the Fabric modloader. It requires the following mods to be installed:

• Fabric API
• Mod Menu
• Cloth Config API

📜 License

PteroControl is licensed under CC0-1.0 Universal. It is in the public domain, meaning you are free to use, modify, and distribute it as you see fit.