订阅以下载
Sam's Autopilot Manager

Warning, this version is deprecated. See SAMv2 here.

I have a day job. Please buy food and donate it to your local homeless shelters instead.

• Added support for multiple cameras;
  
• Notifications for remote controll and camera detection;

• Have your ship autonomously fly safely and effectively to any location in a planet, without having to worry about adding several waypoints. Just the destination one.
  
• Turn your ships into autonomous navigation vessels. Without a need for a cockpit, just tell it where you want to go, and it goes, with or without you as a passenger.
  
• Automate cargo runs with ease. Worry only about giving it the source and destination. Or give it multiple destinations, up to you.
  
• Worried about mountains and collisions? Worried about your Remote Controller getting stuck? Don't worry anymore.

• This is not a script to have your ships navigate through mazes. Make sure you have clearance for the approaches;

Automating flight runs on a planet requires much effort and is not reliable. The waypoint management system is cumbersome. The Remote Controller Autopilot is a potato on the stick. There needs to be a better way.

A management system that oversees the Remote Controller autopilot. It abstracts the Remote Controller utilization with simple commands. In addition, this system prevents situations where the Remote Controller could get stuck and provides the user with diagnostic tools to avoid it.

Required:

• Remote Controller - Add one to your ship. As closest as possible to the ship's center of mass (see below how). If you have more than one Remote Controller in the grid, tag the prefered remote's name with [SAM].
  
• Camera - Add at least one to your ship, facing the forward direction (same as the remote controller). Make sure there are no obstructions in front of the camera. This will be used for avoiding obstacles. Tag this block's name with [SAM]. Adding a second camera facing down will greatly improve navigation in extreme mountainous scenarious.
  
• Text Panel - Add one for managing the docking locations. Tag this block's name with [SAM].
  
• Programmable block - Add one to your ship, add this script to it. No need for timers;

Optional:

• Text Panel for Diagnostics - Tag a text panel with [SAM diag]; This is used to display several diagnostic stats. What is the distance of the remote control from the center of mass. What are the maximum accelerations in every direction for your ship’s grid.
  
• Text Panel for System Logs - Tag a text panel with [SAM log]; This displays an audit of what the system is currently doing.
  
• Text Panel for GPS - Tag a text panel with [SAM gps]; This exports all the coordinates such that they can be copied to the GPS if needed.

Issue the following commands to the Programmable Block:

• DOCK REGISTER - Registers the ship’s present location as a docking location. Make sure the ship is leveled.
  
• DOCK DELETE - Deletes the selected dock (the selected dock can be seen on the text panel).
  
• DOCK PREV - Selects the previous dock.
  
• DOCK NEXT - Selects the next dock.

• NAV START - Starts navigation to the selected dock.
  
• NAV STOP - Immediately stops navigation.
  
• NAV FAR - Select and navigate to the farthest configured dock.
  
• NAV NEAR - Select and navigate to the nearest configured dock.

• DIAG - Changes tabs on the Diagnostics text panel.

Notifications can be sent to other blocks when certain actions are accomplished.

Programmable blocks
Any programmable block tagged with [SAM NOTIFY] will be executed with the following arguments:

• NAV APPROACH - When the ship is approaching a dock location.
  
• NAV FINISH - When the ship lined up and the remote control stopped.

Timers
Will be triggered or started when the program stops. Tag your timers with:

• [SAM START] - Starts the timer.
  
• [SAM TRIGGER] - Triggers the timer.

Connectors
Will Disconnect/Connect when the program starts/finishes. Tag them with [SAM].

• Approach - The ship will approach the dock location in the same orientation it was first configured. So make sure there is enough clearance above and behind for the approach.
  
• Withdraw - When the ship is in a docking location (it knows this if the docking location is registered) it will withdraw backwards along the same approach vector.
  
• Center of mass - there is a bug where if the remote controller is too far from the center of mass the autopilot will fail to reach the exact destination. So, keep the remote controller as close to the center of mass of the ship as possible. If not immediately on the center, put it above or below as opposed to the sides. The diagnostics Text Panel will provide actual information. It will warn if the distance is larger than 2m.
  
• Acceleration - Your ship's acceleration, in each direction, is a product of your ships thrust and mass. For the autopilot to work properly (several tests) I recommend the acceleration in the Up, Down, Forward, Backwards directions be above 2m.s-2. The diagnostics panel will display more info and warnings about it.
  
• Terrain and grid avoidance - The autopilot manager will avoid mountains, general terrain and large grids. It will do this only during navigation. Not during approach or withdrawal.
  
• Same Grid - SAM will work with blocks on the same grid only. Except for Text Panels which can be in any grid. Use the tag to disambiguate.
  
• Storage - The docks are stored in persistent storage. The system will continue working normally if the game is loaded or saved or interrupted.
  
• Registering docks - Make sure the ship is leveled properly. The autopilot will deliver it in the same exact location facing the same exact direction and perfectly leveled.

I have several prototypes for space and orbital functionalities. I may add to this script if enough people use it.

Feel free to send contributions to the Github[github.com] repository. Add your name to the contributors.