Server Actions¶

Server Actions are safe, game-aware tools for interacting with a running server. They are separate from Swarm Server lifecycle controls and game configuration:

Open a Swarm Server and choose Server Tools → Actions. Availability depends on the selected game, server image, current state, and your permissions. Actions remain disabled while the server is stopped, another operation is queued, or a required game-management connection is unavailable.

Swarm Hosts does not provide a raw browser console. Each available action has a dedicated form with validated fields, permission checks, and a result you can review. Disruptive actions ask for confirmation.

If the receipt is unknown¶

The browser saves one action request before sending it. If the connection ends before a matching receipt returns, the form shows Outcome unknown and keeps the action and its fields locked. This does not mean that the action failed: the server may already have accepted it.

Use Retry same request to ask for the receipt again. This explicit retry uses the saved action and fields; it does not submit the edited form or queue a second copy of the action. When the original receipt is recovered, the result links to its task and continues showing its progress.

A recovered receipt confirms that the task was queued. It does not confirm that the action finished successfully. Use View action history, or open Tasks and filter by the Swarm Server, to check whether it is queued, running, complete, partial, or failed before deciding what to do next.

Recovery depends on the valid saved request remaining available in the same browser tab. If browser storage is cleared, the tab is closed, or saved-request cleanup fails, do not submit the action again just to test it. Check action history first. Changed action fields are a new intent and should be submitted only after the earlier task's outcome is known.

Current public-game tools¶

An unavailable Server Actions page does not mean the Swarm Server cannot be managed. Settings, files, backups, versions, logs, monitoring, and lifecycle controls remain available according to the game and your permissions.

Staging game tools¶

The following games are available in the separate Staging category. Game-specific Server Actions are unavailable while their administration capabilities remain unverified.

Platform start, stop, restart, settings, files, backups, logs, and monitoring remain subject to the game and your permissions. These controls do not certify client joining or backup restoration. Staging does not expose raw console, RCON, REST management, or shell input.

Minecraft¶

Minecraft's Server Tools section includes four action and helper pages:

• Actions: Broadcast message, Give XP, Teleport player, Change game mode, Heal, Feed, Clear inventory, Kick player, Ban player, Pardon player, Whitelist add, Whitelist remove, Set weather, Set time, and Set difficulty. The exact options available to you depend on your role.
• Give Item: searches the Swarm Server item catalog, previews generated commands, targets known players, and supports policy-controlled delivery.
• Saved Kits: stores reusable single-item presets or multi-item kits and grants a versioned snapshot through the same preview and audit flow.
• Bots: starts and stops bounded Observer, Greeter, Patrol, or Survival helpers on eligible private or test servers.

Minecraft requires a running server and RCON-enabled settings. Raw RCON commands, shell input, free-form bot behavior, and client-supplied command previews are not accepted.

RCON is enabled by default for managed Minecraft servers. Player Analytics, Import World, Mods & Content, and an enabled Live Map also appear in Server Tools; they are separate from the action forms. Helper bots use their own eligibility rules, including disabled account authentication on a private or test server.

Counter-Strike: Source¶

Set a non-empty RCON password under Settings → Counter-Strike: Source Settings, save, and wait for the restart. The available action catalog then includes:

• read-only server status, connected players, and installed maps;
• bounded broadcast text;
• bot quota and difficulty;
• round restart;
• change to a discovered installed map; and
• kick by the numeric user ID returned by List players.

Map changes and player kicks require Swarm Server admin access. Arbitrary RCON, unbounded console-variable changes, plugin loading, shutdown, and shell access are intentionally unavailable.

Factorio¶

Factorio uses a private game-management connection for these tools; you do not need to expose an RCON port. Its catalog includes Server status, Discover players, Access lists, Broadcast message, Save map now, Kick player, Ban player, Unban player, Add to whitelist, Remove from whitelist, Promote administrator, and Demote administrator.

Player-changing actions use short-lived choices discovered from the running server or its persisted access files. An empty Factorio whitelist permits everyone; adding its first member restricts access, and removing its last member opens access again. Raw RCON, Lua or console input, permission-group mutation, server shutdown, and arbitrary save names are intentionally unavailable.

Valheim¶

Valheim provides Server status, Access lists, Add administrator, Remove administrator, Ban player, Unban player, Permit player, Remove permitted player, and Back up now. Access-list changes take effect after you restart Valheim. Adding the first permitted player restricts access to the list; removing the last entry opens access again. The browser never accepts raw shell input.

Terraria¶

Terraria provides Server overview, List online players, Broadcast message, Save world now, Kick player, and Set world time. Refresh List online players before choosing a player; selections expire after 30 seconds.

Team Fortress 2¶

Team Fortress 2 provides Server status, List players, List installed maps, List bans, Broadcast message, Change map, Kick player, Ban player, and Remove ban. Targeted actions use discovered player, map, or ban identifiers rather than arbitrary console text.

Counter-Strike 1.6¶

Counter-Strike 1.6 provides Server status, List players, List installed maps, List bans, Broadcast message, Change map, Kick player, Ban player, and Remove ban. Targeted actions use freshly discovered player, map, or ban identifiers. Raw RCON, console text, plugin commands, and arbitrary game-rule changes are unavailable.

OpenTTD¶

OpenTTD does not currently offer game-specific Server Actions. You can still use settings, files, backups, versions, logs, and monitoring, and start, stop, or restart the server. Raw console and admin-protocol input are unavailable.

API use¶

For games with a typed action catalog, API clients can fetch the catalog, preview an action, and queue the validated action. See API Access for the endpoint and payload shape.