Admin commands

You control CrewSwap with chat commands typed in the normal in-game chat box. Some notes before the list:

• Nobody else sees the commands. CrewSwap swallows every !crewswap command (the word !crewswap on its own or followed by a space), from anyone, so it never appears in public chat. A message like !crewswapper isn’t a command and shows as normal. The one exception: when CrewSwap is off because of a version mismatch (a different game version, sandboxed server Lua, or an unreadable game version), its chat commands are not loaded, so !crewswap messages show in chat and get no reply. Check the server console for OFF: version mismatch (see Troubleshooting).
• Replies are private. Only the sender sees them. The exceptions are a settings change, which is announced to everyone, and a failed !crewswap check, whose problem count is announced to everyone.
• Who counts as an admin: any client with the vanilla Manage settings permission (the Admin preset includes it). Anyone can use !crewswap status. Everything else is admin-only. Anyone else gets [CrewSwap] Only admins can change CrewSwap settings.
• Commands and their keywords are case-insensitive. Put names that contain spaces in "double quotes". An unclosed quote gets the general usage line back.

Summary

!crewswap status | pool shared|own | protect on|off | owner "<character>" "<player>" | check

An admin who types a malformed command gets a usage line back (other players get the admin-only message), for example:

[CrewSwap] Usage: !crewswap pool shared|own
[CrewSwap] Usage: !crewswap protect on|off
[CrewSwap] Usage: !crewswap owner "<character>" "<player>"
[CrewSwap] Usage: !crewswap status | pool shared|own | protect on|off | owner "<character>" "<player>" | check

!crewswap status

[CrewSwap] CrewSwap is active. Crew pool: shared. Home protection: on.

• inactive right now in place of active means CrewSwap is loaded but not running. This is normal before a campaign is loaded, in a non-campaign round, or under Ironman. It also shows during an integrity lockdown.

• If CrewSwap has switched itself off, status gives the reason instead:

  [CrewSwap] CrewSwap is off: <reason>. Fix it and restart the server; !crewswap check cannot turn it back on.
  

  See Troubleshooting.

!crewswap pool shared|own

Sets who can take which bots. Everyone sees one of:

[CrewSwap] Crew pool is now "shared": any Free crew member can be taken.
[CrewSwap] Crew pool is now "own": you can only switch into characters you hired or that nobody has claimed.

shared (default): any Free crew member, apart from other players’ characters while home protection is on.

own: a player may take:

• their own character
• bots they own
• bots that nobody owns yet. Taking one claims it, and the console logs switch: <player> claimed <character>.

Ownership comes from three places:

1. Hiring while the pool is own. The hirer owns the new crew member. The console logs admin: <player> hired <character> and now owns them. Hires made while the pool was shared are not owned. Once the pool is own, whoever plays them first claims them.
2. First play, for anything unowned, as above.
3. !crewswap owner, below.

A replacement character bought in Permadeath becomes the buyer’s own character, not a hire.

In own mode another player’s own character is never takeable. The only exception: with protection off, an admin has made you its owner with !crewswap owner (see the note below).

!crewswap protect on|off

[CrewSwap] Home protection is now on: players' own characters cannot be taken by others.
[CrewSwap] Home protection is now off: players' own characters can be taken when they are Free.

• On (default): each player’s own character can only be played by that player.
• Off: while a player is playing someone else, their own character is Free for others. This also changes round start and rejoin: players go back into the character they last played, if it’s Free.

Changing either setting takes effect immediately. The crew list updates for everyone, and nobody is pushed out of the character they’re currently playing.

If the setting can’t be written to disk, you also see [CrewSwap] Could not save the setting to disk; it applies until the server restarts.

!crewswap owner "<character>" "<player>"

Makes a player the owner of a crew member. This matters in own pool mode.

!crewswap owner "Kim Lee" "Alice"
[CrewSwap] Kim Lee now belongs to Alice.

• Names are matched case-insensitively: first an exact match, then a unique prefix. So !crewswap owner kim ali works if only one crew member starts with “kim” and only one player starts with “ali”.
• The character must be in the current round’s crew, and the player must be connected.
• CrewSwap must be active (a campaign round is running).
• Ownership is saved with the character in the campaign save.

Possible replies:

You can give a player’s own character to someone else this way. With protection off and the pool set to own, the new owner can then take it while it’s Free. That is usually not what you want.

!crewswap check

Runs CrewSwap’s integrity check on the loaded campaign right away. It checks that every crew member is stored exactly once and that nobody has gone missing (see Troubleshooting).

!crewswap check only lifts integrity lockdowns. It can’t turn CrewSwap back on after a FAIL (a patch that didn’t install, a module that didn’t load). If an integrity alarm and a FAIL are both in force, a passing check clears the integrity alarm only, replies with the “still locked down” line above, and CrewSwap stays off.

The config file

The pool and protect settings are server-wide (shared by every campaign on the server). They are saved to:

<save folder>/CrewSwap/config.txt

<save folder> is the path printed at start-up as [CrewSwap] save folder: <path>. It’s the server’s Barotrauma data folder, the one that also holds Multiplayer/. The file is plain text:

pool=shared
protect=on

• Values are lowercase (shared, own, on, off); anything else falls back to the default. (The chat commands, by contrast, are case-insensitive.)
• Defaults: pool=shared, protect=on. If the file is missing, or a line is unreadable, the default is used for that setting.
• CrewSwap reads the file once, at server start. The console shows [CrewSwap] admin: config: pool=shared protect=on (from file), or (defaults) when there is no file. To edit it by hand, stop the server first. Otherwise just use the chat commands, which write the file for you.

Other files in the save folder

CrewSwap’s per-character data (ids, owner, last player, bot wallets) is stored inside the campaign save, so it is saved, reverted and backed up together with vanilla’s data. See Persistence.