Profiles & ports
Each profile is one dedicated-server install YARK can manage: path, map, session, ports, passwords, mods, and optional cluster fields.
Required shape
Section titled “Required shape”| Field | Rule |
|---|---|
| Name | 1–64 characters (Windows folder-safe) |
| Map + session | Required — Map is Official, an enabled Map mod, or Custom… |
| Install dir | Absolute Windows path (C:\… or UNC) |
| Ports | 1024–65535; game, query, and RCON distinct inside the profile |
| Admin password | Length ≥ 4 |
| Mods | Unique Project IDs (map packs must be enabled when using a custom map) |
| Cluster | If clusterId is set, clusterDir is required |
Map field
Section titled “Map field”Server Information → Map groups options as:
| Group | Use when |
|---|---|
| Official | Built-in ASA maps (e.g. The Island) |
| Map mods | Enabled CurseForge Maps packs whose launch token YARK could detect |
| Other → Custom… | You type the author launch token yourself (e.g. Svartalfheim_WP) |
Choosing a Map mod sets the launch token and links the pack’s Project ID on the profile. Choosing an official map clears that link. Custom… is for tokens YARK could not list — you still need the matching map pack enabled on Mods for a correct boot.
Official maps use bundled artwork on cards, the workspace server list / Switch server panel, and the workspace header. Custom maps with a linked pack show that mod’s CurseForge logo when metadata has a thumbnail.
Clone keeps map + linked map-mod ID with the copied mods list. Copy configuration never copies map identity (including that link).
Port conflicts
Section titled “Port conflicts”YARK flags the same numeric port used by different profiles (any of game / query / RCON).
- Create / update profile — checked against all other profiles (live alerts on the create form)
- Start — checked against other active servers, then a host bind probe (UDP game/query, TCP RCON)
If the host probe finds a port busy, start is blocked (edit ports or Start this session on a suggested free set). If the probe is inconclusive, you can also Start anyway — that override never applies when a port is confirmed busy. Session ports affect INI and launch for that run only; the saved profile stays unchanged.
Clone bumps ports by +10 (retries with higher offsets if needed).
Enable, disable, and clone
Section titled “Enable, disable, and clone”- Enable / Disable — Inactive profiles stay out of Start / Restart / auto-start. Enabling does not require installation health Ready; Start still does.
- Clone — duplicates profile fields with bumped ports (profile-only). Full install-folder clone is still on the product roadmap.
Cluster on create
Section titled “Cluster on create”When creating a server you can pick None or an existing fleet cluster (fills ID + shared directory). Create a cluster first from Clusters if none exist yet — see Clusters.
Hot edits while running
Section titled “Hot edits while running”You can edit many profile fields while a server is running. Ports and map take effect on the next restart. Profile settings that belong in INI (RCON, passwords, query port, session name, game port) are synced to GameUserSettings.ini on start (and opportunistically on update).
Install path tips
Section titled “Install path tips”- Prefer a dedicated folder per profile under a fast disk
- Do not point two profiles at the same
installDir - Leave enough free space for Steam content cache + each install + backups