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.2

✨ Features

* Tab Completion: Prevents locked maps from being cloned in Crafting Tables or Cartography Tables. * Tab Completion: Built-in support for Traditional Chinese (`zh_tw`), Simplified Chinese (`zh_cn`), and English (`en`). * Tab Completion: Supports Tab Completion economy bridge; set custom processing fees for locking maps. * Tab Completion: Require specific items (supports custom Name and Lore checks) to be consumed for map locking. * Tab Completion: Provides detailed map info queries and administrative force-unlock features. * Tab Completion: 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 Info

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)

```yaml

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.

Vault 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. Localization: Submit bugs via the GitHub Localization page. 2. Localization: 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 Andy (AI Partner) and Andy.

---

⚖️ 授權 (License)

本專案採用 MIT 授權協議。