?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Wrap Around World

Wrap Around World

Seamlessly wrap players to the opposite side of a configurable boundary.

23
0
23
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Tags

Creators

Details

Licensed MIT
Published 3 weeks ago

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.