Wrap Around World

# 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//datapacks/wbtp_datapack.zip ``` 3. Run `/reload` in-game, or load into the world 4. 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 ``` 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 (https://minecraft.wiki/w/Function_(Java_Edition)#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.