MapLock

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

✨ 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) with auto-detection.
• 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.

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

• Place MapLock.jar into your server's plugins folder.
• (Optional) If using economy features, ensure Vault and a compatible economy plugin (e.g., CMI, EssentialsX) are installed.
• Restart the server.
• 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:

• Report Issues: Submit bugs via the GitHub Issues page.
• Feature Requests: Suggest new ideas (e.g., Item Frame protection, Database support).
• 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 授權協議。