airship-autopilot/README.md

# 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 on a server

On the CC computer, run one command. Pick the role for that machine:

```
-- machine-room PC (full autopilot, boots to standby):
wget run https://gt.zyon.no/Stian/airship-autopilot/raw/branch/main/install.lua autopilot

-- pilot-house PC (control console):
wget run https://gt.zyon.no/Stian/airship-autopilot/raw/branch/main/install.lua cockpit
```

Omit the role to get a menu. Re-run any time to update to the latest code.

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

## Roles

| Role        | Source PC | Boots           | Purpose                                  |
|-------------|-----------|-----------------|------------------------------------------|
| `autopilot` | 0         | `stabilizeV2 standby` | v3 observer autopilot (13 modules in `autopilot/`) |
| `cockpit`   | 4         | `cockpit`       | pilot control console                    |

Boot chain (autopilot): `startup.lua` -> `stabilizeV2` -> `autopilot/main.lua`.
Menu / wiring / sign-test: `Ctrl+T` then `stabilizeV2` for the menu.

## Updating the code

The `files/` tree mirrors the live singleplayer world. After editing the Lua
locally, regenerate the manifests and push:

```
./build.sh
git commit -am "sync autopilot"
git push
```

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

`build.sh` reads from the "Modda wii" world by default; pass a different
`computercraft/computer` path as arg 1 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.