SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedQuality of life & UI

Custom Map Regions

by cooli2 · for Vintage Story

Give names to entire areas on your map with user drawn regions!

3.4KDownloads
1.21.6Latest game version
Vintage Story ModDBSource

About Custom Map Regions

From Vintage Story ModDB

Give names to entire areas on your map with user drawn regions!

Do you wanna give a name to that cool valley? Or maybe deliniate the extent of your kingdom?

Then this mod is for you!

With this mod you can draw custom regions on the map and give them names! Perfect for explorers that would like to name their newly found vistas!
There are 32 different fill patterns for the regions, and all the colors that waypoints use, for you to customize your regions!

The mod works standalone on the client-side, even in servers that don't have the mod, or in multiplayer sharing the regions with the server for other players to see!

Want to use it in multiplayer? Well, now you can!

The mod was made to allow local or server synced play!

  • Local First - If the server doesn't have the mod, this mod stores your information locally, allowing you to make your own regions on any server!
  • Server Syncing if available - If the server has the mod, the server stores the regions and allows every player to contribute to naming the land!
    Every action is also server authored in this case, meaning that server admins can give or remove privileges related to regions, and even change others players regions, to curtail any abuse that could happen.

Post development roadmap

This mod's core feature are already in place, but some features are still "good to have's" that might one day be implemented:

  1. Possibility for players to add their own custom fill patterns through a simple upload to a folder
  2. Region borders, and their customization
  3. Custom fill scaling

How use create and draw regions?

A new map layer tab was added.
To use the new map layer all keybinds use Shift.

  1. To create a new region do Shift + Right Mouse Click with no selected region.
  2. To select a region do Shift + Left Mouse Click. Selected regions blink white.
  3. To expand the selected region do Shift + Right Mouse Click (can be dragged).
  4. To clear regions do Shift + Ctrl + Right Mouse Click (can be dragged).
  5. To edit a region do Shift + Right Mouse Click on top of a region, when there is no selected region.

 

There is also a GUI to the left of the map that tweaks some effects of the regions controls:

  1. Transparency - Adjust the overlay transparency of the fill of the regions. Nameplates still appear at full opacity
  2. Brush Size - Adjust the brush size for drawing/errasing region chunks
  3. Lock Region - When lock region is selected, you can override other regions when drawing, and you cant errase chunks of regions you dont have selected.

Client Console Commands

  1. .regionmap redraw - Forces the map to redraw

How does the server side work?

The server side only has a processing server, that receives player region requests, validates them based on player privileges and roles, and then either accepts the requests, saves them to disk and shares them with other players, or rejects the requests and they dont take effect.

The server side is fully server authored, meaning, the server has the last say if any change to regions is accepted or not. More than this, players with higher permission levels (admins and mods) can change regions of lower permission ones. This is to curtail abuse of a player generated content system.

By default, only the admins of the server can create regions, if you want the players to also create regions just give them the privileges (either each player or the entire role)

How to give region privileges to players?

If you are a server admin and want to give privileges to all players, there are two ways to do it:

  1. Change serverconfig.json - in your server's serverconfig.json there is a Roles list. The default role is the suplayer. You can add the region's basic privileges to the list of privileges of suplayer's and then restart the server. This way you add privileges to the default role of normal players, even new ones will have this privilege
  2. Use the command /regions role - you can use the /regions role subcommand to give basic privileges to a certain role. This however required all players of that role to relog and in testing it wasnt permanent change, only lasting the current server session. This if the server goes down you have to use the command again (a solutions to this needs to be discovered)
  3. Use the command /regions player - you can use the /regions players subcommand to give basic privileges to certain players. This change is permanent and is useful for small closed servers.
  4. Use vintage stories /role or /player commands - you can also just use /role and /player privilege subcommands to grant privileges. The reason to prefer this mods commands over vintagestory's is that they do the same, but vintagestory's can't give all 5 privileges at the same time, meaning you have to write the same command 5 times.

How does server validation work?

When the server receives a request, it validates if the request is allowed to be executed. This was added to avoid griefers and trolls from overriding other peoples regions, and for moderators and admins to correct regions that dont follow server rules. It also makes it more difficult for tampering with the mod's code to allow clients to send ilegal requests.

The validation follows the following steps:

Read the full description on Vintage Story ModDB →

Highlights

From source data

Game versions

Supports 13 Vintage Story versions, the newest being 1.21.6.

Footprint

Rated a light load on a server.

Custom Map Regions on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run Custom Map Regions on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “Utility”

Quality of life & UI

Small conveniences, tweaks and interface improvements players notice straight away.

Runs on your server

From source side support

Vintage Story ModDB lists Custom Map Regions as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.21.6 and 12 earlier

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
  • ✓Authorcooli2, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

Custom Map Regions, answered

Generated from the mod’s own source data.

Do my players need to install Custom Map Regions?

Vintage Story ModDB lists Custom Map Regions as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. Custom Map Regions is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Custom Map Regions on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Custom Map Regions in one click.