Documentation

Everything you need to operate Viscra

Explore live command definitions straight from the bot along with usage tips and sub-command details. The list updates automatically, so you are always looking at what is currently deployed.

Live commands + admin tools

61

Last sync

Just now
Read the guide →

Members

User commands

Everything regular members can trigger inside your server. Use these to boost engagement.

/add

Add a user to the current ticket.

Usage/add user: <value>

/autoroles

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.

/close

Closes the current ticket.

Usage/close

/dashboard

Provides a link to the Viscra web dashboard.

Usage/dashboard

/ep

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)
  • remove Removes EP points from one or more users. (Officer/Admin Only)
  • view Views a user's current EP status for the week.
  • clear-inactivity Clears inactivity warnings and resets quota status for a user. (Officer/Admin Only)

/event

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.

/flag

Manage beta feature flags for this server.

Subcommands

  • enable Enable a beta feature flag.
  • disable Disable a beta feature flag.
  • list List all enabled flags and available beta features.

/gameban

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.

/gamepass

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)

/groupbind

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.

/grouplogs

Configure Roblox group logging for rank changes, joins, and leaves.

Subcommands

  • add Add a Roblox group to be tracked.
  • sethicomrole Set the role to be pinged for HICOM changes.
  • view View currently tracked groups.
  • delete Stop tracking a Roblox group.
  • antiabuse Configure anti-abuse thresholds for a group.
  • rollback Rollback group ranks to a snapshot (PRO Only).

/grouprank

Ranks a user to a specified role in a Roblox group.

Usage/grouprank group: <value> user: <value> rank: <value>

/grouprequest

Accepts or denies a join request for a configured Roblox group.

Usage/grouprequest group: <value> action: <value> user: <value>

/invite

Get the bot invite link and support server link.

Usage/invite

/loa

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.

/mainserver

Manages main server connections for division servers.

Subcommands

  • add Connect this division server to a main server.
  • view View the current main server connection or connected division servers.
  • revoke Remove the main server connection (for division servers).
  • disconnect Disconnect a division server from this main server.

/medal

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.

/modlog

View a user's moderation history.

Usage/modlog user: <value>

/purge

Deletes a specified number of messages from the current channel.

Usage/purge amount: <value>

/rankbind

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.

/remove

Remove a user from the current ticket.

Usage/remove user: <value>

/settings

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-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.
  • set-roblox-cookie Sets a custom Roblox cookie for this server.

/statistics

Displays statistics about the bot.

Usage/statistics

/topxp

Displays the top 10 users with the most XP in this server.

Usage/topxp

/unverify

Removes your verification and all associated roles.

Usage/unverify

/update

Updates a user's roles and nickname based on their Roblox account.

Usage/update [user: <value>]

/updateall

Updates roles for all members in the server based on verification status.

Usage/updateall

/verify

Initiates the verification process to link your Roblox account.

Usage/verify

/whois

Checks a user's verification status, group ranks, and medals.

Usage/whois [target: <value>]

/xp

Displays a user's XP in this server.

Usage/xp [user: <value>]

/xpchange

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.

Staff

Administrator commands

Automate onboarding, XP, and moderation flows with the tools below.

/antimention

Manage the anti-mention list for this server.

Subcommands

  • add Add a user to the anti-mention list.
    • user The user to protect from mentions.
  • remove Remove a user from the anti-mention list.
    • user The user to remove.
  • list List all users currently on the anti-mention list.

/apikeys

Manage your server API keys for Roblox-Bot and Public API.

Subcommands

  • generate Generates a new API key. Revokes the old one if it exists.
    • type The type of API key to generate.
  • view View metadata for your current API keys.
  • revoke Revokes an API key.
    • type The type of API key to revoke.

/application

Create and manage application forms.

Subcommands

  • create Create a new application form.
  • manage Turn applications on/off or delete them.
  • panel Post the application starting panel to a channel.
    • id The ID of the application form.

/backupserver

Create a full backup of the server (Channels, Roles, Categories).

Usage/backupserver

/ban

Bans a user from the server.

Usage/ban user: <value> [reason: <value>] [delete_messages_days: <value>]

/commandgroups

Manage command groups for this server.

Subcommands

  • list List all command groups and their status.
  • enable Enable a command group.
    • group The command group to enable.
  • disable Disable a command group.
    • group The command group to disable.

/debug

Debugs a server for configuration issues.

Usage/debug serverid: <value>

/dupecategory

Duplicates an entire category, including channels and permissions.

Usage/dupecategory category: <value> [newname: <value>] [rolea: <value>] [roleb: <value>]

/economymanage

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
  • enable Enable the global economy system
  • disable Disable the global economy system
  • compress Compress all user inventories to new format
  • blacklist Blacklist a user from the economy
    • userid Discord User ID
    • toggle True to blacklist, false to remove

/embedcreate

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.

/getusers

Refreshes Server Owner roles for all members in the support server based on server ownership.

Usage/getusers

/giveaway

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.

/kick

Kicks a user from the server.

Usage/kick user: <value> [reason: <value>]

/logsettings

Configure log channels for different event types.

Usage/logsettings type: <value> channel: <value>

/logsexclude

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.

/multi

Perform an action on a user across all servers you own.

Usage/multi action: <value> user: <value> reason: <value>

/pro

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.

/reactionrole

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.

/restoreserver

Dangerous: Restore the server from the last backup. Wipes current layout.

Usage/restoreserver

/role

Bulk add or remove roles from users.

Usage/role action: <value> roles: <value> all: <value> [users: <value>]

/setup

Interactively sets up the server with roles and binds for a Roblox group.

Usage/setup groupid: <value>

/snippet

Manage server snippets for quick responses.

Subcommands

  • create Create a new snippet.
    • name The name/reference for this snippet (e.g., "info", "rules").
    • content The content to send when this snippet is used.
  • edit Edit an existing snippet.
    • name The name of the snippet to edit.
    • content The new content for this snippet.
  • delete Delete a snippet.
    • name The name of the snippet to delete.
  • view View a snippet or list all snippets.
    • name The name of the snippet to view (leave empty to list all).

/sticky

Manage sticky messages for channels.

Subcommands

  • create Create a new sticky message.
    • channel Channel to stick the message in.
    • name A unique name to identify this sticky message.
    • colour The colour for the embed.
  • edit Edit an existing sticky message.
    • name The name of the sticky message to edit.
  • delete Delete an existing sticky message.
    • name The name of the sticky message to delete.

/stickyroles

Manage roles that are not removed during role updates.

Subcommands

  • add Add a role to the sticky role list.
    • role The role to make sticky.
  • remove Remove a role from the sticky role list.
    • role The sticky role to remove.
  • list List all currently configured sticky roles.

/tickets

Manages the ticket system.

Subcommands

  • panel Manage ticket panels.
    • create Creates a new ticket panel.
    • delete Deletes an existing ticket panel.
    • manage Edits the text or title of an existing ticket panel.
  • category Manage ticket categories.
    • add Adds a new ticket category.
    • edit Edits an existing ticket category.
    • remove Removes a ticket category.
    • list Lists all ticket categories.
  • settings Global ticket settings.
    • naming Sets the global ticket naming scheme.

/timeout

Times out a user from the server.

Usage/timeout user: <value> duration: <value> [reason: <value>]

/verifypanel

Posts the verification panel in the current channel.

Usage/verifypanel

/viewbinds

Displays all configured rank and group binds in the server.

Usage/viewbinds

/warn

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).

/welcome

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.