addShipsToRoute not working in interstellar space (trunk)

[Commander McLane]

Apparently addShipsToRoute doesn't work in interstellar space. It returns null.

This could be deliberately, because there are no routes in interstellar space. A warning/reminder in the Wiki would be nice, though.

[Switeck]

It possibly could be "made to work" but only if distance along the route is set to 0.

[Commander McLane]

That's what I did when it didn't work.

[Eric Walch]

Apparently addShipsToRoute doesn't work in interstellar space. It returns null.

This could be deliberately, because there are no routes in interstellar space. A warning/reminder in the Wiki would be nice, though.

It is better to have it return null than populate all ships near the zero coordinate, because its clearly an oxp error when that code is used in places without any possible route

[JensAyton]

Documentation updated.

[Switeck]

I guess I need to re-read how to place ships at absolute coordinates using the new methods.

[Commander McLane]

I guess I need to re-read how to place ships at absolute coordinates using the new methods.

It's not so difficult, especially for interstellar space. The player is always spawned in the vicinity of the origin [0, 0, 0] (vectors are given in square brackets). So, if you want to spawn a ship there as well, you only need to use

Code: Select all

system.addShips("role", 1, [0, 0, 0]);

If you want more than one ship, you change the 1 to another value.

There is a fourth optional parameter for specifying the radius around the coordinates in which the ships may be spawned. If you don't use it, one scanner radius (25600m) will be used. Therefore the above example is identical to

Code: Select all

system.addShips("role", 1, [0, 0, 0], 25600);

Obviously you can play with the radius parameter as well.

[Eric Walch]

It's not so difficult, especially for interstellar space. The player is always spawned in the vicinity of the origin [0, 0, 0] (vectors are given in square brackets). So, if you want to spawn a ship there as well, you only need to use

Code: Select all

system.addShips("role", 1, [0, 0, 0]);

If you want more than one ship, you change the 1 to another value.

You can do it even shorter by using

Code: Select all

system.addShips("role", 1);

[0, 0, 0] is default position when you skip it. That way is does the same as the old

Code: Select all

system.legacy_addShips("role", 1);