Syntax: transfer <ship> <cargo..> [to <target>]

Since: PHost 4.0h

Ships can transfer cargo to up to one foreign ship per turn. This command can be used to supplement or replace the corresponding client function to overcome limits imposed by clients.

This command will order the specified ship to transfer the specified cargo to the target ship.

The cargo amount can be specified as follows:

NnnnNeutronium
TnnnTritanium
DnnnDuranium
MnnnMolybdenum
CnnnColonists
SnnnSupplies
$nnnMoney
WnnnFighters or torpedoes
xmaxtransfer as much as possible. Note that max must be spelled out, it can't be abbreviated.
x<number>transfer specified amount

Detailed Operation: This command supplements the client-side ship-to-foreign-ship transfer function ("T" in planets.exe). Like this function, it has two parts:

  • During turn processing, cargo is moved from the main cargo room to the cargo transporters.
  • During the CargoTransfer stage, cargo is actually transferred to the receiver ship. If the receiver ship cannot take this cargo type or has no room, you get it back.

As a consequence, you cannot transfer cargo which you do not have at the time you give the command (such as money made by gambling ships), and the transferred goods are subject to potential robbing.

If you already used your client's transfer-to-foreign-ship function, and you give a transfer command, the transfer command must target the same ship. Both orders will be added together; you cannot transfer cargo to multiple ships in one turn. In this case, however, you can omit the to <target> part of the command.

Preconditions: (must be fulfilled for the command to be accepted)

  • ship must be at same position as target
  • ships must be controlled by different players (otherwise, use the direct client-side transfer to achieve the same result)
  • giving ship must have enough cargo (otherwise, amount is silently reduced)

Preconditions: (must be fulfilled for the transfer to take place)

  • ship must have fuel
  • ships must have same secondary weapon system if fighters or torps are to be transferred
  • target ship must have enough free cargo capacity (otherwise, excess cargo is given back to original ship)

Relevant PControl Stage: Host Phase I (cargo moved to transporters), CargoTransfer (cargo transferred to target)