Documentation

Everything Shark does.

Shark is an all-in-one Roblox & Discord bot: one system for verification, rank syncing, moderation, security, modmail, advanced logging, leveling, and more — so your Discord role always matches your Roblox group rank, and your server stays safe without stitching five different bots together.

Overview

Shark links your Roblox group and your Discord server together. Members verify once, and from then on their Discord role tracks their live Roblox group rank automatically. On top of that sync, Shark ships a full moderation toolkit, anti-raid and anti-nuke protection, DM-based modmail, categorized event logging, leveling and a server economy, and an AI assistant — all configured entirely with Discord slash commands. The dashboard and core server tools are free; paid plans add higher limits and premium features.

Getting started

  1. Add Shark to your server using the "Add to Discord" button — it requests the permissions it needs for moderation and role management.
  2. Verify yourself by running /verify in Discord. Shark gives you a one-time code.
  3. Add the code to your Roblox profile's About Me section.
  4. Confirm it with /confirmverify — Shark checks the code against the live Roblox API and links your accounts.
  5. Optional: link your Discord account on the website's Link accounts page too, so your connection status is saved and visible there.

Verification & rank sync

Once a member is verified, Shark keeps their Discord role matched to their current Roblox group rank automatically — no manual updates when someone gets promoted or demoted in-game.

/rank

Checks or sets a Roblox user's group rank directly by username, with autocomplete for role names as you type. No linked Discord account is required to use it — but if that Roblox account is linked to someone in your server, their Discord role updates at the same time.

/promote Premium/Ultimate

Takes a whole promotion log — one line per person — and reports success or failure per line, instead of running /rank one at a time.

Join request handling

Verified members can be auto-accepted into your Roblox group. Everyone else waits for a human to review the request.

Moderation

The standard toolkit, with role-hierarchy checks so members can't act above their own rank:

  • Warnings & timeouts
  • Kicks & bans
  • Detailed moderation logs
  • A case number for every action

Every action gets logged with a case number you can look up later with /modlogs — including anti-nuke responses, so there's always an audit trail.

Anti-raid & anti-nuke

Anti-raid

Detects a sudden spike in joins and can lock the server down automatically, holding brand-new accounts until it's clearly not an attack.

Anti-nuke

Detects dangerous mass actions — deleting channels, mass-banning members — and automatically responds, stripping access from the account responsible (compromised or not) before the damage spreads.

Modmail

There's no panel to post — a member opens a thread just by DMing Shark directly. If Shark only shares one modmail-configured server with them, that's where it opens automatically; if it shares more than one, they get a dropdown to pick which server's staff the thread is for, so it's never ambiguous which server they're messaging. Staff reply by typing in the thread channel — Shark relays it back to the member's DMs automatically, tagged with the server's name, and vice versa for anything the member sends afterward.

  • /modmailsetup — configure the category, staff role, and log channel once (staff)
  • /modmail member — proactively open a thread with someone (staff)
  • /modmailclose [reason] — close the thread and save a transcript (staff), also available as a button on the thread

Advanced logging

Separate from the single audit channel set in /setup (which stays reserved for Shark's own moderation/anti-nuke/modmail notices), /logging gives you a clean, Dyno-style event log split into categories, each pointed at its own channel.

  • Messages — edits, deletes, purges
  • Members — joins, leaves, kicks, bans/unbans, nickname and role changes
  • Server — channel and role create/delete/rename, webhook creation
  • Voice — join/leave/move
  • Roblox — the group's own audit log (rank changes, exiles, wall posts, and more), polled automatically and posted as clean Discord embeds

/logging status shows every category's channel, /logging set points one at a channel, and /logging disable turns a category off.

Leveling & economy

A per-server XP system (each server's levels are its own — no shared, global totals) plus a server currency to help keep members engaged — /level, /leaderboard, /balance, and /daily. Staff configure the XP rate, cooldown, and level-up announcements with /leveling, or from the Dashboard.

AI assistant Premium/Ultimate

Members can ask /ask a question right in Discord and get a straight answer, without leaving the server.

Command reference

Run /help in Discord for the same list, grouped and browsable right there. Commands marked Premium/Ultimate below need a paid plan — everything else is free.

CommandWhat it does
Roblox linking
/verifyStarts Roblox verification — gives you a one-time code.
/confirmverifyConfirms the code and links your Roblox account.
/unlinkUnlinks your own Roblox account.
/forcelinkLinks a member's Roblox account for them, skipping the code check (staff).
/forceunlinkRemoves another member's linked Roblox account (staff).
/whoisLooks up how a Discord member and Roblox account are linked.
Roblox group
/rankChecks or sets a Roblox user's group rank, with autocomplete.
/promote Premium/UltimateBulk rank change from a promotion log.
/groupinfoShows this server's configured Roblox group.
/robloxshoutShows the Roblox group's current shout (read-only).
/shout set · sendChoose an announcements/news channel and send a server message through Shark.
/grouprolesLists every rank in the group.
/joinrequestsShows pending join requests with accept/decline buttons.
/robloxprofile · /avatar · /grouprank · /badges · /namehistoryRoblox profile lookups by username.
/gameinfoLive stats for a game by place ID.
Moderation
/warn · /warnings · /clearwarningsWarn a member, or review/clear their warning history.
/timeout · /kick · /ban · /unbanStandard moderation actions, with role-hierarchy checks.
/purgeBulk-deletes up to 1000 messages, looping past Discord's 100-per-call limit.
/lock · /unlock · /slowmodeChannel controls.
/nicknameSets or resets a member's nickname.
/modlogsLooks up a moderation or anti-nuke case by number.
Anti-nuke
/antinuke status · enable · disableReview or toggle protection.
/antinuke threshold · punishmentTune how sensitive it is and what it does (quarantine, kick, or ban).
/antinuke trust · untrustExempt staff/bots from the checks.
/antinuke antibotToggles the new-bot-with-dangerous-permissions check.
Modmail
/modmailsetupSets the category, staff role, and log channel (staff).
/modmail memberProactively opens a thread with someone (staff).
/modmailcloseCloses the current thread and saves a transcript (staff).
Logging & setup
/logging status · set · disablePoint each log category at its own channel, or turn one off. Members logs include joins/leaves, roles and nickname changes.
/reactionrole add · remove · listReaction roles: 6 on Free/Essential, 12 on Premium, 15 on Ultimate.
/setupSets the Roblox group, API key, verified role, and audit channel.
/setrankroleMaps a Roblox rank to a Discord role.
/settingsShows everything currently configured for this server.
Extras
/balance · /dailyShark coin economy.
/levelChecks your XP and level (per-server).
/leaderboardTop 10 members by XP in this server.
/levelingStaff: XP rate, cooldown, level-up channel/message.
/serverinfoShows server stats.
/ask Premium/UltimateAsks the AI assistant a question with cleaner plain-text replies.
/welcomeWelcome/leave messages with an optional image or GIF.
/helpShows everything Shark can do, grouped by category, right in Discord.

Plans

PlanPriceAdds
Free$0Core Roblox/Discord tools, moderation, security, modmail, advanced logging, welcome/leave, shout messages, dashboard access, and up to 6 reaction roles
Essential$7/moEverything in Free, plus expanded Roblox lookups, server verification, autorole, custom welcome/leave controls, and higher configuration limits
Premium$14/moEverything in Essential, plus the AI assistant, bulk Roblox ranking, premium leveling and level roles, advanced economy controls, webhooks, and up to 12 reaction roles
Ultimate$21/moEverything in Premium, plus AI moderation, AI exclusions, advanced server automation, the highest limits, priority support, early access, and up to 15 reaction roles

See the full breakdown and pick a plan on the plans section of the homepage. Nothing auto-charges — plans are arranged in the support server.

Account linking

The website's Link accounts page connects your Discord account using real Discord OAuth2 — you're sent to Discord's own login page and Shark never sees your password. Once connected, your status is saved server-side, so it still shows "Connected" if you come back or refresh instead of resetting to "Not connected".

Roblox verification isn't done on the website — it happens entirely through /verify and /confirmverify in Discord, which is also what keeps your Discord role matched to your live Roblox group rank.

Dashboard

The Dashboard page lets a server admin configure Shark without typing Discord commands. Current dashboard settings include server setup, moderation routing, AI moderation, logging, modmail, leveling, security, access and permissions, and notifications. The dashboard is free for every server and uses dropdowns for channels and roles. Sign in with the same Discord account you use in your server; the dashboard only shows servers you have Manage Server on and that Shark is already in.

Under the hood, the dashboard never touches Shark's data file or any secret directly. It calls a small internal API that the bot itself runs and protects with its own key — the bot remains the only thing that actually reads or writes your server's settings. Discord slash commands keep working exactly as before; the dashboard is just another way to reach the same settings.

Welcome messages also support an optional image or GIF URL. Add it with /welcome set image_url in Discord or through the Welcome section above.

Level roles are dashboard-only: Free/Essential can configure up to 5, while Premium/Ultimate can configure up to 10. The server API enforces those limits. The optional Unverified role is assigned on join and removed after join-gate verification. Counting stores only its channel, current count, last user and high score.

Honeypot settings can be changed from the dashboard without rebuilding the trap. Shark keeps its Components V2 warning message, live counter, punishment, moderation cases, and Modlogs/Bot Activities routing.

The dashboard groups server setup, moderation, AI moderation, logging, modmail, leveling, security, access controls, and notifications into separate sections. You can restrict Shark features by role or channel, choose where important alerts are sent, and configure automation such as lockdown, ping protection, sticky messages, and QOTD. Ultimate servers can also configure AI moderation exclusions for channels, categories, roles, users, administrators, and bots.

Support

Run /help in Discord after adding Shark to see everything it can do, or join the support server below for setup help and plan changes.

Join the support server