?
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.

2
0
2
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Tags

Creators

Details

Licensed MIT
Published yesterday

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.