[RetVar/IF][RefObj] catch ware object [Value]

Previous: @ [RetVar/IF][RefObj] move to ware object [Value] for collecting: timeout =[Var/Numbe Fly Commands Next: @ [RetVar/IF][RefObj] move around [Var/Number] ms
This page is a chapter in the book Fly Commands.
[skip|else] if [not]|while [not]| [RetVar/IF] = [RefObj] catch ware object [Value]

Brings [Value] into the cargo bay of a ship once the ship has been put into position by use of the move to ware object for collecting instruction. The ware must be of a size class that the ship is capable of carrying, and the collecting ship must have enough room in its cargo bay for it. After executing this instruction, [Value] will be removed from the sector, whether or not the collecting ship has room for it.

Do not use this for illegal objects. While a TS can “catch” a ship, the ship will then be destroyed and the TS' cargo bay bugged until the maintype 7 cargo is deleted again.
Cargo pods can contain illegal wares when created by scripts.

Returns [TRUE] (1) if the ware is added to the collecting ship, [FALSE] (0) if the ware is not added to the collecting ship, or if any of the arguments are invalid.


Tags for this Page

Posting Permissions

Posting Permissions
  • You may not create new articles
  • You may not edit articles
  • You may not protect articles
  • You may not post comments
  • You may not post attachments
  • You may not edit your comments