Pterodactyl

Connect your Pterodactyl panel to sell game servers: a paid order creates the server on the panel, and the customer manages it from their service page in WISECP.

Accessing the Screen

Open Products / Services → Servers → Add New Server. Select Pterodactyl under Server Automation Module, in the Game Hosting group. Address: {admin}/products/servers-add.

Before Connecting

WISECP uses two panel keys. The Application API key (ptla_) creates, suspends, resizes and deletes servers. Create it in the panel under Admin → Application API. Give it read and write access to users and servers, and read access to nodes, nests, eggs and locations.

The Administrator Client API Key (ptlc_) drives the customer's controls. Sign in to the panel as a root administrator and create it under Account → API Credentials. A key from a plain user only reaches that user's own servers, so the connection test refuses it.

On the panel, prepare a location, a node with free ports, and a nest and egg for each game you sell. In WISECP you need an active server record and a priced server product. Each customer receives a panel account under their own e-mail address. An existing account is reused, and its password is never changed.

Server Record and Product Settings

Tasks

Connecting the Server

1. Enter the Address, paste the Application API key into Access Hash and the root administrator's key into Administrator Client API Key.
2. Click Test Connection. The test lists the panel's nodes and checks that the client key belongs to a root administrator.
3. Click Add New Server; later edits use Save Changes. The record appears as active in the server list.

Preparing the Product

1. In the server product, open Automation → Module Assignment, select Pterodactyl and the server or server group.
2. Under Module Configuration choose the egg and location, then set the limits listed above.
3. To let the customer name the server, add a text requirement and map it to Server Name under the requirement's Module Options. Without it the product name and service number are used.
4. Click Save Changes. A paid order now creates the server on the panel and starts it.

Addons sell extra CPU, memory, disk, databases, backups and allocations. The panel server is resized when the addon becomes active.

Enabling Controls for Existing Services

Services created before the administrator key existed, or imported from an older version, may hold no panel key. Define the Administrator Client API Key on their server record and save. Their controls work on the next page load, without a reinstall.

Importing Existing Servers

Open the server's Import tab and click List Results to see each server's Address, Name and Server ID. Choose the client, product and period, then click Import.

Managing the Service

Administrators and customers open Management → Overview on the service. The card shows the state (Running, Offline, Starting, Stopping, Installing or Suspended) and the CPU, memory and disk use. It also lists the server name, address, game, node and SFTP details. Panel Login takes the customer to their server on the panel; the administrator's Open Panel button opens the panel's admin side.

Tools: Start Server, Stop Server, Restart Server, Kill, Console, Startup, Schedules, Activity Log, Reinstall, File Manager, Backups, Manage Databases, Allocations and Subusers. Start is hidden while the server runs; Stop, Restart and Kill are hidden while it is offline.

Suspending the service suspends the panel server, and cancelling deletes it. Upgrades and addons resize the server. Changing the service password sets a new panel password for the customer's account.

Points to Watch

Required Permissions

Server settings require MODULES_SERVERS_SETTINGS, product editing requires PRODUCTS_OPERATION, and the Open Panel button requires MODULES_ROOT_LOGIN_BUTTON. Client tools follow service access restrictions.

Related Articles

• Adding a Server
• Product Automation
• Service Management
• Pelican