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 -Z sends 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

1. Download the .zip file
2. Place it in your world's datapacks/ folder:

   saves/<your-world>/datapacks/wbtp_datapack.zip

1. Run /reload in-game, or load into the world
2. 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 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.