Editing Piloting Guide

This guide will teach you how to fly a ship.

== Redetecting ==
Redetecting is done by clicking redetect in the ship computer menu. It runs a check for all pilotable blocks connected to the jukebox.

This must be done once before piloting, but does not need to be done again unless the ship's block composition changes.

The collection of blocks connected to the jukebox and on the pilotable blocks list will be considered "detected" and part of the new starship. "Connected" means that the target block is adjacent to the starship in all directions, including diagonally.

To redetect, left click the ship computer with a controller. This brings up the ship computer menu.

Change the starship type (3rd button from the left) to the desired type.

Open the ship computer menu again and redetect (leftmost button).

Upon a successful redetect, you will receive a message stating the redetect was successful along with the block count of the starship.

If the redetect fails, check if the starship is connected to something (the ground or a building). If needed, contact staff to unstuck the starship.

The "front" of your ship will either be defined by the direction the most thrusters face away from, or the side of the ship that faces north each time you pilot, if there are no thrusters or an equal amount in all directions. The front of your ship defines which direction your direct control will face.

== Piloting ==
Brings the starship under your active control.

Right click the ship computer of a detected starship with a controller.

If the piloting action fails, check to see if the ship has been detected or if the ship is missing blocks.

If successful, a sound cue will play and a notification will appear saying you have piloted the ship.

To relesase (deactivate) a ship, right click the ship computer with a controller again or use /release.

To unpilot a ship but allow it to remain active with no pilot, use /unpilot.

To get off a ship which you are not the pilot of, use /stopriding.

== Movement ==
There are multiple ways to control a ship.

=== Shift Flying ===
While holding a clock, sneak and look in the direction that you want your ship to go. The ship will move several blocks per second.

Good for fine control of movement.

=== Cruising ===
Right click the Cruise Control [cruise] sign in the direction that you want to go, or use /cruise. 

Your starship will move quickly in the specified direction.

Left click the Cruise Control sign, or use /cruise again to slow down and stop.

Cruise speed is based on thruster composition and mass.

Cruising is only possible in directions directly opposite your thrusters, and 45 degrees to the left and right. if your ship has thrusters facing all directions, your ship can cruise in all directions.

=== Direct Control ===
Direct control or colloquially "DC" is activated via the /dc command and allows for fine control of your starship.

Direct control allows you to control your starship's movement manually: w, a, s, and d keys control strafing and upward/downward movement (the w and a keys are inverted in this case.)

Commonly utilized to control smaller warships such as gunships and starfighters within combat.

DC speed is determined by the block count of a starship, every 700 block increment decreases total DC speed.

=== Turning ===
Left click the Helm [helm] sign (the sign with a lot of lines) to turn the ship left. Right click to turn the ship right.

While holding a clock, press Throw Item (default Q) to turn left. Press Swap to Offhand (default F) to turn right.

== Tutorial Videos ==
https://youtu.be/iH5PjGmSvMU

https://youtu.be/2LZNTwg5X_I