Teleport Animation

🌀 Teleport Animation

Cinematic, GTA-style teleport transitions for Minecraft.

---

✨ Overview

Teleport Animation replaces the instant cut of a teleport with a cinematic camera move: the camera pulls up off the player through several zoom stages, glides across the world toward the destination, and descends back down as you arrive. It hooks /tp and /teleport, and integrates with Waystones and JourneyMap so their teleports get the same treatment. Terrain fades chunk-by-chunk along the camera's path, custom sounds mark each stage, and every timing / height / volume is configurable. A fork of Grand Teleport by Codex (Forge 1.20.1), with contributions to the original by hookuru_. Ported and reworked for NeoForge and Fabric by Stalking Dragons. The original Grand Teleport code is MIT licensed. Not affiliated with or endorsed by the original authors.

🎯 Features

🎬 Cinematic Camera Animation

The camera zooms out, travels above the terrain, and zooms back in on arrival — fully animated and configurable.

📐 3-Stage Zoom Heights

Configurable pull and push stages for the zoom, with per-dimension settings for the Overworld, Nether and End.

🔊 Custom Sounds

Distinctive sound effects for each animation step: camera zoom, step flash, and travel wind.

🎨 Step Flash Overlay

A subtle screen flash at each zoom stage to enhance the transition.

🧊️ Chunk-by-Chunk Mask Fade

Terrain fades out and in following the camera's direction of travel, avoiding abrupt visual cuts. Nearby destinations use a smooth slide; distant ones mask the mid-flight chunk load with a short fade.

⏸️ Player Freeze

Optionally freeze movement and look controls during the transition.

🔌 Broad Mod Compatibility

Integrates with Waystones and JourneyMap teleports; plays nicely with Sodium, Iris, Distant Horizons, Bobby, Voxy and Leawind's Third Person.

🌐 Cross-Dimension Travel

Full animation support for dimension changes, with a fallback for when destination chunks are still loading.

⚙️ Fully Configurable

Every parameter — heights, tick lengths, volumes, toggles — is adjustable from the in-game config screen or the config file.

🧱 Mod Structure

Area	What it provides
transition controller	Drives the pull / travel / push phases, camera frames, arrival detection and chunk handoff.
step effects	The step flash, travel blackout and HUD fade overlays.
command hooks	Intercepts /tp, /teleport and /execute…run tp, plus the /ta command tree.
Waystones / JourneyMap bridges	Reflection bridges that route those mods' teleports through the animation.
compat	Sodium / Iris / Distant Horizons / Bobby / Voxy / Leawind terrain-refresh and camera hooks.
config	The persistent config and the in-game config screen.

📋 Requirements

Minecraft / loader / Java	see Available Versions below
Dependencies	NeoForge: none required. Fabric: Fabric API (and Waystones on Fabric 1.21.1). Optional integration with Waystones and JourneyMap.
Side	Client and Server

📦 Available Versions

Minecraft	Loader	Java	Latest build	Status
1.21.1	NeoForge 21.1.235+	21	1.3.0	Stable
1.21.1	Fabric Loader 0.19.5+ & Fabric API	21	1.0.0	Stable
26.1.2	NeoForge 26.1.2.78+	25	1.1.0	Stable
26.1.2	Fabric Loader 0.19.5+ & Fabric API	25	1.0.0	Stable
26.2	NeoForge 26.2.0.57+	25	1.3.0	Stable
26.2	Fabric Loader 0.19.5+ & Fabric API	25	1.0.0	Stable

All versions share this CurseForge project. Pick the file that matches your Minecraft version and loader. All listed builds share the same fix line.

🎮 How to Use

1. Use /ta on|off to toggle the teleport effect.
2. Use /ta status to check whether it is enabled.
3. Use /ta player_freeze on|off to toggle player freeze during transitions.
4. Use /ta to open the configuration screen.

The mod intercepts /tp, /teleport and /execute…run tp, plus teleport packets from Waystones and JourneyMap.

---

🙏 Credits & License

Teleport Animation is a fork of Grand Teleport by Codex (Forge 1.20.1), with contributions to the original by hookuru_. Ported and reworked for NeoForge and Fabric by Stalking Dragons.

The code is under the MIT license (see the LICENSE file). The bundled sound effects are third-party audio carried over from Grand Teleport — they are not original to this project, not covered by the MIT grant, and are included only for non-commercial in-game use as part of this mod. Do not extract or redistribute the sound files separately.

https://codex.skdragons.com/
Codex Stalking Dragons — Minecraft Modding