Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MtsAutopilot

An autopilot for Immersive Vehicles (MTS) aircraft. Minecraft 1.20.1, Forge 47.x. The download is a Forge mod, and it is also an MTS content pack, so it can hand a new part to aircraft from any pack you own.

What it adds

One part: the Flight Control Computer. Craft it with 4 iron ingot, 8 redstone, 2 gold ingot and 2 glass pane, or grab it from the creative inventory. In MTS's item list it sits under the pack name MtsAutopilot. Install it on an aircraft and that aircraft gets the autopilot. Any aircraft, from any pack. The server checks for the part every tick, so no computer, no autopilot. It is also a 5 kg crate, so it carries a little cargo on the way.

The autopilot flies the aircraft through its own trims. It does not toggle MTS's autopilot variables, so disengaging cannot leave an MTS autopilot running behind it. When a mode releases the aircraft, the trims go back to you and the AP-disconnect callout plays. That callout is audible up to 32 m away.

Modes

Mode What it does
NAV Flies to the beacon the aircraft has selected, then holds inside 15 m of it. If nothing is selected when you engage, it tunes the nearest beacon first. Banks up to 25 deg.
APP ILS: localizer and glideslope. Picks the nearest beacon that has a glideslope, intercepts it with up to 30 deg of intercept heading, then captures and tracks both. The glideslope is captured from on or above the path, never from below. Banks up to 30 deg. At 5 m above the beacon it hands the aircraft back, so the flare is yours.
HDG SEL Holds the heading you give it, in degrees. Banks up to 25 deg.
ALT SEL Climbs or descends to the altitude you give it and levels off there. Captures within 1 m. The rate comes from /ap vs: 3 m/s if you never set one, 15 m/s maximum.
A/T Holds a speed. ARM is the gate: nothing in the auto-throttle moves until it is armed.
TO/GA One push: throttle to the stop in about 2.5 s, then hold it there. Needs the A/T armed.

Commands

Every command acts on the aircraft you are sitting in. /at is the auto-throttle, /ap is the autopilot.

/at arm [on|off]                arm the auto-throttle
/at disarm                      disarm it, the throttle goes back to you
/at spd <n> | on | off          preset the speed, or switch the A/T on and off
/at unit [blk|kph|mph|kt|real]  show or change the speed unit, default blk/s. The stored preset is converted.
/at toga                        one TO/GA push

/ap nav [on|off]                fly to the selected beacon, no argument toggles
/ap app [on|off]                ILS, localizer and glideslope
/ap hdgsel <deg> [on|off]       hold a heading, alias /ap hdg
/ap altsel <m> [on|off]         fly to that altitude and level off on it
/ap vs <m/s>                    set the ALT SEL rate or report it. On its own it engages nothing.
/ap off                         every autopilot mode off

Altitudes and vertical speeds are metres and m/s. /ap altsel 1200 is 1200 m, not 1200 blocks.

Panel switches

The computer offers six panel switches: NAV, APP, AT, HDGSEL, ALTSEL and ATARM. MTS adds a button to the panel for each one, in that order, wherever the panel still has custom_variable slots free. A button and its chat command flip the same variable, so a pilot can mix the two. A panel with no free slots is no problem: use chat.

Multiplayer

Commands go to the aircraft the sender is riding, so two pilots in two aircraft never touch each other's autopilot. A command from someone who is not sitting in an aircraft is refused, with a short line in chat. An aircraft only runs the autopilot while it carries a Flight Control Computer and has a pilot in it.

Install

  1. Minecraft 1.20.1 with Forge 47.x.
  2. Immersive Vehicles (MTS) 1.20.1, version 24.0.0 or newer. It is required on both sides and it is not included in this download.
  3. Drop MtsAutopilot-1.0.0.jar into the mods/ folder of the server and of every client. MTS does not send packs over the network, so each side needs the pack assets as well: the part JSON, the OBJ model and its MTL, both textures, the item icon, the item model MTS's item registry reads, the callout sound and the Simplified Chinese language file. All of them are inside this jar.
  4. Start the game once. config/mcap.properties is written next to the game or the server.

Prerequisites you have to get yourself

The jar contains this mod only: 6 classes and the pack assets. No third-party code is bundled in it, and no third-party jar is published in the source repository either.

libs/ is empty in this repository. Immersive Vehicles is third-party software and its licence is not mine to pass on, so no copy of it is committed or published: the folder is there for you to drop your own jars into, and it stays git-ignored. The mod jar itself holds this mod only, 6 classes plus the pack assets.

To play you install one jar, Immersive Vehicles-1.20.1-24.0.0.jar, from its own page. Immersive Vehicles ships as two halves, the minecrafttransportsimulator API and the mcinterface1201 Forge adapter, and both sit in that one mod jar. There is no second download to hunt down. For building, build.bat and ./gradlew build both compile against the copy installed in your game (see mtsJar in gradle.properties).

Where to get them:

  • Immersive Vehicles (MTS) for 1.20.1, by Don Bruce and the MTS contributors, from its own CurseForge page. Any 24.x or newer 1.20.1 build works.
  • Minecraft Forge 47.x for 1.20.1, from the Forge website.
  • Minecraft 1.20.1 itself, from Mojang. A licensed copy, please.

Settings

config/mcap.properties holds one line:

log.level=INFO

Use ERROR, WARN, INFO or DEBUG. The default, INFO, logs events only, so a normal flight is quiet. DEBUG adds a state dump whenever a mode changes and a heartbeat every 10 s. The file is read at startup, so restart the game after editing it.

Build from source

  • build.bat. Offline. No Gradle, no mappings. It checks the MTS and Forge APIs it uses, compiles with javac --release 17, packs the jar and verifies the result. build.bat deploy also copies it into the test instance's mods/ folder. Output: build/libs/MtsAutopilot-1.0.0.jar.
  • ./gradlew build. The ForgeGradle 6 route: Minecraft 1.20.1, official mappings. It needs a network the first time, and it compiles against your own copy of Immersive Vehicles (mtsJar in gradle.properties, or a jar you drop in libs/). It also gives you ./gradlew runClient and ./gradlew runServer.

The paths to edit after a Forge update, and the list of checks the build runs, are in libs/README.txt.

Licence

MIT, copyright (c) 2026 KasaneTeto-LLY. The text is in LICENSE. It covers the mod's code, its pack assets and this documentation.

Two things it does not cover:

  • Immersive Vehicles (MTS), Minecraft Forge and Minecraft are not mine, and none of them is distributed here.
  • The AP-disconnect callout, assets/mcap/sounds/ap_disconnect.ogg, was collected from the internet. Its original author and licence are unknown, so it is not covered by the MIT licence, and it will be removed if its owner asks.

This is an unofficial fan addon. It is not affiliated with Immersive Vehicles, Minecraft Forge, Mojang or Microsoft, and it comes with no warranty. DISCLAIMER.md has the details.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages