Library Setup

Complete guide to initialising and configuring your server's ScriptVault library.

Initial setup

Run /library setup once to initialise your server's library. This command requires Administrator permission and can only be run once per server.

After setup your library is immediately active on the Free plan. Run /library status to confirm configuration and see your limits.

Configuration options

Use /library config to update any of the options below at any time (Admin only).

Option	Description & example
`library_name`	Display name shown in `/library status` and announcements. Example: `/library config library_name:Warzone Scripts`
`announcement_channel`	Channel where new approved scripts are announced automatically. Optional. Example: `/library config announcement_channel:#script-releases`
`library_manager_role`	Role that can manage scripts, approve/reject, resolve reports, view analytics, and run bulk operations. Example: `/library config library_manager_role:@Script Staff`
`upload_manager_role`	Role that can upload scripts. Does not grant approval or management powers. Example: `/library config upload_manager_role:@Script Uploader`
`approval_mode`	Who can upload and whether scripts need review before going live. See below.

Approval modes

The approval mode controls who can upload scripts and whether they need staff review before members can download them.

admin_only

Only Administrators (and Library Managers) can upload scripts. Scripts go live immediately. Best for small, tightly managed servers where only a handful of people ever upload.

/library config approval_mode:admin_only

trusted_role

Upload Managers and Administrators can upload. Scripts go live immediately without requiring review. Good for servers with trusted contributors who don't need their uploads reviewed every time.

/library config approval_mode:trusted_role

pending_review

Any server member can submit a script. Submissions enter the pending queue and are hidden from search until a Library Manager or Admin approves them. Best for open libraries with community submissions you want to vet first.

/library config approval_mode:pending_review

Script access control Pro / Creator

Pro and Creator servers can restrict who can download individual scripts using three access modes. Every script defaults to public — no changes needed unless you want to restrict access.

publicDefault. All server members can download. No configuration required.

role_requiredOnly members who hold at least one of the configured Discord roles can download. Library Managers and Admins always bypass this restriction. Requires a Pro or Creator plan to configure.

staff_onlyOnly Library Managers and Admins can download. The script is also hidden from normal users in search results. Available on all plans.

Setting access

Open the Library Admin panel, choose Scripts, pick the script, then Access. Set it to public, staff-only, or role-required and choose the role. The panel shows the current access configuration on the same screen.

Example

/script-admin open

Role-required access needs a Pro or Creator plan.

Access is checked at the moment of download — not just at search time. Even if a user has the script ID from a cached message, they cannot download it if they don't meet the access requirements.

Plan limits

Limit	Free	Pro	Creator
Script slots	250	5,000	20,000
Storage	50 MB	500 MB	2 GB
Max file size	512 KB	1 MB	2 MB
Bulk import (files/batch)	10	50	100
Bulk approve / reject	25	100	250

Run /library status at any time to see current usage against your plan limits. See the Pricing page for full plan details and add-ons.

Library reset

Library reset is an operator-assisted action requested through support. It resets ScriptVault library configuration/settings only. It does not delete uploaded scripts, script files, reports, ratings, downloads, collections, approvals, or analytics. Use it when you need to re-run setup or clear channels/roles/settings back to defaults.

Roles & Permissions →Bulk tools →