🌀 Teleport Animation

Cinematic, GTA-style camera transitions for Waystones and Create: Kinetic Waypoints teleports.

✨ Overview

Teleport Animation replaces the instant cut of a Waystones 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 plays whenever you teleport with Waystones (waystones, warp plates, warp stones and scrolls) or with Create: Kinetic Waypoints (NeoForge 1.21.1 only); it does not animate vanilla /tp. 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

Built around Waystones 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

📋 Requirements

📦 Available Versions

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

🔗 Supported Mods

The animation plays on teleports from these mods. Vanilla /tp is not animated.

Create: Kinetic Waypoints is only published for NeoForge 1.21.1 and Forge 1.20.1, so the other builds do not include this integration.

🎮 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 animation triggers automatically when you teleport with Waystones or a Kinetic Waypoint. Vanilla /tp is not animated.

🙏 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