Mods / World Border

Tags:
Utility
Author:
Xel
Side:
Server
Created:
May 13th 2023 at 8:34 PM
Last modified:
Mar 11th at 1:21 AM
Downloads:
2906
Follow Unfollow 31
Latest release (for Vintage Story 1.21.0, potentially outdated):
worldborder-1.7.1.zip  1-click install
For testers (for Vintage Story 1.22.0-rc.2):
worldborder-1.8.0.zip  1-click install

A serverside-only world border mod. Players that walk past a configured max radius from the center of the map will be teleported back within the radius a little ways from the edge. Translocators that would take the player outside of the allowed area are disabled.


Config options:

WorldRadiusChunksXZ The radius of the worldborder in each direction, in chunks.
WorldBorderPaddingBlocks The distance away from the border players will be teleported if they go past the border, in blocks.
CheckIntervalSeconds How often to check player positions, in seconds.
NewPlayerCheckDelaySeconds How long to wait before starting to enforce a newly joined player's position, in seconds
BorderShape The shape of the border. Either Square or Circle.
PreventFarTranslocatorExits Whether to stop translocators from picking exits outside the border. May cause translocators to never find an exit if the border is small (<12 chunks).
WorldCenter X and Z world coordinates of the center point of the radius
LoopEdges Whether to loop around to the other side of the world when going over the edge
WorldRadiusChunks (deprecated) The radius of the worldborder, in chunks.

 

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.8.0 worldborder 25 Mar 11th at 1:21 AM worldborder-1.8.0.zip 1-click install
  • Update to 1.22
1.7.1 worldborder 116 Aug 26th 2025 at 11:46 PM worldborder-1.7.1.zip 1-click install
  • Fix an unintentional crash that occured when attempting to print out details for the reason for an intentional different crash if the config file's WorldCenter was outside of the world boundaries
  • Add more detail to logged error messages while validating config
1.7.0 worldborder 49 Jun 22nd 2025 at 8:04 PM worldborder-1.7.0.zip 1-click install

rebuild for 1.21 and net8

1.6.0 worldborder 163 Dec 12th 2024 at 11:25 PM worldborder-1.6.0.zip 1-click install
  • Better handling of the exit point when teleporting and LoopEdges is on
  • Use the rainmap height instead of the worldgen height, since it doesn't return null if the exit chunk is unloaded
1.5.4 worldborder 215 Feb 17th 2024 at 1:10 AM worldborder-1.5.4.zip 1-click install

- Don't teleport the player if they are in the very corner of the map, since they are there for an undefined period of time upon first joining a server

1.5.3 worldborder 177 Feb 3rd 2024 at 2:29 AM worldborder-1.5.3.zip 1-click install
  • Maybe stop teleporting first-time players to the corner of the map on multiplayer servers?? Waits a few extra seconds for the server to assign them a position that isn't x0z0
1.5.2 worldborder 203 Jan 20th 2024 at 4:25 AM worldborder-1.5.2.zip 1-click install
  • Logs a warning and will not start if your world spawn is outside the world border
  • Tries to load the target chunk before teleporting the player there, especially if loopedges is on
1.5.0 worldborder
1.19.0-rc.4 - 1.19.0-rc.6
203 Jan 10th 2024 at 1:36 AM worldborder-1.5.0.zip 1-click install
  • Update to 1.19
  • Add edge looping
1.4.0 worldborder 255 Dec 1st 2023 at 3:16 AM worldborder-1.4.0.zip 1-click install
  • Add support for rectangular worlds
1.3.0 worldborder 265 Aug 27th 2023 at 1:39 PM worldborder-1.3.0.zip 1-click install
  • Add an option to configure where the center of the allowed area should be. Defaults to the world spawn position
1.2.2 worldborder 232 Aug 25th 2023 at 11:10 PM worldborder-1.2.2.zip 1-click install
  • Compile for net7
  • Generate config file on startup instead of on shutdown
1.2.1 worldborder 263 May 29th 2023 at 8:22 PM worldborder-1.2.1.zip 1-click install
  • Fix players being teleported if they were above the world height
1.2.0 worldborder
1.18.3 - 1.18.5
254 May 26th 2023 at 1:10 AM worldborder-1.2.0.zip 1-click install
  • Add support for circular borders
1.1.0 worldborder 237 May 15th 2023 at 1:31 AM worldborder-1.1.0.zip 1-click install
  • Show a message when standing in a translocator that won't go anywhere
  • Add a config option to prevent translocators from picking exits outside the border
1.0.1 worldborder 248 May 13th 2023 at 9:15 PM worldborder-1.0.1.zip 1-click install
  • If the player is riding another Entity, teleport that entity instead

27 Comments (oldest first | newest first) (threaded | flat)

Shinji170981, Feb 6th at 3:09 PM (modified Feb 6th at 3:12 PM)

 

Xel I know that the mod isn't updated to the 1.22 pre-1 yet but i was trying it and it didn't crash, unless i put the config into read only, because the game removed the world border distance to "null" every time.

We want to use it on a SMP server, because we want players to restrict exploration at the start of the server, so it would help a lot, if you could get your mod to work soon.

Thaks a lot in advance for your efforts. :)

DarkMagiAkiro, Sep 5th 2025 at 9:30 AM (modified Sep 5th 2025 at 9:30 AM)

Hey, worked in single player, but not in my hoster server. No crash, just acts like it doesn't exist. 

Kara, Aug 26th 2025 at 2:31 AM

Crash for 1.21, while your mod is in!! =O

Game Version: v1.21.0 (Stable)
8/25/2025 9:29:38 PM: Critical error occurred
Loaded Mods:
System.NullReferenceException: Object reference not set to an instance of an object.
   at WorldBorder.WorldBorderModSystem.<>c__DisplayClass17_0.<StartServerSide>b__0()
   at Vintagestory.Server.ServerEventAPI.OnServerStage(EnumServerRunPhase runPhase) in VintagestoryLib\Server\API\ServerEventA
PI.cs:line 152
   at Vintagestory.Server.ServerSystemModHandler.OnBeginRunGame() in VintagestoryLib\Server\Systems\ModHandler.cs:line 112
   at Vintagestory.Server.ServerMain.EnterRunPhase(EnumServerRunPhase runPhase) in VintagestoryLib\Server\ServerMain.cs:line 6
65
   at Vintagestory.Server.ServerMain.Launch() in VintagestoryLib\Server\ServerMain.cs:line 596
   at Vintagestory.Server.ServerProgram.Main() in VintagestoryLib\Server\ServerProgram.cs:line 137
   at Vintagestory.ClientNative.CrashReporter.Start(ThreadStart start) in VintagestoryLib\Client\ClientPlatform\ClientNative\C
rashReporter.cs:line 95
Crash written to file at "Logs\server-crash.log"
Rythillian, Jun 22nd 2025 at 9:58 AM

Doesn't seem to work in 1.20.12. Going past the border does nothing.

Rythillian, Jun 22nd 2025 at 8:21 AM

Hopefully this gets updated soon..

Kara, Dec 13th 2024 at 10:44 AM

=O a 1.20 version!! i'm like the one of few people super excited <3

Kara, Feb 17th 2024 at 12:07 PM

BillyGalbreath me and Xel have been going over this bug, trying to get to the end of it =p. ive just been grabbing logs files, every time someone dies xD

BillyGalbreath, Feb 17th 2024 at 2:57 AM

Kara, spawn is always at local coordinates of 0,0. Local coordinates are what is displayed to the player in the HUD and other places. The actual coordinates do not contain any negative numbers. the farthest northwest you can go is 0,0 and the farthest southeast you can go is your world size. The default spawn point is always at or very near the center of these points. Your center tells me that you use a smaller than normal world size of 256000, so your spawn is at or near 128000,128000. You can verify this by setting a waypoint on your map and then check the server console/logs to see the coordinates in the command that was used. If you move your spawn point, it will always be 0,0 even though the actual coordinates do not change (otherwise moving spawn would make everyone's waypoints and stuff break) ;)

Kara, Feb 2nd 2024 at 2:34 AM

Xel so what happens is someone joins and it teleports them to the corner of the world. our spawn is set to 0, 0. i mean if you want to experiance it, just connect to Navarlio server xD. as far as i can tell, we arent getting any errors or crashes due to it, so it would be hard to pinpoint. 

  "WorldCenter": {
    "X": 128384,
    "Z": 128208
  },

So.... does this need to be set to X:0 and Z:0, or will that break something? this is kinda what it installed as, so i figured it was correct xD
WickedSchnitzel, Jan 20th 2024 at 8:46 AM

System.NullReferenceException: Object reference not set to an instance of an object.
at Vintagestory.Server.ServerMain.EntityPosFromSpawnPos(PlayerSpawnPos playerSpawn) in VintagestoryLib\Server\ServerMain.cs:line 1473
at Vintagestory.Server.ServerMain.get_DefaultSpawnPosition() in VintagestoryLib\Server\ServerMain.cs:line 1385
at WorldBorder.WorldBorderModSystem.<>c__DisplayClass16_0.b__0()
at Vintagestory.Server.ServerEventAPI.OnServerStage(EnumServerRunPhase runPhase) in VintagestoryLib\Server\API\ServerEventAPI.cs:line 141
at Vintagestory.Server.ServerSystemModHandler.OnBeginRunGame() in VintagestoryLib\Server\Systems\ModHandler.cs:line 82
at Vintagestory.Server.ServerMain.EnterRunPhase(EnumServerRunPhase runPhase) in VintagestoryLib\Server\ServerMain.cs:line 624
at Vintagestory.Server.ServerMain.Launch() in VintagestoryLib\Server\ServerMain.cs:line 558
at Vintagestory.Server.ServerProgram.Main() in VintagestoryLib\Server\ServerProgram.cs:line 123
at Vintagestory.ClientNative.CrashReporter.Start(ThreadStart start) in VintagestoryLib\Client\ClientPlatform\ClientNative\CrashReporter.cs:line 93

1.5.2 on 1.19.1 using PlainsandValleys (not sure if that mod is the cause though)

Xel , Jan 20th 2024 at 4:27 AM

Is the WorldCenter option reasonably close to the world spawn location? For a 50k world the center would be x25000, z25000

Kara, Jan 18th 2024 at 8:30 AM

so... for some reason when new players join the world, it places them in the corner of the world. for us, its 50k x 50k. drops them from a high hight and they die/ rage quit. no errors, so i have nothing i can really report other then this error. 

MarcAFK, Nov 24th 2023 at 12:14 PM

I have some very specific worldgen requirements that made me use this mod in ways it isnt intended for and am now being spammed with errors, so I'll ask for a feature request , do you think it would be possible to designate a range of coords for the map rather than being a set radius?

For square borders anyway, it would allow using the mod in unusual rectangular world shapes, without getting out of bounds errors from the border trying to check chunks that are outside the map itself.
My particuar scenario was the following, i wanted to limit players to a reasonable world area, say 25kx25k, but as VS was updated expand the playable area to the west or perhaps the east allowing new chunks to form, border areas i could pregenerate and smooth using the ocean to hide irregularities.
But generating an irregular rectangular world with this, and having even a little bit of the border region overlapping the world size gives constant errors thus:
24.11.2023 21:49:18 [Notification] Tried to get block outside generating chunks! Set RuntimeEnv.DebugOutOfRangeBlockAccess to debug.

I would appreciate any time spent looking at this, if its even possible.

BoolyStudy, Nov 14th 2023 at 7:08 PM

You could create a mod to pregenerate chunks of a server, similar to a minecraft plugin in spigot

MarcAFK, Nov 11th 2023 at 12:21 PM

This is great. I can create a large world then restrict the size with a border and slowly expand the map every update

Nikwuh, Aug 28th 2023 at 9:54 AM

Thanks for creating and updating the mod!, now an official mod for The Atlas Civilizations!

Junrall, Aug 27th 2023 at 4:32 PM

Rythillian That would be unfortunate! I remember that plugin for mc... I believe it did a safety check at the new location. If the spot wasn't safe to spawn into or didn't have sky above, then the mod would test for the next clear location above the first.

Rythillian, Aug 27th 2023 at 2:15 PM

Junrall There was a plugin for mc that would do that, no clue how it would fare in VS or what would happen if the other side of the world happens to be the inside of a mountian..

Junrall, Aug 27th 2023 at 3:36 AM

How about an option that teleports the player to the oposite side of the map.... as if the player walked around a globe.

Rythillian, Aug 26th 2023 at 12:56 AM

Glad to see this updated for net7!

Nikwuh, Aug 25th 2023 at 7:16 AM

Xel The World Border config file is not created after server Re start , Even with stop/start command does not generates

DasPrinzip, May 15th 2023 at 7:18 AM

@Xel thanks

@Rythillian thats true, in an existing map the mod makes sense

Xel , May 15th 2023 at 2:59 AM

DasPrinzip This mod can be used to stop players from walking right up to the edge of the world, or to keep players near the center of a larger world to avoid generating extra chunks

Rythillian, May 15th 2023 at 2:58 AM

You can't change world size after creation in vanilla DasPrinzip

DasPrinzip, May 14th 2023 at 10:32 AM

maybee i did not understand, wouldn't it be easier to reduce the size of the world?

DanaCraluminum, May 14th 2023 at 10:08 AM

Make translocators don't teleport if end translocator is outside of border

Rythillian, May 14th 2023 at 4:33 AM

Holy shit I had been looking for someone to make a mod like this and nobody wanted to take up the task. Fantastic work!