Welcome to the official documentation for the Viscra Discord bot. Here you will find a list of all available commands and how to use them.
Manage roles automatically assigned to new members.
Subcommands:
add: Add a role to be automatically assigned. remove: Remove a role from being automatically assigned. view: View all currently configured auto-roles. Closes the current ticket.
Usage: /close
Provides a link to the Viscra web dashboard.
Usage: /dashboard
Manages the EP (Event Point) tracking system.
Subcommands:
setup: Interactively sets up the EP tracking system for this server. add: Adds EP points to one or more users. (Officer/Admin Only) view: Views a user's current EP status for the week. Host and track Roblox in-game events.
Subcommands:
host: Host a new in-game event and generate the launch link. end: End an active event and archive results. Manages game bans via Roblox Cloud API.
Subcommands:
add: Bans a user from the game (and optionally the server). revoke: Revokes a game ban. config: Configures the Game Universe ID for bans. Manage gifted gamepasses for users.
Subcommands:
gift: Gift a gamepass to a user. revoke: Revoke a gifted gamepass from a user. view: View all gifted gamepasses for a user. list: List all available gamepasses from the configured universe. configure: Configure the universe ID for gamepass autocomplete. (Admin only) Generates or retrieves the secret key for this server to communicate with the bot.
Usage: /getkey
Manages group-wide role bindings for Roblox groups.
Subcommands:
add-role: Adds roles to all members of a Roblox group. remove-role: Removes roles from all members of a Roblox group. delete-bind: Deletes an entire group-wide bind. view: Displays all configured group-wide binds in the server. Ranks a user to a specified role in a Roblox group.
Usage: /grouprank group: <value> user: <value> rank: <value>
Accepts or denies a join request for a configured Roblox group.
Usage: /grouprequest group: <value> action: <value> user: <value>
Manages Leave of Absence (LOA) for users.
Subcommands:
add: Places a user on LOA. end: Ends a user's LOA early. viewall: Views all users currently on LOA. set-role: Sets the role given to users on LOA. Manages medals for users.
Subcommands:
create: Creates a new medal. edit: Edits the name or description of an existing medal type. award: Awards a medal to one or more users. revoke: Revokes a medal from one or more users. delete: Deletes a medal type from the server. list: Lists all available medals in the server. view: Views a specific user's medals. Deletes a specified number of messages from the current channel.
Usage: /purge amount: <value>
Manages multi-role bindings and naming schemes for specific Roblox ranks.
Subcommands:
add-role: Adds Discord roles and optionally a naming scheme to a Roblox rank bind. remove-role: Removes Discord roles from a Roblox group rank bind. set-scheme: Sets or clears the naming scheme for an existing rank bind. delete-bind: Deletes an entire rank bind (roles and scheme). view: Displays all configured rank binds in the server. Manages server-specific bot settings.
Subcommands:
set-verified-role: Sets the role given to members who successfully verify. set-unverified-role: Sets the role given to members when they join (removed on verification). set-warning-role: Sets the role given to members when they receive a warning. set-log-channel: Sets the channel for message edit/delete logs. (Use /logsettings for more options) set-update-log-channel: Sets the channel where user update logs will be sent. set-economy-channel: Sets the channel where economy commands can be used. server-moderator-role: Manages roles that can manage tickets and use moderation commands. set-ticket-category: Sets the category where new ticket channels will be created. set-transcript-channel: Sets the channel where ticket transcripts will be sent. set-gamelink-auth: Authorises Viscra's GameLink integration via Roblox OAuth. set-bot-key: Sets the secret key for authenticating requests from the Roblox game. set-game-universe: Sets the Roblox Universe ID for game bans. officer-role: Manages roles that can use officer-level commands. gamepass-gifter-role: Manages roles that can gift gamepasses. Displays statistics about the bot.
Usage: /statistics
Displays the top 10 users with the most XP in this server.
Usage: /topxp
Removes your verification and all associated roles.
Usage: /unverify
Updates a user's roles and nickname based on their Roblox account.
Usage: /update [user: <value>]
Initiates the verification process to link your Roblox account.
Usage: /verify
Checks a user's verification status, group ranks, and medals.
Usage: /whois target: <value>
Displays a user's XP in this server.
Usage: /xp [user: <value>]
Changes a user's XP in this server.
Subcommands:
add: Adds XP to one or more users. remove: Removes XP from one or more users. set: Sets the XP for one or more users. Bans a user from the server.
Usage: /ban user: <value> [reason: <value>] [delete_messages_days: <value>]
Duplicates an entire category, including channels and permissions.
Usage: /dupecategory category: <value> [newname: <value>] [rolea: <value>] [roleb: <value>]
Manage the global economy (Owner Only)
Subcommands:
setseason: Set the current season season: Season name additem: Add an item to the shop name: Item Name price: Price description: Description stock: Stock (-1 for infinite) emoji: Item Emoji season: Season availability (default: all) effect_type: Effect Type effect_duration: Duration in minutes effect_power: Power % (e.g. 10 for 10%) deleteitem: Delete an item from the shop id: Item ID givemoney: Give money to a user user: User amount: Amount giftitem: Gift an item to a user user: User item: Item ID amount: Amount wipe: Wipe a user's economy data userid: User ID to wipe Creates or edits a custom embed message.
Subcommands:
create: Opens a modal to create a new custom embed. channel: The channel to send the embed to. colour: The colour for the embed. edit: Opens a modal to edit one of your existing embeds. message_link_or_id: The message link or ID of the embed message to edit. Manages giveaways in the server.
Subcommands:
create: Creates a new giveaway. duration: Duration (e.g., 1d, 12h, 30m, 60s). winners: The number of winners. prize: The prize for the giveaway. channel: The channel to post the giveaway in. end: Ends a running giveaway early. giveaway: The message ID of the giveaway. reroll: Rerolls winners for an ended giveaway. giveaway: The message ID of the giveaway. cancel: Cancels a running giveaway. giveaway: The message ID of the giveaway. Kicks a user from the server.
Usage: /kick user: <value> [reason: <value>]
Configure log channels for different event types.
Usage: /logsettings type: <value> channel: <value>
Manage logging exclusions for channels, categories, and roles.
Subcommands:
add: Add a channel, category, or role to the logging exclusion list. channel: The channel to exclude. category: The category to exclude. role: The role to exclude. remove: Remove a channel, category, or role from the logging exclusion list. channel: The channel to remove from exclusions. category: The category to remove from exclusions. role: The role to remove from exclusions. view: View all current logging exclusions. Manages Viscra PRO status for servers. (Owner Only)
Subcommands:
grant: Grants premium status to a server manually. serverid: The ID of the server. duration: Duration in months. revoke: Revokes premium status from a server. serverid: The ID of the server. view: Views premium status for a specific server. serverid: The ID of the server. viewall: Displays all active premium servers. Manages reaction roles.
Subcommands:
create: Creates a new reaction role message with multiple roles. title: The title of the embed. description: The text of the embed. channel: The channel to post the message in. roles: The emoji and role pairs. Format: emoji @Role emoji @Role ... delete: Deletes an existing reaction role panel. panel: The reaction role panel to delete. view: Displays all configured reaction role panels in the server. Interactively sets up the server with roles and binds for a Roblox group.
Usage: /setup groupid: <value>
Manages the ticket system.
Subcommands:
create: Creates a new ticket panel. title: The title of the ticket panel embed. text: The main text of the ticket panel embed. Use \n for new lines. button-text: The text for the "Open Ticket" button. channel: The channel where the ticket panel will be posted. delete: Deletes an existing ticket panel. panelid: The ID of the panel to delete (from the embed footer). manage: Edits the text or title of an existing ticket panel. panelid: The ID of the panel to manage. title: The new title for the ticket panel embed. text: The new main text for the ticket panel embed. Use \n for new lines. button-text: The new text for the "Open Ticket" button. Updates roles for all members in the server based on verification status.
Usage: /updateall
Posts the verification panel in the current channel.
Usage: /verifypanel
Displays all configured rank and group binds in the server.
Usage: /viewbinds
Manages user warnings.
Subcommands:
add: Warns a user. user: The user to warn. reason: The reason for the warning. view: Views a user's warnings. user: The user whose warnings you want to see. remove: Removes a specific warning using its ID. warningid: The unique ID of the warning to remove (e.g., a1b2c3d4). Configure the server welcome message.
Subcommands:
set: Set the welcome message and its destination. destination: Where to send the welcome message. message: The welcome message content. Use variables like {user_mention}. channel: The channel to send the message to (if destination is channel). view: View the current welcome message configuration. disable: Disable the welcome message feature.