Space Engineers

Space Engineers

Spug's Easy Automated Docking [OBSOLETE/See Description]
 This topic has been pinned, so it's probably important
Spug  [developer] 19 Mar, 2018 @ 10:29am
Troubleshooting guide
Quick few checks:
- Ensure the script is up to date.
- Try recompiling.
- Check to see if it's a mod causing the problem. (try a vanilla ship setup)
- Redock with your connector and update the connection.
- replacing the programming block is a complete hard reset.
- check to see if you're using the tiered thrusters mod or any connector mods, they can occasionally cause problems.

Movement issues:
Try spinning your connector round (grinding it and rotating) - this fixes most bobbing problems.

- If bobbing/wobbling occurs there may be a few ways of fixing, try setting gyrospeed to 4 or lower, or see below:
- There's a "multiplayerFix" variable you can set to true which usually fixes wobbling issues.
- If your ship isn't making it to a horizontal connector in gravity, up the variable to something
like 1.1.
- if your ship is too vigorous in gravity, do the same as above.
- if your ship won't lower to the connector set gravityMultiplier to 1 or lower.
- Try the script without the tiered thruster mod being used.
- Setting your deceleration variable at the top of the script will sort overshooting.
- Lowering your max speed variable will help if you've got lots of things to collide with on the way to a dock or it's simply making you go too fast for your comfort.

Setup issues:
Watch the guide video, make sure you've set up like that.
If it's the optional script that's giving you problems, watch that video guide then look below at the optional module problems troubleshooting section.

Exception errors:
These nearly all come with a little explaination of how to fix the problem, if you need more details about them ask here or in the bug fixing thread.

Not finding your connector or other block:
Make sure it's got the correct tag on it. By default this is "[Dock]" (or "[Home]" for the optional script) without the speech marks. Capital letters can be lower case in whatever tags you use with this script.
Make sure it's on the same grid as the programming block. If you're using a ship with multiple grids; antennae, connectors, and timer blocks from other ship grids are ignored unless "checkGrid" is set to false.

Optional module problems:
- Make sure the antenna on your ship has "[Dock]" in the name and the antenna on the station has "[Home]" in the name or whatever you've changed it to.
- Make sure the antenna on the ship has the programming block with this auto-docking script assigned to it.
- Make sure the antenna on the home station has the programming block with the optional script assigned to it.
- Make sure the antenna are on and have range.
- Check ownership on the blocks.
- Try running the auto-docking script and before it's docked, look at the optional home script message area to see if it's giving any errors that could help.
- Check the programming block on your ship says "found antenna" when recompiled. If not, something has gone wrong with the antenna naming.

Connector locking:
if it's not locking, you have two options, set this value to false for certain success:
spinsWhenConnected = true;
however if you still want it to spin on the connector, you could raise the maximumSuccessAngle value to something like 0.035 or even bigger. Maybe double spinSpeedOnConnector to make it spin faster if it's not spinning very well or something.
Last edited by Spug; 18 Sep, 2018 @ 4:29am