FlaviBot documentation
How the bot actually works, written to be read in order. Every page is kept against the running code, so what you read here is what runs.
Start readingGetting started
7 pagesInvite the bot, find the dashboard, set the basics.
- 01Adding FlaviBotWhere to find the FlaviBot invite link, what the invite asks Discord for, and what happens in your server the moment the bot joins.
- 02What FlaviBot can seeWhich Discord events reach FlaviBot and which never do, what server statistics it stores, and what happens when a permission it needs is missing.
- 03Finding your dashboardHow to open the FlaviBot dashboard, who is allowed in, why settings are stored per bot, why nothing saves by itself, and what to do if a server will not load.
- 04Commands and /helpThe two ways to run a FlaviBot command, what /help shows, the commands worth knowing on day one, and the five reasons a command can refuse.
- 05Prefix, mentions and languageSet FlaviBot's text prefix or turn prefix commands off, use the bot mention as a fallback, and choose the server's language, timezone and command restrictions.
- 06Turning things on and offEnable or disable a whole FlaviBot module or a single command, read the sidebar status dots, and see which access rule wins when several apply.
- 07Setting up a custom botRun FlaviBot's features under your own Discord application: what you need, creating and connecting the bot, and setting its name, avatar and status.
Autoresponder
11 pagesBuild automations: triggers, filters, actions, variables.
- 01What an autoresponder isThe mental model behind every FlaviBot autoresponder: a trigger, filters, actions and variables, the path an event takes, and what a rule is not.
- 02TriggersEvery event a FlaviBot autoresponder rule can listen to, from messages, reactions and members to voice, channels and roles, and what each one gives you.
- 03Filters and gatesThe six checks that can stop a FlaviBot autoresponder between its trigger and its actions, plus its anti-loop protection and auto-disable.
- 04ActionsA tour of the action families a FlaviBot autoresponder can run, how steps hand values to each other, permission checks, and what happens when a step fails.
- 05VariablesWhere the values in a FlaviBot autoresponder come from: always-available and trigger variables, earlier steps, transformers, and your own stored values.
- 06Conditions and timingMake a FlaviBot autoresponder step run only when its conditions hold, and make a rule wait before carrying on, including what survives the wait.
- 07Groups and panelsGroup several FlaviBot autoresponder rules with the panels that host their buttons, edit them in one place, and share data inside the group.
- 08BatchingMake a FlaviBot autoresponder react to a burst of events instead of each one: the three batching settings, what the rule receives, and an anti-raid gate.
- 09Custom eventsLet one FlaviBot autoresponder rule emit a custom event that other rules listen for, instead of copying the same steps into each rule.
- 10PresetsInstall a ready-made FlaviBot automation from the preset marketplace, share one of your own rules or groups, and review a preset's versions and updates.
- 11Every action, in detailEvery FlaviBot autoresponder action in detail: what each one does, the bot permission it needs, its settings, and the values it hands to later steps.
Music
14 pagesPlayback, playlists, DJ mode, the web player and 24/7.
- 01The Music moduleThe FlaviBot Music module: the four ways to control playback, slash commands and prefix aliases, permissions, and what is free, vote-gated or Premium.
- 02Playing musicWhat you can hand to FlaviBot's /play, the platforms it supports (FlaviBot does not support YouTube), uploaded files, TTS, radios, and how to stop playback.
- 03Playback controlsPause, skip, go back, jump, seek, change the volume and loop in FlaviBot, how vote skip decides, and what to do about audio problems.
- 04The queueView FlaviBot's music queue, remove or reorder tracks, clean it up, see who may change it, and save it as a playlist. A free server's queue holds 200 tracks.
- 05Audio filtersThe audio filters FlaviBot can put on playback, from bassboost and nightcore toggles to adjustable dials, how to clear them, and using them from the web player.
- 06The now playing message and the controllerThe buttons FlaviBot posts on every now playing message, how to turn them off, and the controller channel where typing a song name plays it.
- 07Announcements and the announcement channelWhere FlaviBot posts music announcements, how to send them all to one channel, which message types get announced, and where they go when nothing is set.
- 08AutoplayKeep FlaviBot playing when the queue runs out: turning autoplay on, its three modes, personal and server defaults, and teaching or blocking what it picks.
- 09The web playerControl FlaviBot's music from a browser: opening the web player, how it finds your voice session, what you can do there, and turning it off for a server.
- 10PlaylistsPersonal and server playlists in FlaviBot: create, fill, play, reorder, share and delete them, who can change a server playlist, and playlists built for you.
- 11DJ modeFlaviBot DJ mode decides who may play, skip, stop or change the volume: turning it on, how allow and deny entries combine, the actions, and a worked example.
- 12Restricting the bot to certain voice channelsKeep FlaviBot's music in the voice channels you choose with /setvc or the dashboard, including categories, what members see and when the list is checked.
- 1324/7 modeKeep FlaviBot connected to one voice channel with 24/7 mode: the Premium requirement, the commands, reconnects, and what it plays when the queue is empty.
- 14SpotifyPlay Spotify tracks, albums and playlists with FlaviBot, link your Spotify account to reach your own public playlists, and copy one into a FlaviBot playlist.
Moderation
6 pagesSanctions, the case history, automod and server logs.
- 01How moderation worksHow FlaviBot moderation works: the case and action it records for every sanction, the commands, who is allowed to moderate, and the guard rails in place.
- 02The sanctionsEvery FlaviBot sanction command, from note, warn and mute to kick, ban, tempban and softban, plus unban, the duration syntax and prefix use.
- 03Mod-log, DMs and auto-escalationWhere moderation events are posted, what the sanctioned member is told, and how warns turn into automatic sanctions.
- 04Cases and historyLook up a FlaviBot moderation case, read a member's record in Discord or on the dashboard, correct a reason, and revoke a sanction without erasing it.
- 05Discord AutoModManage Discord's own AutoMod rules from the FlaviBot dashboard: what a rule watches, what Discord does, exemptions, templates, and warns handed out on a hit.
- 06Server logsFlaviBot server logs: a written record of what happens on your server, with log categories, the audit log badge, per-category channels, filters and bursts.
Levels and economy
8 pagesXP, rank cards, role rewards, coins and the shop.
- 01Levels and economyFlaviBot's two reward systems: XP that turns into levels, and a per-server coin economy members spend in your shop. Where each lives and what members can run.
- 02How XP is earnedHow FlaviBot grants XP for messages and time in voice: the cooldown, voice ticks, the XP rate, per-role multipliers, and restricting where XP is earned.
- 03Levels and role rewardsThe FlaviBot level curve and maximum level, role rewards handed out as members climb, editing XP by hand, and resetting a member or the whole server.
- 04Level-up announcementsWhere FlaviBot posts the level-up message, what you can write in it, using an embed instead, the separate voice message, and reacting with an automation.
- 05The rank card and the leaderboardWhat FlaviBot's /rank card shows, how far you can redesign it with templates and per-role cards, and how the leaderboard and its visibility work.
- 06Currency and balancesName your FlaviBot economy's currency, understand wallets and the account age gate, read the record of every movement, and correct a member's balance.
- 07Earning coinsThe eight earning rules that pay coins in a FlaviBot economy, what each one pays for, how many rules you can have, and paying coins from an automation.
- 08The shop, items and tradingBuild a FlaviBot economy shop with categories, items and sales, set purchase requirements, and let members send coins, trade and use the marketplace.
Engagement
7 pagesWelcome messages, starboard, giveaways, suggestions, birthdays.
- 01What the Engagement module coversThe six FlaviBot Engagement features, where each lives on the dashboard, and what they share: channels, embeds, variables, permissions and auto-disable.
- 02Welcome and goodbye messagesGreet new members with FlaviBot, hand them roles, send a join DM, say goodbye when they leave, and design the card image that goes with the message.
- 03StarboardLet members pin the best messages themselves: FlaviBot reposts a message to your starboard channel once it gets enough reactions. Setup, filters, forums.
- 04SuggestionsCollect member ideas in one channel with FlaviBot: submit with a command, vote on each suggestion, then mark it approved, rejected or implemented.
- 05GiveawaysRun prize draws with FlaviBot: who can run one, starting and managing a giveaway, entry requirements, premium options, limits by tier, and winner DMs.
- 06BirthdaysAnnounce members' birthdays with FlaviBot: the server settings, how each member opts in, when announcements go out, and the optional birthday role.
- 07Feed announcementsPost new YouTube videos, Twitch and Kick streams, and Reddit posts with FlaviBot: adding a subscription, how fast each source is, the message and filters.
Events
7 pagesRSVP panels, the calendar, recurring series, teams, boards and the public page.
- 01How events workHow a FlaviBot event works: the objects involved, the path from creation to RSVP panel and reminders, sign-up slots, the participant role, commands and limits.
- 02The calendarDay, week, month and agenda views, the sidebar, dragging events around, the form behind every event, and managing who is coming.
- 03Recurring eventsA repeat rule, the occurrences it produces, how many get a panel ahead of time, and what editing one of them means.
- 04Discord scheduled eventsMirror an event into your server's Events tab, the Create Events permission it needs, and what to do when the sync fails.
- 05Teams and finding a timeGroup members into teams, invite a team to an event, see when its members are free, and let FlaviBot suggest a slot.
- 06Google Calendar and ICSThree ways to get FlaviBot events into a real calendar, and what connecting a Google account does and does not let FlaviBot see.
- 07The public calendar and boardsA public web page and feed for the events you choose to show, and a channel message that keeps the schedule in front of your members.
Projects and tasks
10 pagesProjects, issues, the board, states, labels and cycles.
- 01How projects and tasks workProjects, issues, states, labels and cycles, what an identifier like WEB-12 means, and how the Discord half meets the dashboard.
- 02The board and the issueDragging cards between columns, the filters, the list, everything the issue page holds, relations, Markdown, templates and archiving.
- 03Projects, states and labelsCreating a project and its key, archiving one, editing the columns of its board and their WIP limits, and the labels the whole server shares.
- 04CyclesTime-boxed slices of a project's work, what a cycle page counts, the burn-up, completing a cycle and rolling the rest over, velocity, and the patch notes a cycle writes for you.
- 05The Discord sideThe /task command, the issue card and its buttons, linking an issue, the thread, the direct messages, and what each refusal means.
- 06Views and shortcutsBoard or list, grouping, swimlanes, WIP limits, saved views and the three built-in ones, the command palette, and every keyboard shortcut.
- 07Estimates, time and teamsSizing issues on a scale, the two estimate settings, a time estimate against the time actually logged, the running timer, and putting an issue on a team.
- 08GitHubConnecting a server to GitHub, linking repositories and what each toggle does, the magic words that attach a pull request, what a merge moves, and what is deliberately left out.
- 09Doc pagesThe pages that live next to the issues — a project's docs and the server wiki, the tree they sit in, writing them in Markdown, how WEB-12 links both ways, history and restore, templates, archive versus delete, search, and who may do what.
- 10Customers and requestsWho asked for a piece of work and how they hear when it ships — customers, including people who are not in your server, the requests filed on an issue, the four ways one is filed, the direct message an issue's close sends, folding a request into the right issue, important requests, merging, archiving, the limits and who may do what.
Tickets
6 pagesPanels, categories, transcripts and the dashboard inbox.
- 01How tickets workHow FlaviBot tickets work: panels, ticket channels and labels, the path a ticket takes from click to close, how many panels you get, and what the bot needs.
- 02Setting up a panelSet up a FlaviBot ticket panel: its channels, the two messages, channel names, what happens on click, labels, business hours, pricing and response targets.
- 03When someone opens a ticketThe checks FlaviBot runs when someone opens a ticket, the category, channel and permissions it builds, failures, opening one for a member, and blocking members.
- 04Handling a ticketHandle a FlaviBot ticket: statuses, claiming, escalating, pulling people in, private staff notes, inactive tickets, and letting the assistant answer first.
- 05Closing, reopening and transcriptsWho can close a FlaviBot ticket, what closing does to the channel, reopening and deleting, channels deleted by hand, transcripts, and member feedback.
- 06The dashboard sideAnswer tickets from the browser, read the timeline, and give your support team access without giving away the server.
Forms
3 pagesQuestions, who can answer, responses and ban appeals.
- 01How forms workHow FlaviBot forms work: the path a response takes, where you build a form, whether answering needs a Discord account, who can answer and how many you get.
- 02Building a formThe five steps of the FlaviBot form builder, the ten question types, showing a question only sometimes, pages, access, scheduling, and publishing.
- 03Responses and ban appealsWhere a FlaviBot form response lands, who may review it, what accepting or denying does, the response statistics, and how ban appeal forms differ.
Temporary voice
4 pagesSelf-serve voice rooms and the control panel.
- 01Temporary voice channelsFlaviBot temporary voice channels: a member joins one channel to get a room of their own, deleted once it empties. What happens, and what to set up.
- 02Creator channelsSet up a FlaviBot creator channel: the settings for the rooms it hands out, the naming template, what a room inherits, running several, and the Health column.
- 03The control panelEvery button on the control panel FlaviBot posts in a temporary voice room: who may use it, rename, user limit, lock, hide, allow, block and kick.
- 04Ownership and claimingWho owns a FlaviBot temporary voice room, the one-room-per-member rule, transferring ownership, claiming an abandoned room, and what happens when it ends.
Premium
6 pagesWhat each tier adds, and how to activate it.
- 01What Premium isWhat FlaviBot Premium changes: the three levels features sit behind, the two halves of a subscription, and where to find plans and your own subscription.
- 02User premium and server premiumA FlaviBot subscription belongs to your account, and premium on a server is a slot you spend from it. What each half unlocks, and which limits count where.
- 03Silver, Gold and PlatinumThe three FlaviBot Premium plans on sale, Silver, Gold and Platinum, what each one adds over the plan below it, extra custom bots, and the retired Bronze tier.
- 04Activating premium on a serverBuying FlaviBot Premium does not upgrade a server by itself. Activate it from Discord or the dashboard, check it worked, read the refusals, and move it.
- 05Changing and cancellingTake FlaviBot Premium off a server, change plan, deal with a failed payment, cancel your subscription, and see what happens when the last one ends.
- 06Limits by tierEvery FlaviBot Premium limit per plan in one place, from music, levels and economy to automation and engagement, plus the features that are simply on or off.
89 pages so far. More sections land as features get written up; the sidebar always lists everything that exists.