Sterister 81e558d04e Sign test v3: a crooked ship is the measurement, not a failure
The tilt abort was circular logic -- it demanded a balanced ship before it
would learn how to balance one. Removed entirely, and the test restructured
so imbalance is handled structurally rather than guarded against:

- Rocking probe: alternate front/aft pushes; sign = rate(+) - rate(-).
  A constant lean appears in both terms and cancels exactly, so no balanced
  baseline is needed. Alternating also keeps the ship rocking around its
  start attitude instead of accumulating tilt. Two agreeing cycles verify.
- New BALANCE phase: with the sign known, an integral loop learns the
  differential trim that actually levels this ship and saves it as the
  pitchTrim warm-start. Not converging is a warning, not a failure.
- maxTiltAbort is now "measurement is good enough, stop pushing" -- it ends
  a measurement early once the window is full, never the test.
- Only three failures remain: no lift, liftoff timeout, no response on any
  gimbal axis.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-23 23:56:20 +02:00

Airship Autopilot (Create: Aeronautics + CC:Tweaked)

Altitude/pitch autopilot for a hot-air airship, delivered as an in-game installer so it runs on any Minecraft server regardless of the computer's id.

Install — ONE command, both PCs

Run the same command on each CC computer:

wget run https://gt.zyon.no/Stian/airship-autopilot/raw/branch/main/install.lua

The installer detects which PC it is on (flight sensors → autopilot, monitor → cockpit), installs the right role, and continues straight into setup — no reboot, no role names to remember. Re-run the same command any time to update; it also cleans out files that no longer belong and asks whether to keep or reset the ship profile.

(Advanced: append autopilot or cockpit to override detection.)

Requires HTTP enabled on the server (default on). If it is off, set [http] enabled = true in computercraft-server.toml and restart the server.

First-time setup (per ship)

The installer ships code only — everything ship-specific (which redstone side drives which balloon, pitch sign, hover level) is measured on the ship by the setup wizard, which the install flow takes you straight into:

  1. Wiring — the wizard pulses each free side; you say which burner fired.
  2. Sign test — the ship lifts off by itself, finds its own lift power, then rocks between front and aft pushes. The sign comes from rate(+push) rate(push), which cancels any constant lean exactly, so a ship hanging crooked measures fine — that lean is the thing being measured. It then learns the differential trim that levels the ship, saves it as a warm-start, and descends to hover. No config editing, no freefall. Takes 24 minutes.

After that the ship is ready: FLY from the menu or ENGAGE from the cockpit console. Pitch and altitude keep self-learning in flight. The wizard can be re-run any time: ap setup, press S in standby, or menu choice 1.

Balloon orientation does not need to match any particular side of the computer — or any particular build direction: sensors are found by type, wiring is mapped by the wizard, and the sign test measures which gimbal axis responds to the push (saved as pitchIndex) along with its sign. The only physical requirement is two balloons spaced along the hull.

Roles

Role Boots Purpose
autopilot ap boot → wizard/standby v3 observer autopilot (13 modules in autopilot/)
cockpit cockpit pilot control console (monitor + modem)

Boot chain (autopilot): startup.luaap bootautopilot/main.lua. Menu any time: Ctrl+T, then ap. (stabilizeV2 remains as an alias.)

Ship state lives on the computer only: sides.txt, calib.txt, target.txt, settings.txt. Reset it via menu pR, or when re-running the installer.

Updating the code

The repo is the source of truth for the installer. After editing the Lua:

./build.sh                # regenerate manifests
git commit -am "sync autopilot"
git push

Then re-run the wget run command in-game to pull the update.

Syncing with the singleplayer dev world (optional):

./build.sh --from-world   # world -> files/  (code only; state/legacy filtered)
./build.sh --to-world     # files/ -> world  (code only; never touches state)

Default world path is the "Modda wii" save; pass a different computercraft/computer path as arg 2 if the world moves.

Notes

Design history, hardware facts, tuning lessons and the recommended control strategy are in AIRSHIP_AUTOPILOT_NOTES.md (in the modpack profile). The control loop never fully converged; pitch oscillation under climb is the open problem. Keep the altitude cascade simple and make pitch a slow trim.

Description
CC:Tweaked airship autopilot + wget installer
Readme 242 KiB
Languages
Lua 97.3%
Shell 2.7%