?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
MapLock

MapLock

Lock your map art.

24
0
24
0

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
1.12.x
1.11.x
1.10.x
1.9.x
1.8.8–1.8.9

Platforms

Links

Report issues View source Visit wiki

Tags

Creators

Details

Licensed MIT
Published 2 months ago

MapLock 🗺️ 🔒

A lightweight map protection plugin designed for Minecraft servers. It prevents unauthorized cloning of your map art and supports custom economic costs and multi-language settings.

  • Tested Versions: 1.8.8 ~ 26.1.2

✨ Features

  • Map Locking System: Prevents locked maps from being cloned in Crafting Tables or Cartography Tables.
  • Multilingual Support: Built-in support for Traditional Chinese (zh_tw), Simplified Chinese (zh_cn), and English (en).
  • Economy Integration: Supports Vault economy bridge; set custom processing fees for locking maps.
  • Custom Item Consumption: Require specific items (supports custom Name and Lore checks) to be consumed for map locking.
  • Admin Tools: Provides detailed map info queries and administrative force-unlock features.
  • Granular Permissions: Every command and privilege has a corresponding permission node for easy management.
  • Tab Completion: Full auto-complete support for all commands for a smoother user experience.

Map Lock

Map Lock

Map Info

Map Info

Prevent map copying

Prevent map copying

🛠️ Commands & Permissions

Command Description Default Permission Node
/map help Show the help menu Everyone maplock.help
/map lock Lock the map in your main hand Everyone maplock.lock
/map unlock Unlock a map that you own Everyone maplock.unlock
/map admin info Check map owner and lock date OP maplock.admin.info
/map admin forceunlock Forcefully unlock any map OP maplock.admin.forceunlock
/map admin reload Reload config and language files OP maplock.admin.reload

💡 Extra Privileges

  • maplock.admin.bypass: Allows the user to bypass "Disabled World" restrictions and lock maps for free (no economy/item cost).

📦 Installation

  1. Place MapLock.jar into your server's plugins folder.
  2. (Optional) If using economy features, ensure Vault and a compatible economy plugin (e.g., CMI, EssentialsX) are installed.
  3. Restart the server.
  4. Adjust your settings in plugins/MapLock/config.yml.

⚙️ Configuration Preview (config.yml)

# Language setting (Supported: en, zh_tw, zh_cn)
language: "en"

# List of worlds where MapLock features are disabled
disabled-worlds:
  - "disabledworlds1"
  - "disabledworlds2"

# Locking fee (Requires Vault and a functional economy plugin)
economy:
  enabled: false
  cost: 0.0

# Item-based locking cost
item-cost:
  enabled: false
  material: "DIAMOND"
  amount: 1
  # Name shown in notification messages (e.g., when a player has insufficient items)
  display-name: "Map Lock Voucher"
  
  # === Advanced Item Verification ===
  # Should the plugin strictly check the item's Name and Lore? 
  # If set to false, only the material type (e.g., DIAMOND) will be checked.
  strict-meta-check: true
  
  # The item must match this display name exactly (Supports & color codes. Leave as "" to disable)
  required-name: "&bMap Lock Voucher"
  
  # The item must contain the following Lore (Supports & color codes. Leave as [] to disable)
  required-lore:
    - "&7A special voucher"
    - "&7used to protect your map art."

❓ FAQ

Q: Why do command hints show "Missing" after an update? A: This is usually due to legacy language files. Please delete the plugins/MapLock/lang/ folder and run /map admin reload to regenerate the latest files.

Q: Why is map locking free even though I set a cost? A: Ensure economy.enabled is set to true and Vault is installed with a working economy provider. If the economy system is unavailable, the plugin may block locking actions for safety.

Q: Can I make map locking free? A: Yes, set cost to 0.0 in config.yml or simply set economy.enabled to false.

🤝 Contributing

This project is a unique experimental endeavor: The code was developed and optimized entirely by AI (Gemini) based on Andy's specific requirements and logic.

If you have ideas or find bugs, feel free to contribute:

  1. Report Issues: Submit bugs via the GitHub Issues page.
  2. Feature Requests: Suggest new ideas (e.g., Item Frame protection, Database support).
  3. Localization: Translations for languages other than Chinese and English are highly welcome via Pull Requests!

🤖 About the Developer

This plugin was co-created by Gemini (AI Partner) and Andy.

⚖️ 授權 (License)

本專案採用 MIT 授權協議。 bStats