Mods / Claims Map

Tags:
Utility QoL Claims Client Mapping Map Clientside
Author:
ExUriel
Side:
Client
Created:
May 3rd at 3:03 AM
Last modified:
May 19th at 3:36 AM
Downloads:
1441
Latest release (for Vintage Story 1.22.0-pre.1 - 1.22.2, potentially outdated):
claimmap-v1.3.0-exuriel.zip  1-click install

Claims Map adds a land claims overlay to your world map and minimap. Every claim on the server renders as a coloured rectangle so you can see at a glance who owns what. Hover any claim for full details without leaving the map.

Features

  • All Features are fully Configurable from ModConfig/claimmap.json.
  • Land claims update in real time without requiring client or server to restart.
  • Land claims render as semi-transparent coloured rectangles on both the world map and minimap.
  • Each player's claims use a unique colour derived from their player ID, consistent across sessions and servers.
  • Your own claims highlight in a distinct configurable (by default, gold) colour.
  • Hover any claim to see the owner name and start/end coordinates, adjusted to match the in-game display.
  • Hover your own claim to see which players and groups have access, along with their permission level (Build, Use, Traverse).
  • Claims who has permissions open to everyone show a line listing what everyone is permitted to do.
  • When installed server-side, the server pushes and enforces its config to every connecting client.
  • Trader and Story locations are hidden.

Configuration

The config file is auto-generated at ModConfig/claimmap.json on first run with comments explaining each option.

  • Disabled (true/false: defaults to false) disables the mod entirely without uninstalling it.
  • ShowOwnClaimHighlighted (true/false: defaults to true) highlights your own claims in gold instead of the standard owner colour.
  • ShowOnlyOwnClaims  (true/false: defaults to false) hides all claims except your own.
  • ShowOnMinimap (true/false: defaults to true) toggles the minimap overlay independently from the world map.
  • ShowCoordinates (true/false: defaults to true) shows or hides the start/end coordinate line in the hover tooltip.
  • ShowClaimDescription (true/false: defaults to true) shows or hides the claim title in the hover tooltip.
  • ShowPermissions (true/false: defaults to true) shows or hides player, group, and public permissions in the hover tooltip.
  • OwnClaimColor — (string: defaults to "#CC8800" - a deepish gold )hex colour for your own claim highlight color.
  • FillAlpha — (float: defaults to 0.25 ) transparency of the claim's interior color, from 0.0 to 1.0.
  • BorderAlpha — (float: defaults to 0.75) transparency of the claim's border color, from 0.0 to 1.0.

Compatibility

  • Side: Universal. Clients do not need the mod installed; server installation enables config sync only.
  • Required on client: No
  • Required on server: No
  • No known conflicts with other mods.




Disclaimer

AI assistance was used during development to research the Vintage Story codebase. All design decisions, code implementation, artwork, and screenshots are my own or other accredited peoples work.

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.3.0 claimmap
1.22.0-pre.1 - 1.22.2
1438 May 19th at 3:36 AM claimmap-v1.3.0-exuriel.zip 1-click install

v1.3.0
- Added a toggle to disable the mod entirely
- Added an option to show only your own claims
- Added a toggle to control the minimap overlay separately from the world map
- Added toggles to show or hide coordinates, the claim title, and permissions in the tooltip
- Config file is now auto-generated on first run with inline comments

v1.2.0
- Server admins can now push their config to connecting clients, overriding local settings for the session
- Mod can now be installed server-side

v1.1.4
- Added a config option to set a custom colour for your own claims

v1.1.3
- Renamed the mod to Claims Map

v1.1.2
- Hovering your own claim now shows permitted groups and players with their access level
- Claims open to everyone now show a public access line

v1.1.1
- Fixed large claims not rendering on the minimap

v1.1.0
- Added opacity controls for claim fills and borders
- Clients own claims now highlight in gold instead of the standard colour
- Fixed render issues with unnormalized claim areas
- Fixed hover tooltip dropping claims when a player owns multiple

1.0.8 territorymap
3 May 3rd at 3:15 AM Release Retracted

Retraction Reason:

Version had a memory leak.

Changelog:

  • Initial release: "Land Claims" map layer with player UUID derived, colored rectangles for player claims and Hover tooltip.

  • Hover tooltip displays full claim bounds (XYZ 1→ XYZ 2), name of claim & owner name.

  • Showing trader & other non player claims disabled by default.

1 Comment (oldest first | newest first) (threaded | flat)

YangWenLi, May 19th at 11:21 AM

Fantastic work, a very useful mod