AwesomeKeycards

# AwesomeKeycards **Author:** NeonDev **Platform:** PaperMC 1.21.8 **Language:** Kotlin (2.3.0-Beta2) using Gradle + Shadow + run-paper. **Version:** 1.4.1 AwesomeKeycards lets you turn any item into a digital keycard, lock interactive blocks, and share access with trusted players. It is designed for modern survival servers that want lightweight door/loot protection without relying on heavy land-claim systems. --- ## Feature Highlights - 🔐 **Custom-labeled keycards** – `/keycard create <label>` converts the held item with a unique ID, plus optional color/style/auto-close/double/notify/cooldown presets. - 🚪 **Block locking** – lock doors, trapdoors, fence gates, buttons, chests, barrels, furnaces, shulkers, etc. Only matching keycards (or shared users) can interact. - 👥 **Shareable access** – card owners can grant or revoke access via `/keycard access add/remove/list`, perfect for roommates or faction mates. - 🧩 **Flexible key types** – create personal (default), `global`, or `team <name>` keys to match open-access lobbies or scoreboard-managed squads. - 🎛️ **Command presets** – set accent color, effect style, auto-close timer, double-door sync, owner alerts, and cooldown defaults right on the `create` command. - 📦 **Admin vault** – `/keycard vault` lists every keycard with quick cloning and revoke options that also clean up locks. - 👁️ **Lock inspection** – shift-right-click a locked block with any keycard to see its linked key, owner, and a copyable ID (admins only). - 🚪 **Door customization** – `/keycard door` (owner, no admin perm) controls auto-close timers, double-door syncing, owner alerts, cooldowns, style presets, nicknames, and a copy/paste clipboard for fast setup. - 🌈 **Style presets** – pick classic, stealth, or spark effects per lock to change particle colors and sounds. - 🔔 **Owner alerts** – optional pings when someone uses your lock, throttled to avoid spam. - ⏱️ **Use cooldowns** – rate-limit rapid spam on doors or buttons with a per-lock delay. - 🧾 **Door status HUD** – instant summary of the targeted lock’s nickname and toggles via `/keycard door status`. - 🗂️ **Config clipboard** – copy/paste lock settings between doors to set up bases quickly. - 🎨 **Visual feedback** – particle trails + jingles on lock/unlock and a subtle denied tone when access is blocked. - 💾 **Persistent storage** – locks saved to `locks.yml`, cards + ACL to `keycards.yml`, ensuring safety across restarts. - ⚙️ **Fine-grained permissions** – admin-only workflow for creating/locking, but anyone with the access permission can manage sharing for their own cards. - 🧠 **Team watchdog** – optional allow/deny lists plus automatic pruning of team keys tied to removed teams keep ACLs clean. - 📜 **Audit log** – `/keycard audits` tail recent lock/unlock attempts with player, key short ID, and location. --- ## Commands | Command | Permission | Description | |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------| | `/keycard create <label> ` | `awesomekeycards.admin` | Converts the held item into a labeled keycard with optional defaults for future locks. | | `/keycard lock` | `awesomekeycards.admin` | Links the held keycard to the block you are looking at (6 block reach). | | `/keycard unlock` | `awesomekeycards.admin` | Unlocks a block if you hold the linked keycard. | | `/keycard access add <player>` | `awesomekeycards.access` | Grants another player the ability to use the current keycard. | | `/keycard access remove <pla