Discord Command Reference — Time Capsule Handbook

How slash commands work

Run a command in three steps.

Open Discord’s command picker

Input: In an allowed server channel, type /timecapsule.

Expected result: Discord lists the current subcommands below.
Select the action and fill its fields

Input: Choose a subcommand. Complete every field marked Required; optional fields may be left blank.

Expected result: Discord shows a complete command preview. Autocomplete offers eligible capsule codes where supported.
Send and follow the private controls

Input: Press Enter or Send, then use any menus, modals, or buttons returned by Time Capsule.

Expected result: Most management flows reply privately. If access or configuration is missing, the response explains the required permission or next step.

Member commands

Create and manage your capsules.

Guided creationCompose a capsule

/timecapsule compose

Opens the private composer: release type, content and files, anonymity, one human recipient plus a DM-or-channel delivery route, preview, and sealing. Plus types load only when the server has Plus. The upload panel shows server file-count, per-file size, and remaining-slot limits. A successful Seal time capsule confirmation turns green, disables sealing, offers Details, and changes Preview to Exit; Exit deletes only the ephemeral composer message.

Input: No slash-command fields
Access: Members allowed by server policy
Output: Private guided composer

BrowseList and manage your capsules

/timecapsule list

Shows caller-authored capsules only. The first five entries show their stable capsule ID and receive button rows: Details, Edit, Pause/Resume, Delete, and Unlock. When member editing is enabled, Edit can issue a short-lived one-time portal link to a capsule-only page; otherwise it says Edits disabled. Delete/Unlock ask for confirmation.

Input: No fields
Access: Signed-in caller; not a manager-wide list
Output: Private list; buttons on the first five entries

EditChoose a capsule and open its form

/timecapsule update

Shows the first 25 eligible locked capsules authored by the caller. The modal edits optional title (100), required message (1900), unlock time, and delivery channel ID/mention only—not recipient, DM/channel mode, files, anonymity, or condition.

Input: Choose in the returned picker, then complete the limited form
Access: Original author only
Output: Private picker and update result

RemoveDelete a scheduled capsule

/timecapsule delete id:CAPSULE-CODE

Deletes the selected scheduled capsule immediately after authorization; there is no separate confirmation. Autocomplete lists caller-authored capsules, while an authorized manager may manually enter another eligible code.

Required: id — capsule code
Access: Eligible creator or authorized manager
Output: Private deletion result

Reveal nowUnlock a capsule immediately

/timecapsule unlock id:CAPSULE-CODE

Irreversibly starts immediate delivery after authorization; there is no separate confirmation. Autocomplete lists caller-authored capsules, while an authorized manager may manually enter another eligible code.

Required: id — capsule code
Access: Eligible creator or authorized manager
Output: Private unlock/delivery status

Setup commands

Configure server behavior.

First launchOpen guided server setup

/timecapsule setup

When the server’s guided_setup feature is enabled, this opens a six-page concierge for delivery, timezone, attachments, reports, reviewer notifications, safety, audit retention, explicit terms, channel policy, and individual channel settings. It finishes with role and channel-permission checks. Plus-only controls are labeled and disabled on Free. Otherwise, the bot returns a private “guided setup is unavailable” message.

Input: No fields
Access: Owner, Manage Server, or configured management role; guided_setup must be enabled
Output: Private setup panel or an availability message

Ongoing settingsOpen server controls

/timecapsule configure

Manages announcement/audit channels, up to 10 management roles, and bot pause/resume. Selecting All server settings opens this server’s Delivery & media settings directly, preserving that deep link through Discord OAuth.

Input: No fields
Access: Owner, Manage Server, or configured management role; role changes require Manage Server
Output: Private server-control panel

App installationOpen the official invite link

/invite

Returns the official Time Capsule installation link. Anyone can run the command; completing installation for a server requires Manage Server.

Input: No fields
Access: Anyone can request the link; installer needs Manage Server
Output: Official bot invite/install control

Moderator commands

Restrict or restore bot access.

Member restrictionBan a user from this bot

/timecapsule ban user:@MEMBER reason:REASON
                      duration:7d

Prevents the selected member from using Time Capsule in this server. The reason is shown to moderators and the banned user.

Required: user, reason (max 300 characters)
Optional: duration: 30m, 12h, 7d, 4w, 6mo, 1y, or forever
Access: moderation_controls enabled; owner, Manage Server, or management role
Output: Private moderation confirmation and audit record

Capsule-led restrictionBan the sender by capsule or message

/timecapsule ban-message message:CAPSULE-CODE
                      duration:12h reason:REASON

Resolves a capsule code, Discord message link, or raw Discord message ID to its sender, then applies a server-local bot ban.

Required: message — capsule code, Discord message link, or raw message ID
Optional: duration: 30m, 12h, 7d, 4w, 6mo, 1y, or forever; reason (max 300 characters)
Access: moderation_controls enabled; owner, Manage Server, or management role
Output: Private result and moderation audit

Restore accessUnban a user

/timecapsule unban user:@MEMBER reason:REASON

Allows the selected member to use Time Capsule again in the current server.

Required: user, reason (max 300 characters)
Access: moderation_controls enabled; owner, Manage Server, or management role
Output: Private confirmation and moderation audit

Moderators should always provide a factual reason, verify the target, and follow the server’s appeals policy. See the moderation workflow before taking action.

Owner and plan commands

Review status, insights, and purchases.

Moderator portalOpen this server’s portal home

/timecapsule portal

Opens the selected server’s Moderator Portal Home page directly. Discord OAuth preserves that server-specific destination instead of returning to the general dashboard.

Input: No fields
Access: Server owner or configured management role
Output: Private server-scoped portal link

Collaborative vaults · PlusCreate or manage vaults

/timecapsule vault

Opens a menu-driven manager to create a vault with the same event types as capsules, choose one to manage, move up to 25 eligible sealed server or member capsules, post full-compose and quick-contribution controls, or manually open the collection. The confirmed move is atomic and replaces each capsule’s prior event and backup release configuration.

Input: No slash-command fields; use the returned menus
Access: Server owner or configured management role; active Plus and the enabled Vaults platform feature are required
Output: Private vault manager or plan/maintenance explanation

Plus analyticsShow server insights

/timecapsule insights

Displays this server’s available Plus insights in Discord.

Input: No fields
Access: Authorized server staff; Plus required for Plus insights
Output: Private server insight summary or plan notice

Discord storefrontBuy Plus or custom branding

/timecapsule upgrade product:Plus

Shows the current access state and eligible Discord purchase controls for this server.

Optional: product: Plus or Custom branding add-on
Access: Server owner or configured management role
Output: Private purchase/status panel

Discord profileOpen branding settings

/timecapsule branding

Provides a direct route to the selected server’s Discord-visible branding controls in the moderator portal.

Input: No fields
Access: Authorized server staff; editing depends on entitlement
Output: Private portal link or access explanation

Runtime checkShow bot version and subscription status

/timecapsule version

Reports the deployed bot version and the current server tier and subscription status. The response does not expose the internal billing source.

Input: No fields
Access: Available even when ordinary bot use is restricted
Output: Version and subscription summary

Support command

Send a secure support request.

Private help flowOpen the support form

/timecapsule help

Opens the help hub first. From there, choose the handbook, command reference, support server, or Contact support. Contact support opens the category, subject, message, and optional-reference modal; keep the returned reference after submission.

Input: No command fields; support-modal fields appear only after Contact support
Access: Available even when ordinary bot use is restricted
Output: Private help hub, then a receipt if a support request is submitted

For portal-form details, Discord support-server onboarding, security reporting, and status channels, use the Support & status guide.