Files
airship-autopilot/README.md
Stian 4cd2573f56 Airship autopilot: role-based wget installer for server
Mirrors the live CC autopilot (computer 0) and cockpit (computer 4) from the
Modda wii world. install.lua fetches each role's manifest over HTTP so the
system installs on any server regardless of computer id.

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

55 lines
2.0 KiB
Markdown

# 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://raw.githubusercontent.com/Sterister/airship-autopilot/main/install.lua autopilot
-- pilot-house PC (control console):
wget run https://raw.githubusercontent.com/Sterister/airship-autopilot/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.