PaperMC / PaperMC/Paper

Teleporting a player above y 20000500 softlocks the player

Open
#13,023 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

status: accepted version: 1.21.8
Dominant language
Java
Stars
12.7k
Forks
3.5k
Avg merge
3d 13h
Merged PRs (30d)
11

Description

Expected behavior

Teleporting a player above y 19999999 should not be possible (vanilla maximum altitude)

Observed/Actual behavior

The console will continuously spam moved too quickly with positions below y 0 relative to your altitude above the max limit (https://mclo.gs/G2PtvCS)
and soft-lock the player (unable to move in any way)

Steps/models to reproduce
  1. Teleport a player to y 20000500 using API
  2. observe the logs
Plugin and Datapack List

pl
[18:39:01 INFO]: ℹ Server Plugins (4):
[18:39:01 INFO]: Paper Plugins:
[18:39:01 INFO]: - PerWorlds, ServiceIO, Tweaks, Worlds

datapack list
[18:39:04 INFO]: There are 3 data pack(s) enabled: [vanilla (built-in)], [file/bukkit (world)], [paper (built-in)]
[18:39:04 INFO]: There are no more data packs available

Paper version

This server is running Paper version 1.21.8-50-main@51706e5 (2025-08-25T02:01:41Z) (Implementing API version 1.21.8-R0.1-SNAPSHOT)
You are running the latest version
Previous version: 1.21.8-2-4ed5b66 (MC: 1.21.8)

Other

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start from the server API teleport path and reproduce the case by placing a player at y 20000500. Trace the handling of coordinates above the vanilla maximum altitude; done means the teleport is rejected or safely handled without repeated “moved too quickly” logs or a soft-locked player.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
backend, game-dev
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.