LockMap

A lightweight server-side mod that allows you to lock map items and prevent any modifications

# LockMap

A lightweight server-side mod for that allows you to lock map items and prevent any modifications.

No client installation required – works fully on the server.

Features

• Lock maps to prevent:
• Copying in the Cartography Table
• Copying in the Crafting Table
• Renaming in the Anvil
• Unlock maps to restore normal behavior
• Optional map info (owner and date) shown in item lore
• Works per-map using simple commands
• Server-side only

Config

(`/config/lockmap.json` file)

{
  "showOwner": true,
  "showDate": true,
  "dateFormat": "dd.MM.yyyy",
  "timeFormat": "HH:mm:ss"
}

Commands

• `/map lock`

Locks the map in your main hand

• `/map unlock`

Unlocks the map in your main hand

• `/map config update in-hand`

Updates the lore only for the map in hand

• `/map config update all`

Updates all blocked maps, but with one important limitation – only the following maps are updated:

• in players’ inventories
• in players’ Ender chests

Requirements:

• You must hold a filled map (except `/map config update all`)
• Requires permission level 2 (OP)

How It Works

When a map is locked:

• Special data is written into the item
• The mod blocks interactions that would modify the map
• (Optional) adds lore with:
• Owner name
• Lock date

When unlocked:

• All restrictions are removed

Installation

1. Install Fabric Loader
2. Install Fabric API
3. Place the mod `.jar` into your server `mods` folder
4. Start the server

Compatibility

• Minecraft: 1.21.10
• Fabric Loader: 0.16.0+
• Server-side only (when the mod is installed on the server, do NOT need to install it on the client; however, even if the mod is installed on the client, it will work as usual without the server)

Notes

• Only affects filled maps
• Each map is handled individually
• Safe to use on existing worlds

License

CC BY-NC-ND 4.0