Syntax: beamup <id> <items...>
Enabled by: AllowBeamUpMultiple
Since: PHost 3.0
This command is used in conjunction with the Beam up Multiple mission. You can beam up any combination of minerals, cash, etc. from a friendly planet. The mission tells PHost that you want to beam up things, and the beamup command tells what you want. Actually, the command alone is sufficient, because it will overwrite the ship's mission with Beam up Multiple. The extended mission is mainly there to remind the player of what the ship has been instructed to do.
► Note: Using this command will overwrite the ship's mission with Beam up Multiple. Using the mission without an associated beamup command will do nothing (the ship will not know what to beam up).
The first parameter of this command is a ship Id. The following parameters specify what you want to beam up. Each entry consists of one character for the element type, followed directly by the amount.
| Nnnn | Neutronium |
| Tnnn | Tritanium |
| Dnnn | Duranium |
| Mnnn | Molybdenum |
| Cnnn | Colonists |
| Snnn | Supplies |
| $nnn | Money |
| xmax | beam up as much as possible. Note that max must be spelled out, it can't be abbreviated. |
| x<number> | beam up specified amount |
If there is no specification for a resource, nothing of that type will be gathered. If there's less than you want, or your ship has insufficient cargo space, your ship will gather as much as it can. Cargo is beamed up in the same order as the above table shows: minerals first, then colonists, then supplies, then money.
You can only beam up colonists when AllowBeamUpClans is enabled. As a safety feature, at least one clan will be left on a planet. You cannot beam up the last clan using this mission.
beamup commands are not cumulative. If you give multiple commands for one ship, only the last one will be processed, the others will be completely ignored.
Examples:
| beamup 12 N40 | ship 12 gathers 40 kt Neutronium |
| beamup 12 N 40 | invalid: no space allowed between cargo type and amount |
| beamup 93 Nmax $100 | ship 93 gathers as much fuel as it can, and 100 mc |
| be 93 nmax $100 | same, but abbreviated |
| beamup 93 Nmax$100 | invalid: must have space between different types |
Conflict Resolution: This command affects the mission of the ship, and therefore conflicts with other commands that do the same. The effective ship mission will be defined, in decreasing order of precedence, by: refit command, beamup command, extmission command, and mission set at the ship's control screen. For example, if a ship has both a refit and beamup order, it will do refit only.
