SHADOWS STUDIOS
Shadows Studios Bot · Documentation

Everything the bot does, explained.

From the invite to the last module: how to set it up, which permissions it needs, what each feature does and every command with its options.
01

Getting started

Five minutes from the invite to a working bot.

  1. 1Add the bot to your server with the “Add to Discord” button. You need the Manage Server permission on that server.
  2. 2Open the dashboard at bot.shadowsstudios.com and sign in with Discord: you'll see every server you manage.
  3. 3Choose the language the bot uses with your members: the first time you open a server the dashboard asks you, then you change it from Settings → Language. There are ten languages and the change is instant.
  4. 4Turn on the modules you need, one by one. Everything else stays off and out of the way.
  5. 5Run /admin diagnostics: it checks the bot's permissions on every configured channel and tells you exactly what is missing.

Drag the bot's role above the roles it has to give or moderate (Server Settings → Roles). Discord never lets a bot manage roles higher than its own.

02

Dashboard and /admin config

There are two ways to configure the bot, and they share the same settings.

  • Dashboard (bot.shadowsstudios.com): the most complete. Live previews, image uploads, rank card, automations and custom commands are only here.
  • /admin config on Discord: a private panel with the same modules, grouped by category. Handy when you're on your phone.
  • Members with Administrator or Manage Server, and the roles you add as Bot masters in Settings, see the server in the dashboard. Permissions are checked live on Discord at every request.
  • Panels that live in a channel (verification, self-assignable roles, tickets) are published from Discord; the dashboard edits their settings.
  • Game Hub: Roleplay, FiveM, Diablo IV and the games still to come sit in one expandable menu, so the sidebar stays tidy.
  • My account: Premium and payments (with Manage or cancel for your subscription), your support requests, your data, and two-step verification with Google Authenticator, which protects sign-in and important actions.
  • Guides and search: every module has a short guide, also on Discord with /info guide, and the search bar at the top finds any setting, even with a typo.
03

How commands are organised

Discord allows 100 commands per server. The bot groups all of its own into 9 categories, so the rest is yours.

  • /mod moderation · /rp roleplay · /ticket support · /community everything for members · /crypto crypto · /admin server management · /custom custom commands · /info information · /requests requests and absences.
  • Command names and descriptions follow the server's language, chosen in the dashboard: in Italian everyone sees /mod avvisa, in German /mod verwarnen. Changing the language registers the commands again.
  • Discord applies permissions to the category; the bot then checks the permissions of each single command every time it's used.
  • To choose who sees a category: Server Settings → Integrations → Shadows Studios Bot.
04

Permissions

The invite asks for Administrator, so every module works straight away. If you'd rather grant less, the bot needs a base set and each module adds only what it needs.

  • Always: View Channels, Send Messages (also in threads), Embed Links, Attach Files, Read Message History, Add Reactions, Use Application Commands.
  • Moderation, Automod, Security: Manage Messages, Kick, Ban, Timeout Members, View Audit Log.
  • Tickets: Manage Channels, Create Private Threads, Manage Threads.
  • Roles (autorole, verification, self roles, levels, factions, Tebex): Manage Roles.
  • Temporary voice channels and AFK: Connect, Speak, Move Members, Manage Channels.
  • Invite tracking: Manage Server, Create Invite. Server log: View Audit Log.

Most problems aren't bugs but a permission missing on one specific channel. /admin diagnostics finds it for you, with the exact name of the permission.

05

Tickets

Private support channels with intake forms, claims and transcripts.

  1. 1Set the default category with /ticket setup config and create at least one ticket type: each type has its own category, staff roles, log channel, questions and messages.
  2. 2Publish the panel with the open button: /ticket setup panel.
  3. 3A member clicks, fills in the form and gets a private ticket-0001 channel visible only to them and the staff.
  4. 4Inside the ticket: claim, close, close with a reason, add or remove people.
  5. 5On close the bot saves the full transcript, a Discord-style web page sent to the log channel and, if you want, by DM. The channel becomes closed-…: the staff can reopen it until it is deleted, after the hours you choose.
  • Up to 5 questions in the opening form (short text, long text or drop-down), per ticket type.
  • Multiple ticket types and panels (Premium): each type has its own category, staff, who can close it, colour and form; up to 25 from the dashboard.
  • Auto-close after inactivity, open-ticket limit per member, blacklist, 1-to-5 star feedback.
  • Buyers-only tickets: the form asks for the Tebex transaction ID and checks it before opening.
06

Moderation and Automod

Classic commands with role-hierarchy checks, plus automatic filters.

  • /mod ban (also temporary, e.g. 3d), /mod kick, /mod timeout, /mod warn, /mod clear, /mod slowmode, /mod lock.
  • Warnings can expire after a set number of days: they stop counting but stay in the history (/mod log).
  • Automod: banned words, spam/flood, Discord invites, mass mentions, caps lock. All off by default, thresholds adjustable. Banned words, invites and mentions are blocked by Discord's own AutoMod before anyone sees them, and only the author is told why; for the rest the bot deletes the message and tells the author by DM.
  • /admin wordlist imports a public list of banned words (10 languages) without touching the words you added by hand.
  • Staff with Manage Messages are exempt, unless you turn on “Apply to staff too” to run tests.
07

Anti-raid, anti-nuke and lockdown

Three independent protections, all off until you turn them on.

  • Anti-raid: kicks (or just logs) accounts younger than a threshold and spots bursts of joins, with optional automatic lockdown.
  • Anti-nuke: choose which actions to watch (deleting or creating channels and roles, permission changes, bans, kicks, webhooks, emojis, added bots, server settings), each with its own limit, and what happens to whoever goes over it: alert only, remove their roles, remove roles and time out, kick or ban. Trusted roles and users are never checked.
  • Lockdown: /mod lockdown on stops everyone writing in every text channel; /mod lockdown off puts back exactly what was there before.

Anti-nuke stops further damage; it doesn't undo actions already taken. Make a structure backup with /admin backup create once your server is set up.

08

Welcome, verification and roles

What a new member sees, and how they get access.

  • Welcome: an embed in a channel and/or by DM, with {user}, {server}, {membercount}, an optional goodbye message and a graphic card with the avatar, customisable with colours, background image, heading and the line under the name (live preview).
  • Verification: a button that gives the verified role (and removes an optional “unverified” one). Panel: /admin verification panel.
  • Autorole: roles given automatically on join.
  • Self-assignable roles: up to 20 panels with menus, buttons or reactions, one or many roles at a time.
09

Levels, economy and community

Everything that keeps a server alive.

  • Levels: XP from messages and voice, role rewards, graphic rank card with your own background (/community level user).
  • Economy: coins, daily reward, work, role shop and mini-games (/community coins, /community shop).
  • Giveaways with requirements (role, level, account age, invites), bonus entries, scheduled start and reroll.
  • Polls as native Discord polls (2–10 options, up to 32 days), suggestions voted by members, birthdays, reminders, AFK.
  • Temporary voice channels, counters, starboard, sticky messages and the counting game.
10

Game Hub · Roleplay

Built for FiveM, RedM and Minecraft servers. Each piece has its own switch.

  • Factions and duty: ranks with roles, hire/promote/fire, a roster that updates itself, duty hours and a weekly report.
  • Characters: sheets with optional approval, active character shown in records and documents.
  • Records: fines, arrests, notes and invoices with an in-game currency; /rp record history for a citizen's file.
  • Events with sign-ups, limited places and waiting list; anonymous chat (anonymous for members, never for the staff).
  • Game server status: players online, restart announcements and a voice counter, with /rp server.
11

Game Hub · FiveM

Connect your FiveM (or RedM) server to the bot and run its commands from Discord. Part of Premium.

  • Connection: in dashboard → Game Hub → FiveM you generate a key and download the shadows-bridge resource, already set up for your bot. It works with ESX, QBCore, Qbox and standalone servers, and no ports need to be opened.
  • Server commands: the bridge finds the registered commands on its own (console, framework, txAdmin and custom scripts) with their parameters. You turn them on one by one and choose which roles can use them.
  • From Discord: /rp fivem run suggests the active commands; without arguments it opens a form with one field per parameter (for setjob: ID, job, grade). /rp fivem status tells you whether the server is connected.
  • Logs: every command lands in the chosen channel with who used it, parameters, server, date and outcome.

Commands run with the server console’s permissions: only turn on the ones you need. server.cfg needs the line add_ace resource.shadows-bridge command allow, which the panel gives you to copy together with the key.

12

Game Hub · Diablo IV

Game events, server alerts and look-ups by command. Part of Premium.

  • Live events: for World Boss, Helltide and Legion the current state, time left until the end or the start, the next spawn, the respawn, the zone and the boss name when known, with /community diablo events.
  • Alerts: for each event choose the channel, the role to mention and how early to alert (dashboard → Game Hub → Diablo IV). Each member turns the role on or off for themselves with /community diablo follow.
  • Builds: the most played builds at the top of the current season's Pit, filtered by class, with level, time and a link to the run, plus a link to Mobalytics (/community diablo builds).

Event times, the current season and builds update on their own from Helltides.com; between updates the bot works out starts, ends and respawns by itself.

13

Streamers, free games and updates

Automatic announcements in the channel you choose.

  • Streamers & social: Twitch, Kick, YouTube, Bluesky, Mastodon, Tumblr and RSS/podcast feeds. Up to 15 sources per server.
  • Free games: Epic, Steam, GOG and other sources, each announced once. /community freegames shows the current offers.
  • Game updates: a role and a channel per game, members choose what to follow; automatic posts from RSS, Steam news or GitHub releases.
  • Recurring and scheduled messages: embeds built with a live preview and published when you want.
14

Crypto

Prices and alerts without leaving Discord, free on every server.

  • /crypto price, /crypto chart (from 24 hours to a year), /crypto top (the day's biggest movers among the top 100) and /crypto convert between coins and currencies.
  • Price alerts by DM (/crypto alert): above or below a price, or a 24-hour change in percent. Each alert fires once, then pauses until you turn it back on.
  • Watchlist (/crypto watchlist) and settings: your currency, alerts on or off and a daily summary by DM at the hour you choose. They're yours and work on every server.
  • Admins pick the server's default currency and post a public price panel with up to 10 coins, updated every 5 minutes.

Prices come from Binance's public market data. They're for information only and aren't financial advice.

15

Tebex

Purchase verification with an automatic role per package.

  1. 1In Tebex open Servers (Game Server Integration) and copy the server's Secret Key.
  2. 2Paste it in /admin config → Tebex (or the dashboard). Every Discord server has its own key.
  3. 3Map each package ID to the Discord role it should give.
  4. 4Buyers run /ticket verify-purchase with their transaction ID: if the payment is complete, they get the role.

Each transaction can be redeemed only once. Refunded payments and chargebacks are refused.

16

Automations and custom commands

Rules and commands of your own, created from the dashboard.

  • Automations: “if X happens, do Y”. Triggers: keyword, reaction, schedule, member threshold (level, invites, days in the server).
  • Each automation runs 1 to 5 actions: send a message, add or remove a role, delete the message, warn, timeout or kick.
  • Custom commands: used with /custom run and their name, so they don't take up the server's command slots; allowed roles, reply channel and 1 to 5 actions. Up to 20 per server.
17

Server backup

A snapshot of roles, categories, channels and permissions.

  • /admin backup create saves the structure; the last 10 backups per server are kept.
  • /admin backup restore recreates only what is missing (matched by name) and never duplicates anything.
  • Messages are not included: Discord offers no reliable way to back them up.
  • /admin wipe deletes every channel, category and role. Only the server owner can run it, after several confirmations.
18

Free and Premium

Everything essential is free, forever. Premium is per server, monthly or yearly.

  • Free: welcome, verification, autorole, moderation, server log, tickets with 1 type and transcripts, up to 10 active embeds, self roles, voice channels, counters, AFK, levels, economy, birthdays, reminders, free games, statistics, crypto.
  • Premium: bot identity per server, security, automod, multiple ticket types, unlimited embeds, requests and forms, game updates, starboard, sticky messages, counting, the whole Game Hub (roleplay, FiveM and Diablo IV), invites, polls, suggestions, giveaways, automations, custom commands, streamers & social, Tebex and templates.
  • Activation: after payment Premium goes to the server you chose, or you get a key by DM to redeem in the dashboard or with /admin premium redeem.
  • You can move Premium to another server you manage from the Premium page (once every 7 days).
  • On expiry the owner gets a DM 7 days before. The Premium modules then pause, but nothing is deleted; a server with an auto-renewing subscription gets 3 days of grace while the payment comes through.
  • To cancel a subscription: My account → Premium and payments → Manage or cancel. Premium stays until the end of the period already paid; PayPal payments are one-off and don't renew.
19

Your data

What the bot keeps, and how you see it.

  • Settings, levels, coins, tickets and history are kept in the bot's own database, with automatic backups.
  • On the My account page of the dashboard every user sees what the bot keeps about them, server by server, and downloads it as JSON.
  • From the same page you can delete your birthday, reminders, AFK status, character sheets and your crypto alerts, watchlist and preferences yourself. Warnings, sanctions and RP records stay with the staff.
  • Payments go through Stripe (card, Apple Pay, Google Pay) or PayPal: card details never reach us.
  • The bot keeps no billing details: address, VAT number, receipts and invoices are handled by Stripe (and by PayPal for its payments). The bot only remembers who paid, which plan and for which server.
  • Two-step verification stores an encrypted key and the recovery codes only as a fingerprint: they cannot be read back.
  • Server owners get a DM when the bot is updated; the button under the message turns these off.
20

All commands

Generated from the bot's code, so it always matches the bot. Names are in the language of this page; on Discord they follow your server's language. The English name is shown below each one.

/modModeration: ban, kick, timeout, warnings, message cleanup, channel locks

/mod ban

Ban a member, permanently or for a set time

Usage
/mod ban <user> [reason] [delete_days] [duration]
Options
userrequired
User to ban
reasonoptional
Reason for the ban
delete_daysoptional
Days of messages to delete (0-7)
durationoptional
Temporary ban, e.g. 12h, 3d, 1d12h (empty = permanent)
1 / 14

Still stuck?

Write to us from the contact page and pick “Bot support”: we read every message.