Planet - Border teleport

Planet – Seamless World Wrapping

Planet is a server-side mod (Fabric/Forge) that makes your flat map act like a sphere. Any entity (players, mobs, items, arrows) that crosses the world border is instantly teleported to the opposite side – top ↔ bottom, right ↔ left.

How it works (loading process)

1. On first launch, the mod creates config/planet-config.json with default border = ±326.
2. It hooks into entity movement events and checks coordinates every tick.
3. If Y > +326 → teleport to Y = -326 (X,Z unchanged); if Y < -326 → teleport to Y = +326. Same for X axis.
4. Teleport is instantaneous and invisible to players.

Installation (jar loading)

• Stop your server.
• Place the downloaded Planet-<version>.jar into the mods/ folder.
• Start the server – the mod activates automatically.
• Edit the config file if you need different border values (e.g., for a 1000×1000 map set both to 500).

Configuration

planet-config.json:

{
  "borderX": 326,
  "borderY": 326
}