<!--
SPDX-FileCopyrightText: 2023 Leon Friedrich <60421075+ElectroJr@users.noreply.github.com>
SPDX-FileCopyrightText: 2023 Pieter-Jan Briers <pieterjan.briers+git@gmail.com>
SPDX-FileCopyrightText: 2023 end <72604018+laok233@users.noreply.github.com>
SPDX-FileCopyrightText: 2024 Kira Bridgeton <161087999+Verbalase@users.noreply.github.com>
SPDX-FileCopyrightText: 2024 Terraspark4941 <terraspark4941@gmail.com>
SPDX-FileCopyrightText: 2025 Aiden <28298836+Aidenkrz@users.noreply.github.com>
SPDX-FileCopyrightText: 2025 ArtisticRoomba <145879011+ArtisticRoomba@users.noreply.github.com>

SPDX-License-Identifier: AGPL-3.0-or-later
-->

<Document>
  # Shuttle-craft

  Shuttle construction is straightforward, albeit rather expensive and hard to pull off within an hour.

  It's a good activity if you have a significant amount of spare time on your hands and want a bit of a challenge.

  ## Getting started
  <Box>Required parts:</Box>
  <Box>
  <GuideEntityEmbed Entity="Thruster"/>
  <GuideEntityEmbed Entity="Gyroscope"/>
  <GuideEntityEmbed Entity="ComputerShuttle"/>
  <GuideEntityEmbed Entity="SubstationBasic"/>
  <GuideEntityEmbed Entity="PortableGeneratorPacman" Caption="P.A.C.M.A.N." />
  </Box>
  <Box>
  <GuideEntityEmbed Entity="CableHVStack"/>
  <GuideEntityEmbed Entity="CableMVStack"/>
  <GuideEntityEmbed Entity="CableApcStack"/>
  <GuideEntityEmbed Entity="APCBasic"/>
  </Box>

  <Box>Optional parts:</Box>
  <Box>
  <GuideEntityEmbed Entity="AirCanister"/>
  <GuideEntityEmbed Entity="LightTube" Caption="lighting"/>
  <GuideEntityEmbed Entity="AirlockGlassShuttle"/>
  <GuideEntityEmbed Entity="SMESBasic"/>
  </Box>
  <Box>
  <GuideEntityEmbed Entity="MobCorgiIan"/>
  <GuideEntityEmbed Entity="NuclearBomb"/>
  </Box>

  ## Foundation
  For this step you'll need steel sheets, metal rods, and floor tiles (optional).

  <Box>
    <GuideEntityEmbed Entity="SheetSteel" Caption=""/>
    <GuideEntityEmbed Entity="PartRodMetal" Caption=""/>
  </Box>
  <Box>
    <GuideEntityEmbed Entity="FloorTileItemSteel" Caption=""/>
    <GuideEntityEmbed Entity="FloorTileItemDark" Caption=""/>
    <GuideEntityEmbed Entity="FloorTileItemWhite" Caption=""/>
  </Box>

  Head out into space with steel sheets and metal rods in hand and click on the edge of the station to place lattice.

  Place a line of lattice about 3-4 tiles away from the station, then start building a platform with lattice.

  Keep doing this until you have a platform that is at least 3x3 in size, which is connected to the station via a single lattice line.

  Once you're finished constructing the base of your shuttle, you can use wirecutters to snip the connecting lattice that joins your new ship and the station.

  This platform is considered a different grid from the station and thus will not have any gravity or be held in place by a station anchor — it can move around freely.

  You can expand your lattice platform further by clicking just off the edge with some rods in hand.

  ## Docking Ports
  Shuttle airlocks serve as docking ports, where ships can dock to stations safely.

  The orientation of docking ports is important, as it determines on which face the shuttle will dock.

  The little numb on the bottom of the docking port determines the direction of the docking port.

  <Box>
    <GuideEntityEmbed Entity="AirlockShuttle"/>
    <GuideEntityEmbed Entity="AirlockGlassShuttle"/>
  </Box>

  ## Directional Control
  From there, once you have the shape you want, bring out and install thrusters at the edges.

  <Box>
    <GuideEntityEmbed Entity="Thruster" Caption="" Rotation="0"/>
    <GuideEntityEmbed Entity="Thruster" Caption="" Rotation="90"/>
    <GuideEntityEmbed Entity="Thruster" Caption="" Rotation="180"/>
    <GuideEntityEmbed Entity="Thruster" Caption="" Rotation="270"/>
  </Box>

  It's a good idea to install four thrusters, one on each side of the platform, to ensure you can move in any direction.

  They must be pointing outward into space to function and will not fire if there's a tile in the way of the nozzle.
  You can rotate thrusters—even anchored ones—using either [color=yellow][bold][keybind="RotateObjectClockwise"][/bold][/color] or [color=yellow][bold][keybind="RotateObjectCounterclockwise"][/bold][/color] to rotate clockwise or counterclockwise.

  Thrusters can be disabled or enabled using [color=yellow][bold][keybind="Use"][/bold][/color] with an empty hand or [color=yellow][bold][keybind="ActivateItemInWorld"][/bold][/color].

  ## Rotational Control
  Now that you have directional control, you'll need to install a gyroscope to control your rotation.

  <Box>
    <GuideEntityEmbed Entity="Gyroscope"/>
  </Box>
  The placement of the gyroscope is not as important as the thrusters, but it should be somewhere convenient for you to access and power.

  Note for large mass objects, you may need more than one gyroscope to rotate effectively.

  ## Power
  Now that you have all the systems in place, you'll need to power them.

  For small shuttles, a J.R.P.A.C.M.A.N.-type portable generator is a good choice. It provides straight LV power, so you don't have to worry about transformers.
  Fuel for the generator is also commonly found in maintenance tunnels.

  <Box HorizontalAlignment="Stretch">
    <Box>
      <GuideEntityEmbed Entity="PortableGeneratorJrPacman" Caption="J.R.P.A.C.M.A.N."/>
    </Box>
    <Box>
      <GuideEntityEmbed Entity="WeldingFuelTankFull"/>
    </Box>
  </Box>

  Some stations, however, provide much better generators and compact solutions like the Shuttle APU or the static generator.
  These output HV and will have to be stepped down to MV and LV.
  Luckily, these stations also usually provide wallmount substation boards for this purpose.

  <Box HorizontalAlignment="Stretch">
    <Box>
      <GuideEntityEmbed Entity="GeneratorWallmountAPU"/>
    </Box>
    <Box>
      <GuideEntityEmbed Entity="GeneratorBasic15kW"/>
    </Box>
    <Box>
      <GuideEntityEmbed Entity="SubstationWallBasic"/>
    </Box>
  </Box>

  ## Piloting
  Finally, install the shuttle computer wherever it is convenient and ensure all your thrusters and gyroscopes are receiving power (remember to wire the MV and LV networks!).
  If they are, congratulations! You should have a functional shuttle!

  Making it livable and good-looking is left as an exercise to the reader.
</Document>
