—<\/p>\n
# MapLock \ud83d\uddfa\ufe0f \ud83d\udd12<\/p>\n
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.<\/p>\n
* **Tested Versions:** 1.8.8 ~ 26.1.2<\/p>\n
## \u2728 Features<\/p>\n
* **Map Locking System**: Prevents locked maps from being cloned in Crafting Tables or Cartography Tables.
\n* **Multilingual Support**: Built-in support for Traditional Chinese (`zh_tw`), Simplified Chinese (`zh_cn`), and English (`en`).
\n* **Economy Integration**: Supports **Vault** economy bridge; set custom processing fees for locking maps.
\n* **Custom Item Consumption**: Require specific items (supports custom Name and Lore checks) to be consumed for map locking.
\n* **Admin Tools**: Provides detailed map info queries and administrative force-unlock features.
\n* **Granular Permissions**: Every command and privilege has a corresponding permission node for easy management.
\n* **Tab Completion**: Full auto-complete support for all commands for a smoother user experience.<\/p>\n
### Map Lock
\n
\n### Map Info
\n
\n### Prevent map copying
\n<\/p>\n
## \ud83d\udee0\ufe0f Commands & Permissions<\/p>\n
| Command | Description | Default | Permission Node |
\n| — | — | — | — |
\n| `\/map help` | Show the help menu | Everyone | `maplock.help` |
\n| `\/map lock` | Lock the map in your main hand | Everyone | `maplock.lock` |
\n| `\/map unlock` | Unlock a map that you own | Everyone | `maplock.unlock` |
\n| `\/map admin info` | Check map owner and lock date | OP | `maplock.admin.info` |
\n| `\/map admin forceunlock` | Forcefully unlock any map | OP | `maplock.admin.forceunlock` |
\n| `\/map admin reload` | Reload config and language files | OP | `maplock.admin.reload` |<\/p>\n
### \ud83d\udca1 Extra Privileges<\/p>\n
* `maplock.admin.bypass`: Allows the user to bypass “Disabled World” restrictions and lock maps for free (no economy\/item cost).<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Place `MapLock.jar` into your server’s `plugins` folder.
\n2. (Optional) If using economy features, ensure **Vault** and a compatible economy plugin (e.g., CMI, EssentialsX) are installed.
\n3. Restart the server.
\n4. Adjust your settings in `plugins\/MapLock\/config.yml`.<\/p>\n
## \u2699\ufe0f Configuration Preview (config.yml)<\/p>\n
“`yaml
\n# Language setting (Supported: en, zh_tw, zh_cn)
\nlanguage: “en”<\/p>\n
# List of worlds where MapLock features are disabled
\ndisabled-worlds:
\n – “disabledworlds1”
\n – “disabledworlds2”<\/p>\n
# Locking fee (Requires Vault and a functional economy plugin)
\neconomy:
\n enabled: false
\n cost: 0.0<\/p>\n
# Item-based locking cost
\nitem-cost:
\n enabled: false
\n material: “DIAMOND”
\n amount: 1
\n # Name shown in notification messages (e.g., when a player has insufficient items)
\n display-name: “Map Lock Voucher”<\/p>\n
# === Advanced Item Verification ===
\n # Should the plugin strictly check the item’s Name and Lore?
\n # If set to false, only the material type (e.g., DIAMOND) will be checked.
\n strict-meta-check: true<\/p>\n
# The item must match this display name exactly (Supports & color codes. Leave as “” to disable)
\n required-name: “&bMap Lock Voucher”<\/p>\n
# The item must contain the following Lore (Supports & color codes. Leave as [] to disable)
\n required-lore:
\n – “&7A special voucher”
\n – “&7used to protect your map art.”<\/p>\n
“`<\/p>\n
—<\/p>\n
## \u2753 FAQ<\/p>\n
**Q: Why do command hints show “Missing” after an update?**
\nA: 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.<\/p>\n
**Q: Why is map locking free even though I set a cost?**
\nA: 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.<\/p>\n
**Q: Can I make map locking free?**
\nA: Yes, set `cost` to `0.0` in `config.yml` or simply set `economy.enabled` to `false`.<\/p>\n
—<\/p>\n
## \ud83e\udd1d Contributing<\/p>\n
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.**<\/p>\n
If you have ideas or find bugs, feel free to contribute:<\/p>\n
1. **Report Issues**: Submit bugs via the GitHub Issues page.
\n2. **Feature Requests**: Suggest new ideas (e.g., Item Frame protection, Database support).
\n3. **Localization**: Translations for languages other than Chinese and English are highly welcome via Pull Requests!<\/p>\n
—<\/p>\n
## \ud83e\udd16 About the Developer<\/p>\n
This plugin was co-created by **Gemini** (AI Partner) and **Andy**.<\/p>\n
—<\/p>\n
## \u2696\ufe0f \u6388\u6b0a (License)<\/p>\n
\u672c\u5c08\u6848\u63a1\u7528 **MIT \u6388\u6b0a\u5354\u8b70**\u3002
\n<\/p>\n","protected":false},"excerpt":{"rendered":"
Lock your map art.<\/p>\n","protected":false},"featured_media":98290,"template":"","meta":{"_minecraft_slug":"maplock-andy","_minecraft_project_id":"8MBcSvQi","_minecraft_author":"ava852546","_minecraft_license":"MIT","_minecraft_downloads":27,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"maplock-andy.zip","_minecraft_size_bytes":92908,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T22:20:02.771862Z","_minecraft_date_created":"2026-03-12T21:02:45.477015Z","_minecraft_date_modified":"2026-04-01T12:57:21.559937Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/maplock-andy","_minecraft_icon_attachment_id":98290,"_minecraft_imported_at":"2026-06-05T15:26:18+00:00","_minecraft_import_hash":"2f36220fc6be0a9282a61da951d3ebc4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,125,89,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,30,31,860,861,862,863,864,83,167,163],"class_list":["post-98289","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n