Back to all articles
Minecraft

How to Set Up a Port for a Minecraft Plugin in Pterodactyl

Published on July 31, 2025 (4 weeks ago)

How to Set Up a Port for a Minecraft Plugin in Pterodactyl

Some Minecraft plugins, such as those that provide web maps (like Dynmap or BlueMap) or voice chat services, require their own dedicated network port to function correctly. The Pterodactyl panel makes it easy to find and assign these ports.

Step 1: Find Your Available Ports

Your server is allocated a primary port for players to connect, as well as a range of additional ports for plugins.

  1. Navigate to Your Server: Log in to your Pterodactyl panel and select the Minecraft server you want to configure.
  2. Go to the Network Tab: In the server navigation bar, click on the Network tab.
  3. Identify an Additional Port: You will see a list of all network allocations for your server. The one marked "Primary" is your main game port (e.g., 25565). The other ports listed are available for you to use. Pick one of these additional ports for your plugin (for example, 8123).
  4. Make a note of the port you choose, as you will need it for the next step.

Step 2: Configure the Plugin

Now you need to tell the plugin which port to use.

  1. Go to the File Manager: In the server navigation bar, click on the File Manager tab.
  2. Locate the Plugin's Configuration: Navigate to the plugins folder, and then find the folder for the specific plugin you are setting up (e.g., /plugins/dynmap/).
  3. Edit the Config File: Inside the plugin's folder, find its main configuration file. This is commonly named config.yml, configuration.txt, or something similar. Click on the file to open it in Pterodactyl's editor.
  4. Set the Port: Look through the configuration for a setting related to the "port". For Dynmap, this might be webserver-port. Change its value to the additional port you selected in Step 1.
  5. Example for Dynmap's configuration.txt:
# The TCP-port the webserver will listen on.
webserver-port: 8123

Step 3: Save and Restart

For the changes to apply, you must save the file and restart your server.

  1. Save the File: Click the Save Content button in the file editor.
  2. Restart Your Server: Go back to the Console page and click the Restart button.

Once the server is back online, your plugin should be accessible using your server's IP address followed by the new port (e.g., http://192.168.1.100:8123).