Keypad, Role & Permission System 🔐

Create role-based access for your VRChat world with an easy, flexible, and visual permission system!
Keypad Permission System lets you create custom roles, assign one or multiple passwords, unlock objects, control buttons, enable or disable colliders, trigger animator parameters, run local Udon events, and manage whitelist users from a clean custom inspector. 🦜✨

Perfect for clubs, VIP areas, staff rooms, private lounges, event rooms, admin panels, DJ booths, hidden features, and world systems that need controlled access.

✨ Main Features

🔑 Create Custom Roles
Create any role your world needs: VIP, Staff, Admin, Owner, DJ, Host, Event Guest, and more.

🎨 Role Colors
Each role has its own color, making logs, setup, and permissions easier to identify.

🔐 Single or Multiple Passwords Per Role
Use one password per role or assign multiple passwords to the same role.

🛡️ Runtime Hash Security
Passwords are written and managed in a readable way inside the Unity editor for easy setup.
When preparing the system for VRChat, the passwords are converted into runtime hashes, so the uploaded world uses the hashed version instead of storing the readable password directly.

This adds a stronger layer of protection and makes it much harder for users to casually extract or read the original passwords from the uploaded world data. 🔒

🧬 Role Permission Inheritance
Higher roles can inherit permissions from other roles.
Example: Owner can inherit Admin, Admin can inherit Staff, and Staff can inherit VIP.

✅ Whitelist Users
Automatically assign a role to specific users when they enter the world.

🖥️ TMP InputField Login
Players enter their password through a TMP InputField.
No numeric keypad needed.

📦 Permission Pools
Control permission states for:

• GameObjects
• Buttons
• Colliders
• Animators
• Local Udon Events

🎞️ Animator Pool
Set Animator parameters depending on permission state.
Supports:

• Bool
• Int
• Float
• Trigger

⚡ Local Udon Events
Run local SendCustomEvent actions when a role is unlocked.

📜 Custom Logs with Role Colors
Display custom login messages using tokens like:

• {username}
• {role}
• {role_desc}

Example:

Hello {username}, you now have {role} access. Enjoy your time at our club.

🔊 Audio Feedback
Includes preconfigured audio feedback options. You can also customize success, error, whitelist login, and other access result sounds if desired.

🧰 Debug, Validation and Tools
Includes editor tools to help detect missing references, duplicate roles, empty passwords, inheritance issues, missing events, and setup mistakes.

🎮 Example Uses

✨ VIP-only areas
🎧 DJ control panels
🚪 Staff-only doors
🛠️ Admin controls
👑 Owner-only tools
🎉 Event access codes
🔒 Private rooms
🎛️ Club management systems
🧪 Creator-only debug/test buttons
🌟 Hidden world features

🚀 Plug & Play Setup

This system is designed to be easy to use.

Simply go to:

Assets/ParrotsConch/Prefabs/KeypadPermission.prefab

Drag the prefab into your world, configure your roles, passwords, and permissions, optionally add whitelist users, and you are ready to go! ✅

The UI is already prepared by default, and the audio feedback is preconfigured but optional to customize.

📁 Includes

• UdonSharp runtime script
• Custom Unity editor script
• Ready-to-use prefab
• Role creation system
• Single and multiple password support
• Runtime hash system
• Role inheritance system
• Permission pools
• Whitelist system
• TMP InputField login support
• Custom log system
• Audio feedback options
• Animator permission control
• Local Udon event support
• Debug and validation tools
• Password clipboard helper

⚠️ Important Notes

This system is designed for local world permissions and access control inside VRChat worlds.

It is a great solution for organizing access in clubs, VIP rooms, staff areas, private zones, event spaces, DJ booths, admin panels, and creator-only tools.

It helps world creators manage permissions in a cleaner, more visual, and more controlled way while keeping setup simple and user-friendly. 🔐✨

🤖 AI-Assisted Content Disclaimer

This product was fully conceptualized and designed by Parrot’s Conch.

The original product idea, feature planning, permission structure, pseudocode, and core code matrix were created by the human developer behind Parrot’s Conch.

This product was developed in part with AI assistance. AI tools were used to assist with portions of coding, artwork, logos, promotional text, tutorials, documentation, and other development-related assets.

Testing, review, functionality checks, editing decisions, final configuration, product preparation, and packaging were completed by the human developer behind Parrot’s Conch.

Final files were reviewed, edited, configured, tested, and packaged by Parrot’s Conch.