VGKAMI
Advertise Get listed

Game Guides

Portal Knights Server Settings Explained: The Best Config for Your Group

Published 16 min read

For a four-player group that wants its Portal Knights world available while the usual host is offline, use the official self-hosted dedicated server. Start with a descriptive name, universeSize set to Normal, UDP port 16365, and a save folder you can back up independently. Keep the administrator password private, assign trusted builders a separate user account, and either disable guest access or leave guests unable to modify the world.

Portal Knights added dedicated servers in the 2018 Adventurer’s Update. The system supports asynchronous play: up to four players can use the same world without being online simultaneously. Desktop hosts run the supplied executable; mobile players can join a desktop-hosted private server, but mobile devices cannot host one.

What does a Portal Knights dedicated server do?

A dedicated server runs the world separately from a player’s game session. Once pk_dedicated_server.exe is running, players connect to that world using the server address and the password for their access tier. The host does not need to remain in the game, which is the main advantage over Steam Friends or LAN hosting.

The official setup instructions from 505 Games and Keen Games describe a four-player server. The server’s files, permissions and save data are controlled on the computer running the executable rather than through Steam Cloud. In practical terms, one computer becomes the always-available world host, while the other players can join when their schedules allow.

This is different from simply inviting friends to a normal session. In a hosted session, the host’s game is the session and the world is generally unavailable when that player leaves. With a dedicated instance, the executable can keep running after the host closes the game, so the group can build, explore and return to the same save asynchronously.

  • Use a dedicated server when the world should remain available asynchronously, you want separate admin/user/guest permissions, or you need direct control over saves.
  • Use built-in hosting when the host will be present and wants the quickest setup with no router configuration.

What do I need before setting one up?

You need the Steam installation of Portal Knights, the supplied dedicated_server.zip package, and a computer that can keep pk_dedicated_server.exe running whenever the world should be online. Decide in advance which machine will own the save folder and which person will keep the administrator credentials. The official instructions do not require a separate game account for every permission tier, but they do require distinct credentials in the configuration.

Plan the network address before inviting anyone. A server on the same home network can be reached through its private local IPv4 address. Friends connecting from elsewhere need the router’s external IPv4 address and a UDP forwarding rule. If the host computer’s local address changes, a previously correct forwarding rule can point at the wrong device, so reserve that local address in the router when possible.

Finally, choose a save location that is easy to identify and copy. The dedicated-server save is separate from Steam Cloud in the developer setup guidance. Treat the folder as the authoritative world data and establish a backup routine before the group invests time in the map.

Which settings matter in server_config.json?

The executable creates server_config.json after its first launch. Edit that file in ASCII or UTF-8 text, then restart the server for changes to take effect. Stop the process before editing; changing a file while the server is running can leave you unsure which values were loaded or risk an inconsistent save.

Setting What it controls Recommended starting value
basicServerData.name The name players see when identifying the server. A descriptive group name, such as “Friday Builders”.
basicServerData.ipv4 The IPv4 address on which the server listens. 0.0.0.0, the value used in the official example.
basicServerData.port The network port used by the server. 16365 over UDP.
basicServerData.saveFolderPath The directory containing the dedicated world save. ./savedata, or another folder that is easy to back up.
universeSize The generated universe size: Small, Normal or Large. Normal for most two-to-four-player groups.
hideConsoleWindow Whether the server console window is hidden. false while configuring and troubleshooting.

The official example uses 0.0.0.0 so the process can listen on the host’s available IPv4 interfaces. Do not replace it with the external address from your internet provider; the external address belongs in the connection details you give remote players, while the server’s bind value is a local listening setting.

A minimal starting file can look like this:

{"basicServerData":{"name":"Friday Builders","ipv4":"0.0.0.0","port":16365,"saveFolderPath":"./savedata"},"universeSize":"Normal","hideConsoleWindow":false}

Keep the punctuation and quotation marks valid JSON. If you change the port or save path, make the same change in your router rule and backup routine. A descriptive name can be changed later without creating a new world as long as the save path remains unchanged.

How do I set up a Portal Knights dedicated server?

  1. Find the server package. In the Steam Portal Knights installation, locate dedicated_server.zip and extract it to a folder with write access. Keep the extracted executable and its configuration together so relative paths such as ./savedata are predictable.
  2. Run the executable once. Start pk_dedicated_server.exe. Its first run creates the configuration file, log and save directory. Let that initial run finish, then stop the process cleanly.
  3. Stop the process before editing. Close the server, then open server_config.json in a plain-text editor. Set the server name, IPv4 binding, port, save path, universe size and console preference. Save as ASCII or UTF-8 without smart quotes or word-processor formatting.
  4. Configure access groups. Set separate credentials and permissions for administrators, users and guests. The details are covered below. Use passwords that are not reused for other services.
  5. Start the configured server. You can launch the default configuration directly or specify a file and log, for example -config myConfig.json -log testServer.log. Keep the log file in a known location so startup errors and connection issues can be reviewed.
  6. Forward the port when required. If the computer is behind a router, forward UDP port 16365 to that computer’s local IPv4 address. If you choose a different port, forward that exact UDP port instead.
  7. Give players the correct connection details. Friends outside your home network need the router’s external IPv4 address and the password for their assigned group. Players on the same LAN can use the host’s private local address. Do not publish administrator credentials in the same message as the public address.
  8. Make an independent backup. Copy the dedicated server’s save folder on a schedule; these saves are not connected to Steam Cloud in the developer setup guidance. Also retain a copy of the configuration so the world can be restored with the same port, path and permissions.

How should I set administrator, user and guest permissions?

Portal Knights separates access into three groups. Each group has credentials, a canLogin switch, and controls for kicking players and modifying the world. Configure the smallest set of rights each person needs, then test each tier with a non-administrator account.

Administrator tier

Enable administrator login, kicking and world modification for the person responsible for the server. Do not share this password in a general group chat: an administrator can disrupt sessions and alter the world. Store it in a password manager or another private location, and change it if someone who should no longer administer the server learns it.

User tier

Use the user account for trusted builders. A practical group setup grants canLogin and canModifyWorld but leaves canKickPlayers disabled. This lets builders construct and change the world without giving them moderation authority. If you have several trusted players, they can share the user tier while the administrator credential remains limited to the operator.

Guest tier

Disable guest login if every participant is known and should use a named account. If you allow guests, keep both world modification and kicking disabled so a temporary visitor cannot change the map or remove another player. Guest access is convenient for a one-time visitor, but it should not be the default tier for regular builders.

The documentation lists canInteractWithLockables, but also says that option is not currently functional. Do not rely on it as a security boundary, and do not promise players that enabling it will protect chests, doors or other lockable objects.

What port does Portal Knights use, and how do I forward it?

The official default is UDP port 16365. In your router’s port-forwarding page, create a rule for UDP 16365 directed to the local IPv4 address of the computer running pk_dedicated_server.exe. A TCP-only rule will not implement the documented setup.

  1. Give the server computer a stable local address, either through a router reservation or an equivalent local-network arrangement.
  2. Forward UDP 16365 to that address.
  3. Start the dedicated server and leave the process running.
  4. Send remote players the external IPv4 address shown by your router or internet connection, not the private address beginning with ranges such as 192.168.x.x or 10.x.x.x.

Players on the same home network do not need the external address; they should connect using the host computer’s local IPv4 address. If LAN connections work but internet connections fail, check the destination address in the forwarding rule, confirm that the server is listening on the selected port, and verify that the address shared with friends is the current external IPv4 address.

If you edit basicServerData.port, update the router rule and the instructions sent to every player. A port mismatch is easy to create when testing an alternate configuration. Keep one written record of the active port and the configuration filename used to launch the instance.

What is the best Portal Knights configuration for two to four friends?

Use Normal for the initial universe, the default UDP port, and a save path outside temporary folders. The official materials define Small, Normal and Large but do not publish performance benchmarks for each size, so the recommendation is about compatibility and manageability rather than a measured speed advantage.

  • Choose Small when compatibility with lower-powered devices, especially mobile joiners, is the priority.
  • Choose Normal for a typical two-to-four-player group and the least surprising starting point.
  • Choose Large cautiously. Confirm that every intended client supports the selected universe size before committing a long-running shared world.

For permissions, use the three-tier arrangement: private administrator credentials, a builder-focused user account, and disabled or restricted guests. Keep the default port unless it conflicts with another service; changing it adds a second place where mistakes can prevent connections. Leave the console visible during the first connection tests and only hide it after the world loads reliably.

The documented capacity is four players. Do not plan a five-player session on the assumption that a larger universe or a different port increases that limit; the official setup guidance describes the server for four players.

Should I use dedicated hosting, Steam Friends or LAN play?

The simplest choice depends on whether the host must be present and how much control you want over networking and permissions.

Hosting method Must the host be online? Setup and networking Control and backups Platform notes
Steam Friends Yes, the host runs the session. Quickest option; no dedicated-server port-forwarding workflow. Less server-side administration than a dedicated instance. Steam hosts should select Friends for character privacy and Steam Online.
LAN Yes, the host runs the session. Designed for players on the same local network; select Local. No separate always-on save process. Remote friends cannot use a LAN address from outside the home network.
Self-hosted dedicated server No; the executable can remain online independently. Requires file editing and, for internet play, UDP forwarding. Separate passwords, kicking and world-modification permissions; the operator owns backups. Supports the documented four-player asynchronous model.
Managed hosting Normally no; the provider operates the server. A service can remove much of the port-forwarding and uptime work; verify current regions, builds and service terms before choosing one. Confirm who controls permissions, restores and backups. Check that the provider supports the required Portal Knights build and client versions.

Built-in hosting is usually the better fit for a short session or a group that always plays together. 505 Games’ support guidance says Steam hosts should select Friends for character privacy and Steam Online; for a local-network game, select Local. A dedicated server is the better fit when the host’s schedule should not determine access.

Can mobile players join a private dedicated server?

Yes, but only when the server is hosted on desktop. Mobile clients cannot host private dedicated servers. The mobile game version must match the server version, and the support guidance allows up to four players per game.

Before inviting mobile players, confirm that the chosen island or universe size is supported by their devices. Small is the safer compatibility-first choice when you cannot verify every client’s capability; this is a practical precaution, not a published performance guarantee. If a mobile player cannot connect, check the version match before changing passwords or port settings.

How do I run more than one dedicated world?

The official launch arguments support multiple instances. Give each running instance its own configuration file, UDP port and save folder, then launch each with its corresponding -config and -log arguments. For example, one instance can use myConfig.json and a second can use creativeConfig.json, provided their ports and save paths are different.

Never point two instances at the same save directory, because each world needs an unambiguous save location. Reusing a port prevents the second process from listening correctly, while reusing a save path can make the worlds appear to overwrite or replace one another. Keep the log for each instance separate so you can tell which process produced an error.

What should I back up and maintain?

Back up the dedicated server’s save folder independently of Steam Cloud. Include server_config.json in your administrative backup so you can reconstruct the network, universe and permission settings after a drive failure. If you use a custom configuration file, back up that file too, along with the launch command that selects it.

  • Stop the server before copying a save for a clean backup.
  • Keep at least one backup from before major world or configuration changes.
  • Record the external address and port separately from passwords; rotate credentials if a password is shared accidentally.
  • Leave hideConsoleWindow set to false until the server is stable, then hide the console only if you no longer need live diagnostics.
  • Periodically verify that a backup contains the expected save directory rather than an empty newly created folder.

The official setup guidance does not connect these dedicated-server saves to Steam Cloud. Do not assume that reinstalling Steam or signing into another computer will restore the dedicated world automatically.

What does dedicated hosting cost?

The official setup path describes a self-hosted executable and does not publish a separate server fee or performance-based price for Small, Normal or Large universes. Your practical costs are therefore the computer and internet connection you already choose to keep online. Managed providers may charge recurring fees, but current pricing, regions, supported builds and backup policies must be checked directly with each provider rather than assumed from the game’s documentation.

A managed service can be worthwhile when port forwarding, uptime or home-network administration is the main obstacle. Before paying, confirm that it supports the Portal Knights version your group uses, permits the required four-player setup, exposes the needed permission controls, and explains how world saves are restored or exported.

Why can’t friends connect?

The server works on the same LAN but not over the internet

That pattern usually points to routing rather than the world file. Recheck the UDP rule, its destination local IPv4 address, the selected port in server_config.json, and the external address given to remote players. Confirm that the server process is still running and that a host firewall has not blocked it.

The server starts but loads the wrong world

Inspect saveFolderPath and confirm that the intended save directory is being used. A second configuration file or a second instance can make a correct world appear to have disappeared when the executable is simply reading another path. Compare the launch command, configuration filename and save folder with the last known-good setup.

A mobile player is rejected

Verify that the mobile and server versions match and that the mobile device supports the selected universe size. Mobile users must join a desktop-hosted server rather than attempting to host one. The documented game limit remains four players.

Players can join but cannot build

Check the password tier they used and that its canModifyWorld value is enabled. Do not try to solve this with canInteractWithLockables; the documented option is not functional. A player using guest credentials will remain unable to modify the world if guest modification is disabled, even when the user tier is configured correctly.

The server launches with a blank or invalid configuration

Open the file in a plain-text editor and check for smart quotes, missing commas or an accidental extra character. Save in ASCII or UTF-8, keep the JSON structure intact, and restart the executable after every edit. Leaving the console visible makes startup errors easier to spot.

Frequently asked questions

Can the host be offline while friends play?

Yes, that is the purpose of the dedicated executable. The computer running pk_dedicated_server.exe must remain online, but the person who configured it does not need to be inside the game.

Can I change the server name without creating a new world?

Yes. Change the descriptive name while leaving saveFolderPath unchanged. Stop the executable before editing, then restart it so the new label is read.

Should I use my external IPv4 address in basicServerData.ipv4?

No. The official example uses 0.0.0.0 for the listening address. Give the external IPv4 address to remote players, and use the local IPv4 address as the router-forwarding destination.

What text editor should I use for the configuration file?

Use a plain-text editor that saves ASCII or UTF-8 and preserves JSON punctuation. Avoid word processors that insert smart quotation marks or formatting, because those characters can prevent the file from parsing.

Why does a second server overwrite or open the first server’s world?

Each instance must have a distinct save folder as well as its own port and configuration file. Reusing a save path makes both processes target the same world data, while reusing a port prevents the second process from listening correctly.

Do mobile players need a separate password?

No special mobile password is documented. Give mobile players the password for the access tier you want them to use, and make sure their game version matches the desktop-hosted server.

Is it safe to hide the server console immediately?

It is safer to leave hideConsoleWindow set to false until players have connected and the world loads correctly. Once the instance is stable, setting it to true can keep the desktop tidy, but you will lose the visible console when diagnosing a failed launch.

Can I use a different UDP port?

Yes, the configuration supports a port value, but the router rule and every connection instruction must use the same number. The default 16365 is the least complicated starting point because it matches the official example.

Frequently Asked Questions

Is it safe to hide the server console immediately?

It is safer to leave hideConsoleWindow set to false until players have connected and the world loads correctly. Once the instance is stable, setting it to true can keep the desktop tidy, but you will lose the visible console when diagnosing a failed launch.

Can I rename a server without creating a new world?

Yes, changing the descriptive name while leaving saveFolderPath unchanged preserves the association with the existing save. Stop the executable before editing, then restart it so the new label is read.

What text editor should I use for the configuration file?

Use a plain-text editor that saves ASCII or UTF-8 and preserves JSON punctuation. Avoid word processors that insert smart quotation marks or formatting, because those characters can prevent the file from parsing.

Why does a second server overwrite or open the first server’s world?

Each instance must have a distinct save folder as well as its own port and configuration file. Reusing a save path makes both processes target the same world data, while reusing a port prevents the second process from listening correctly.

Can friends play when the host is not in Portal Knights?

Yes. The dedicated executable can keep the world online independently of the host’s game session. The computer running the server still has to remain online.

What address should I send to friends outside my home?

Send the router’s current external IPv4 address and the correct group password. Do not send a private LAN address such as 192.168.x.x to players connecting from another network.

Can a mobile device host the private server?

No. Mobile players can join a desktop-hosted private server, but the mobile client cannot host a private dedicated server. Match the mobile and server versions before troubleshooting connection settings.

Is there a published price for a managed Portal Knights server?

The official setup guidance does not publish provider pricing. Managed-hosting costs, regions, supported builds and backup terms vary, so verify them directly with the provider before subscribing.

The Bottom Line

For most groups, use Normal, UDP 16365, 0.0.0.0, a dedicated backup folder, and three permission tiers: private admin, trusted builder user, and restricted or disabled guests. Forward the UDP port to the host’s local IPv4 address, keep the server version compatible with every client, and back up the save independently of Steam Cloud.