Wrap Around World
Seamlessly wrap players to the opposite side of a configurable boundary.
Wrap Around World
Seamlessly wrap players to the opposite side of a configurable boundary — no mods, no plugins, just a datapack.
Overview
Wrap Around World adds a fully configurable fake border to your world. When a player crosses the boundary on any axis, they are instantly teleported to the opposite side — creating a wrap-around, toroidal world effect similar to classic arcade games, or a globe earth.
The boundary size is adjustable at any time with a single command, and the effect is completely invisible to the player aside from the actionbar notification.
Features
- 🔁 Wrap-around teleportation — crossing
+X,-X,+Z, or-Zsends you to the opposite side - 📐 Fully configurable boundary — change the border size live with one command, no reload required
- 💾 Persistent config — border size survives world reloads
- ⚡ Lightweight — a single scoreboard check per player per tick, nothing more
- 🧱 No mods required — pure vanilla datapack, compatible with any server
Installation
- Download the
.zipfile - Place it in your world's
datapacks/folder:
saves/<your-world>/datapacks/wbtp_datapack.zip
- Run
/reloadin-game, or load into the world - You should see the confirmation message in chat
Note: The datapack must remain as a
.zip— do not extract it.
Usage
Check the current border size
/function wbtp:set_border
Prints the current boundary distance and the command to change it.
Set a custom border size
/scoreboard players set #border wbtp.config <size>
Examples:
| Command | Effect |
|---|---|
/scoreboard players set #border wbtp.config 3500 | Default — 7000×7000 block play area |
/scoreboard players set #border wbtp.config 1000 | Compact — 2000×2000 block play area |
/scoreboard players set #border wbtp.config 10000 | Large — 20000×20000 block play area |
The change takes effect immediately — no reload needed.
How It Works
Every tick, each player's X and Z coordinates are read into scoreboards and compared against the configured #border value. If a player meets or exceeds the threshold in any direction, they are teleported to (border - 10) on the opposite side, landing safely 10 blocks inside the boundary to prevent a re-trigger loop.
Teleportation uses Minecraft's function macro#Macros) system ($tp) introduced in 1.20.2, which is the correct modern approach for coordinate-based teleportation since direct NBT position writes were removed in 1.20.5.
Compatibility
| Version | Status |
|---|---|
| 1.21.1 | ✅ Fully supported |
| 1.20.5 – 1.20.6 | ✅ Should work (untested) |
| 1.20.2 – 1.20.4 | ⚠️ Requires macro support — untested |
| Below 1.20.2 | ❌ Not supported |
Known Limitations
- Coordinates are stored as integers — sub-block precision is not preserved on teleport. Players land at whole-block coordinates.
- The boundary applies to all dimensions (Overworld, Nether, End). If you only want it in the Overworld, this would require a small modification.
- The Minecraft world border and this datapack's fake border are independent — this does not replace or interact with
/worldborder.
License
This datapack is free to use on any server, in any modpack, or as a base for your own projects. Credit is appreciated but not required.