Syntax: unload <ship> <cargo..>

Since: PHost 4.0h

Ships can unload cargo to the planet they're orbiting, or dump it into space (jettison). 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 unload the specified cargo to the planet it is orbiting, or to dump it into free space if it is not orbiting a planet.

The cargo amount can be specified as follows:

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

Detailed Operation: This command supplements the client-side ship-to-planet transfer resp. jettison function ("C" 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 planet or dumped into space.

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

If you already used your client's unload function, both orders will be added together.

Conflict Resolution: Commands are executed in order received, therefore the last one takes effect.

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

  • if orbiting a planet, the planet must be owned by a different player as the ship (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
  • when transferring fighters or torpedoes, the planet must have a starbase to receive them
  • when transferring fighters, the starbase must have enough room (otherwise, excess fighters are given back to the ship)

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

This is a testing version.
It may be incomplete, and have more bugs (or features) than the public live version at planetscentral.com.