Sail your Create: Aeronautics airship through a Minecraft or Modded portal and the whole ship goes with you. Players, passengers, decorations, and more travel together. AeroPortals is the bridge between Create's airships (Sable physics) and Minecraft's portal system.
Sable is a deeply intrusive physics mod and stability is never guaranteed. Always back up your worlds before using this mod. If something goes wrong, please report it on our issue tracker with logs and a reproduction case. We will do our best to accommodate new feature requests alongside bug fix updates.
Nether portals Fly your airship into a nether portal and you and the ship arrive on the other side. Wide ship? Build a wide portal. AeroPortals matches the source portal's dimensions at the destination, generates one if needed, and clears a safe landing area so you don't end up entombed in a wall of basalt.
End portals Sail onto an end portal and the ship lands on the obsidian platform in the End. If the platform was destroyed (or you're in a custom End) AeroPortals rebuilds it before you arrive. Travelling back from the End drops you near world spawn.
Aether portals (when The Aether is installed). Same idea as nether portals but with glowstone frames and the Aether dimension.
Ars Nouveau warp portals (when Ars Nouveau is installed). Use a Warp Scroll to configure the portal's destination, then fly your ship into it. The ship lands on top of the configured warp position.
Draconic Evolution portals (when Draconic Evolution is installed). Build a Dislocator Receptacle portal with a configured Dislocator and fly your ship through. The ship lands on the receptacle's stored target.
Pina colada teleport (when Tropicraft is installed). Drink a pina colada while sailing your airship and you and the ship travel to the Tropics. Drink another in the Tropics to come home.
When the ship teleports, these passengers come along:
These do NOT come along:
This matches what already happens when you fly your ship around normally: those entities fall off. The portal teleport behaves the same way.
Drop in a one-file datapack at data/sable/tags/entity_type/retain_in_sub_level.json:
{
"replace": false,
"values": [
"minecraft:cow",
"minecraft:villager",
"minecraft:wolf"
]
}
Multiple datapacks merge cleanly, so several mods can add to this tag without stepping on each other.
/aeroportals teleport <dimension> (op only)OP-level command (permission level 2). Teleports you and the airship you're riding to the named dimension. Autocompletes the dimensions available to your server:
overworld, nether, end alwaysaether when Aether is installedtropicraft when Tropicraft is installednamespace:path directlyThe ship lands at a sensible spot in the destination: the obsidian platform for the End, somewhere safe above the surface for everything else.
config/aeroportals-server.toml is generated on first server launch.
| Key | Default | What it does |
|---|---|---|
detection.scan_interval_ticks |
5 |
How often the mod checks if your airship is touching a portal (in server ticks; 20 = 1 second). |
detection.verbose_logging |
true |
Log each teleport at INFO level. Turn off for quieter logs. |
detection.max_sublevel_aabb_volume |
200000.0 |
Skip teleporting any ship larger than this volume. Sanity guard so a wildly-misconfigured ship doesn't trigger a teleport. |
teleport.portal_cooldown_ticks |
200 |
After teleporting, the ship is locked out of portals for this long (in ticks). Prevents a ship from immediately re-teleporting back through the destination portal. |
teleport.dest_portal_search_radius |
128 |
How far AeroPortals looks for an existing matching portal at the destination before deciding to build a new one. |
teleport.generate_matching_portal |
true |
If false, the teleport aborts when no destination portal is found instead of building one. |
AeroPortals writes the ship snapshot to disk before moving it. If the server crashes mid-teleport, the ship is recovered on next startup instead of being lost.
sub_level_velocity_retained_on_load in Sable's config if you want full preservation.Open an issue on the GitHub issue tracker. We're open to adding support for additional portal mods and custom dimensions: just let us know which mod you'd like to see and we'll take a look.
AeroPortals fires SubLevelTransferEvent on the NeoForge event bus after each teleport, with the new SubLevel, source/destination dimensions, and translation vector. Useful if your mod tracks cross-SubLevel positions (for example, docking pairs, partner references) that need updating after a move.
MIT, see LICENSE.md.
