{"id":24200,"date":"2026-06-01T11:13:38","date_gmt":"2026-06-01T08:13:38","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/"},"modified":"2026-06-01T11:13:38","modified_gmt":"2026-06-01T08:13:38","slug":"awesomekeycards","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/","title":{"rendered":"AwesomeKeycards"},"content":{"rendered":"<p># AwesomeKeycards<\/p>\n<p>**Author:** NeonDev<br \/>\n**Platform:** PaperMC 1.21.8<br \/>\n**Language:** Kotlin (2.3.0-Beta2) using Gradle + Shadow + run-paper.<br \/>\n**Version:** 1.4.1<\/p>\n<p>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.<\/p>\n<p>&#8212;<\/p>\n<p>## Feature Highlights<\/p>\n<p>&#8211; \ud83d\udd10 **Custom-labeled keycards** \u2013 `\/keycard create [global|team <team>] <label>` converts the held item with a unique ID, plus optional color\/style\/auto-close\/double\/notify\/cooldown presets.<br \/>\n&#8211; \ud83d\udeaa **Block locking** \u2013 lock doors, trapdoors, fence gates, buttons, chests, barrels, furnaces, shulkers, etc. Only matching keycards (or shared users) can interact.<br \/>\n&#8211; \ud83d\udc65 **Shareable access** \u2013 card owners can grant or revoke access via `\/keycard access add\/remove\/list`, perfect for roommates or faction mates.<br \/>\n&#8211; \ud83e\udde9 **Flexible key types** \u2013 create personal (default), `global`, or `team <name>` keys to match open-access lobbies or scoreboard-managed squads.<br \/>\n&#8211; \ud83c\udf9b\ufe0f **Command presets** \u2013 set accent color, effect style, auto-close timer, double-door sync, owner alerts, and cooldown defaults right on the `create` command.<br \/>\n&#8211; \ud83d\udce6 **Admin vault** \u2013 `\/keycard vault` lists every keycard with quick cloning and revoke options that also clean up locks.<br \/>\n&#8211; \ud83d\udc41\ufe0f **Lock inspection** \u2013 shift-right-click a locked block with any keycard to see its linked key, owner, and a copyable ID (admins only).<br \/>\n&#8211; \ud83d\udeaa **Door customization** \u2013 `\/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.<br \/>\n&#8211; \ud83c\udf08 **Style presets** \u2013 pick classic, stealth, or spark effects per lock to change particle colors and sounds.<br \/>\n&#8211; \ud83d\udd14 **Owner alerts** \u2013 optional pings when someone uses your lock, throttled to avoid spam.<br \/>\n&#8211; \u23f1\ufe0f **Use cooldowns** \u2013 rate-limit rapid spam on doors or buttons with a per-lock delay.<br \/>\n&#8211; \ud83e\uddfe **Door status HUD** \u2013 instant summary of the targeted lock\u2019s nickname and toggles via `\/keycard door status`.<br \/>\n&#8211; \ud83d\uddc2\ufe0f **Config clipboard** \u2013 copy\/paste lock settings between doors to set up bases quickly.<br \/>\n&#8211; \ud83c\udfa8 **Visual feedback** \u2013 particle trails + jingles on lock\/unlock and a subtle denied tone when access is blocked.<br \/>\n&#8211; \ud83d\udcbe **Persistent storage** \u2013 locks saved to `locks.yml`, cards + ACL to `keycards.yml`, ensuring safety across restarts.<br \/>\n&#8211; \u2699\ufe0f **Fine-grained permissions** \u2013 admin-only workflow for creating\/locking, but anyone with the access permission can manage sharing for their own cards.<br \/>\n&#8211; \ud83e\udde0 **Team watchdog** \u2013 optional allow\/deny lists plus automatic pruning of team keys tied to removed teams keep ACLs clean.<br \/>\n&#8211; \ud83d\udcdc **Audit log** \u2013 `\/keycard audits` tail recent lock\/unlock attempts with player, key short ID, and location.<\/p>\n<p>&#8212;<\/p>\n<p>## Commands<\/p>\n<p>| Command                                                                                                                                                               | Permission                                                         | Description                                                                                                         |<br \/>\n|&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8211;|&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8211;|&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;|<br \/>\n| `\/keycard create [global\/team <team>] <label> [color=<name>] [style=<preset>] [autoclose=<seconds\/off>] [double=<on\/off>] [notify=<on\/off>] [cooldown=<seconds\/off>]` | `awesomekeycards.admin` | Converts the held item into a labeled keycard with optional defaults for future locks. |<br \/>\n| `\/keycard lock`                                                                                                                                                       | `awesomekeycards.admin`                                            | Links the held keycard to the block you are looking at (6 block reach).                                             |<br \/>\n| `\/keycard unlock`                                                                                                                                                     | `awesomekeycards.admin`                                            | Unlocks a block if you hold the linked keycard.                                                                     |<br \/>\n| `\/keycard access add <player>`                                                                                                                                        | `awesomekeycards.access`                                           | Grants another player the ability to use the current keycard.                                                       |<br \/>\n| `\/keycard access remove <player>`                                                                                                                                     | `awesomekeycards.access`                                           | Revokes access for a player.                                                                                        |<br \/>\n| `\/keycard access list`                                                                                                                                                | `awesomekeycards.access`                                           | Lists everyone who can use the current keycard.                                                                     |<br \/>\n| `\/keycard view`                                                                                                                                                       | `awesomekeycards.access`                                           | Displays owner, scope, and sharing details for the held keycard.                                                    |<br \/>\n| `\/keycard door <status\/autoclose\/double\/notify\/cooldown\/style\/nickname\/copy\/paste>`                                                                                   | `awesomekeycards.access` (owner or admin)                          | Customize the targeted locked block: timers, double-door syncing, alerts, styles, nicknames, and clipboard actions. |<br \/>\n| `\/keycard vault [page]`                                                                                                                                               | `awesomekeycards.admin`                                            | Browse all stored keycards, clone them, or revoke + clean locks.                                                    |<br \/>\n| `\/keycard audits [player] [count]`                                                                                                                                    | `awesomekeycards.admin`                                            | Show the most recent audit lines; defaults to 10 entries.                                                           |<\/p>\n<p>> Hold the keycard item in your main hand before running any command.<br \/>\n> By default `awesomekeycards.admin` is OP-only, while `awesomekeycards.access` is granted to all players so they can manage their own cards.<\/p>\n<p>Example: `\/keycard create global Lobby color=gold style=sparks autoclose=5 double=off notify=on cooldown=3`<\/p>\n<p>&#8212;<\/p>\n<p>## Supported Blocks<\/p>\n<p>&#8211; All **doors**, **trapdoors**, **fence gates**, and **buttons** (via Bukkit tags).<br \/>\n&#8211; Utility blocks: levers, barrels, chests (normal &#038; trapped), furnaces, smokers, blast furnaces, droppers, dispensers, hoppers, shulker boxes (all colors).<br \/>\n&#8211; When locking double-doors, aim at the lower half; the plugin normalizes coordinates so both halves stay linked and, if enabled, will sync open\/close on both sides.<\/p>\n<p>&#8212;<\/p>\n<p>## Keycard Types<\/p>\n<p>&#8211; **Personal** \u2013 default behavior. Owner plus manually shared UUIDs can operate linked blocks.<br \/>\n&#8211; **Global** \u2013 `\/keycard create global <label>` lets every player interact with blocks locked to that key (great for spawn doors that still log activity).<br \/>\n&#8211; **Team** \u2013 `\/keycard create team <teamName> <label>` ties the lock to a vanilla scoreboard team (`\/team add Guards`). Any member of that team can open the block without needing the physical item.  <\/p>\n<p>Use `\/keycard view` while holding a card to confirm its scope, owner, and share list before distributing copies.<\/p>\n<p>&#8212;<\/p>\n<p>## Door Customization (no admin needed)<\/p>\n<p>Owners (or admins) looking at a locked block can run `\/keycard door &#8230;`:<br \/>\n&#8211; `status` \u2013 show nickname plus all toggles for the targeted lock.<br \/>\n&#8211; `autoclose <seconds|off>` \u2013 close doors\/fence gates\/trapdoors automatically after a delay.<br \/>\n&#8211; `double <on|off>` \u2013 open\/close both halves of a double door together.<br \/>\n&#8211; `notify <on|off>` \u2013 ping the owner when others use the lock (throttled).<br \/>\n&#8211; `cooldown <seconds|off>` \u2013 add a short delay to prevent spammy toggling.<br \/>\n&#8211; `style <classic|stealth|sparks>` \u2013 change particles\/sounds per lock.<br \/>\n&#8211; `nickname <name|off>` \u2013 friendly label shown in status\/alerts.<br \/>\n&#8211; `copy` \/ `paste` \u2013 clone all these settings between locks to set up bases quickly.<\/p>\n<p>Defaults you set on `\/keycard create` (color, style, auto-close, double-door, alerts, cooldown) are saved on the keycard and applied to locks the next time you link that card to a block.<br \/>\nAll customization uses the `awesomekeycards.access` permission (default true) and only requires owning the key, not server admin.<\/p>\n<p>&#8212;<\/p>\n<p>## Configuration<\/p>\n<p>&#8211; `teamAccess.allow` \/ `teamAccess.deny` (lists) gate which scoreboard teams can be used for team keycards; leave `allow` empty to allow all by default.<br \/>\n&#8211; `teamAccess.watchdogIntervalTicks` controls how often stale\/blocked team keycards are pruned.<br \/>\n&#8211; Audit logs are written to `plugins\/AwesomeKeycards\/audit.log` and can be tailed in-game with `\/keycard audits`.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>AwesomeKeycards lets you turn any item into a digital keycard, lock interactive blocks, and share access with trusted players.<\/p>\n","protected":false},"featured_media":24201,"template":"","meta":{"_minecraft_slug":"awesomekeycards","_minecraft_project_id":"2dUJBTOq","_minecraft_author":"NeonDev","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":182,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"awesomekeycards.zip","_minecraft_size_bytes":8949749,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T12:55:48.829806Z","_minecraft_date_created":"2025-11-13T00:21:43.569568Z","_minecraft_date_modified":"2025-12-26T19:50:18.604498Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/awesomekeycards","_minecraft_icon_attachment_id":24201,"_minecraft_imported_at":"2026-06-01T08:13:39+00:00","_minecraft_import_hash":"f39bed2b842c2c0ec3be53704d2ba269","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,91,92],"mod_loader":[132],"minecraft_version":[81],"class_list":["post-24200","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-storage","mod_category-utility","mod_loader-paper","minecraft_version-1-21-8"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>AwesomeKeycards - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AwesomeKeycards - Minecraft\" \/>\n<meta property=\"og:description\" content=\"AwesomeKeycards lets you turn any item into a digital keycard, lock interactive blocks, and share access with trusted players.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/awesomekeycards\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/awesomekeycards\\\/\",\"name\":\"AwesomeKeycards - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/awesomekeycards\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/awesomekeycards\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/awesomekeycards-icon-8edcefe398c980bddbc510a79b0d63d8effc1ef9_96.webp\",\"datePublished\":\"2026-06-01T08:13:38+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/awesomekeycards\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/awesomekeycards\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/awesomekeycards\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/awesomekeycards-icon-8edcefe398c980bddbc510a79b0d63d8effc1ef9_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/awesomekeycards-icon-8edcefe398c980bddbc510a79b0d63d8effc1ef9_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/awesomekeycards\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"AwesomeKeycards\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"AwesomeKeycards - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/","og_locale":"en_US","og_type":"article","og_title":"AwesomeKeycards - Minecraft","og_description":"AwesomeKeycards lets you turn any item into a digital keycard, lock interactive blocks, and share access with trusted players.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/","name":"AwesomeKeycards - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/awesomekeycards-icon-8edcefe398c980bddbc510a79b0d63d8effc1ef9_96.webp","datePublished":"2026-06-01T08:13:38+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/awesomekeycards-icon-8edcefe398c980bddbc510a79b0d63d8effc1ef9_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/awesomekeycards-icon-8edcefe398c980bddbc510a79b0d63d8effc1ef9_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/awesomekeycards\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"AwesomeKeycards"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/24200","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/24201"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=24200"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=24200"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=24200"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=24200"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}