Roles & Permissions

ScriptVault has four permission levels. Two of them — Library Manager and Upload Manager — are Discord roles you configure on your server. The others come from Discord itself.

Permission matrix

Action	Member	Upload Mgr	Library Mgr	Admin
Search & browse scripts	✓	✓	✓	✓
Download public scripts	✓	✓	✓	✓
Download role-required scripts (with role)	✓	✓	✓	✓
Rate and review scripts	✓	✓	✓	✓
Favorite scripts	✓	✓	✓	✓
View download history	✓	✓	✓	✓
Report a script	✓	✓	✓	✓
Create & view collections	✓	✓	✓	✓
Upload / add scripts	—	✓	✓	✓
Approve pending uploads	—	—	✓	✓
Reject pending uploads	—	—	✓	✓
Edit script metadata	—	—	✓	✓
Delete scripts	—	—	✓	✓
Toggle scripts (enable/disable)	—	—	✓	✓
Set script access mode	—	—	✓	✓
Resolve reports	—	—	✓	✓
View analytics	—	—	✓	✓
Bulk import, approve, reject	—	—	✓	✓
Duplicate review and cleanup	—	—	✓	✓
Export library metadata	—	—	✓	✓
Library setup and config	—	—	—	✓
Library reset	—	—	—	✓
Assign staff roles	—	—	—	✓

Role descriptions

Administrator

Full access to everything. Comes from Discord's built-in Administrator permission. Can configure the library, assign staff roles, reset the library, and perform all management operations.

Library Manager

A Discord role you configure via /library config library_manager_role. Library Managers can manage the full script catalog — approve/reject, edit, delete, configure access control, resolve reports, view analytics, and run bulk operations — but cannot change library configuration or assign roles.

Use this for trusted moderators or curators who manage the day-to-day library without full server admin access.

Upload Manager

A Discord role you configure via /library config upload_manager_role. Upload Managers can add and bulk-import scripts. That's it — they cannot approve their own submissions, delete scripts, configure access, or resolve reports.

Use this for contributors who submit scripts but shouldn't have moderation power.

Member

Any server member. Can search, browse, download public scripts, rate scripts, manage favorites, and report content. Cannot manage the library.

Important: Upload Manager alone does not bypass role-gated downloads or staff_only restrictions. An Upload Manager who is not also a Library Manager or Admin cannot download staff_only scripts or access scripts they don't have the required role for.

Assigning staff roles

Only a Discord Administrator can assign the Library Manager and Upload Manager roles to ScriptVault. Once assigned, give the Discord roles to your staff members as normal.

Create the Discord roles on your server (e.g. Script Staff and Script Uploader)
Run /library config library_manager_role:@Script Staff
Run /library config upload_manager_role:@Script Uploader
Assign those Discord roles to your staff members as usual

Role-gated downloads Pro / Creator

Beyond staff roles, Pro and Creator servers can also control which members can download specific scripts using three access modes:

publicDefault. All server members can download.

role_requiredOnly members who hold one of the required Discord roles can download. Library Managers and Admins always bypass this.

staff_onlyOnly Library Managers and Admins can download. The script is hidden from normal users in search.

See Library Setup for configuration examples.

Guild isolation: All roles and permissions are scoped to your server only. A Library Manager in Server A has no access to Server B's library — even if the same person holds both roles.

← Library setup Bulk tools →