AwesomeKeycards lets you turn any item into a digital keycard, lock interactive block.
AwesomeKeycards
Author: NeonDev
Platform: PaperMC 1.21.8
Language: Kotlin (2.3.0-Beta2) using Gradle + Shadow + run-paper.
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 and embeds a unique ID plus vanity label. - 🚪 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, orteam <name>keys to match open-access lobbies or scoreboard-managed squads. - 🎨 Visual feedback – particles + sounds signal successful locks/unlocks and GUI-style sfx reinforce keycard management actions.
- 💾 Persistent storage – locks saved to
locks.yml, cards + ACL tokeycards.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.
Commands
| Command | Permission | Description |
|---|---|---|
/keycard create <label> |
awesomekeycards.admin |
Converts the held item into a labeled keycard. |
/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 <player> |
awesomekeycards.access |
Revokes access for a player. |
/keycard access list |
awesomekeycards.access |
Lists everyone who can use the current keycard. |
/keycard view |
awesomekeycards.access |
Displays owner, scope, and sharing details for the held keycard. |
Hold the keycard item in your main hand before running any command.
By defaultawesomekeycards.adminis OP-only, whileawesomekeycards.accessis granted to all players so they can manage their own cards.
Supported Blocks
- All doors, trapdoors, fence gates, and buttons (via Bukkit tags).
- Utility blocks: levers, barrels, chests (normal & trapped), furnaces, smokers, blast furnaces, droppers, dispensers, hoppers, shulker boxes (all colors).
- When locking double-doors, aim at the lower half; the plugin normalizes coordinates so both halves stay linked.
Keycard Types
- Personal – default behavior. Owner plus manually shared UUIDs can operate linked blocks.
- Global –
/keycard create global <label>lets every player interact with blocks locked to that key (great for spawn doors that still log activity). - Team –
/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.
Use /keycard view while holding a card to confirm its scope, owner, and share list before distributing copies.
Special thanks to ProbNotAFemboy fro being who he is <3
Information
| Category | Role Playing |
|---|---|
| Published on | November 9, 2025 |
| License | Unspecified |
| Downloads | 9 |
| Stars | 0 |
| Watchers | 0 |
Pages
Members