Changelog
What's new and what's fixed in FireFly. Newest first. Currently on 5.28.
๐ The Overview is now a dashboard you can arrange
Press Customize on the Overview to make it yours. Nothing changes until you do: the standard layout is the Overview you already know.
- Add, remove, move and resize modules. Drag a module to move it (or use the arrows), make it half or full width, or remove it. Half-width modules sit side by side.
- Save for me: your own layout, saved to your account, so it follows you to any device.
- Save for everyone (admins): the server's layout, which every staff member sees unless they've made their own. Moderators can arrange their own dashboard too.
- Reset goes back to the server's layout or the standard one.
- Also in Ctrl+K: "Customize the Overview".
New modules, alongside the classic ones (server card, server numbers, this week, new members, recent activity, lockdown, invites, what FireFly is doing):
- Inbox: how many ModMail threads, reports and approvals are waiting.
- Recent moderation: the latest warnings, timeouts, kicks and bans.
- Staff note: one shared note every staff member sees. Reminders, plans, who to keep an eye on.
- Quick actions: buttons for the things you do most.
- Top members: the five members with the most XP.
- Upcoming events: what's next and how many are going.
- Today's quests: today's daily quests and how many finished each.
- Busiest channels: where people talked most this week.
- Quiet newcomers: people who joined in the last month and haven't said anything yet. A good list for a friendly hello.
- On call and incidents: who's on call, who's next, and any open incidents.
A module only shows what you could already see on its own page, and modules for switched-off features tell you so with a button to set them up.
Fixed
- The "Send me a test" button meant for the ticket button ended up in the Create invite box. It's back where it belongs.
๐ป Developer tools (Automation โ Developer tools)
For teams that build software and use Discord as their chat.
Repository feed and webhooks
- Connect GitHub or GitLab and FireFly posts what happens in a channel: new commits, pull/merge requests (opened, merged, closed), reviews, issues, releases and new stars.
- CI: a failed run or pipeline is posted, and so is the moment it passes again. Passing runs stay quiet.
- Pick which events, and limit it to some branches (
main, release/*). Drafts aren't posted.
- Releases can go to their own channel and ping an opt-in role.
- Your own tools: a connection with an address your deploy script, monitoring or cron job can post to, as plain text or JSON (title, description, colour, fields). Nothing posted this way can ping anyone.
- Every connection is checked: GitHub deliveries must carry the right signature and GitLab ones the right secret. Each has a Send a test post button, shows when it last heard something, and says plainly what's wrong if a delivery fails. Make a new address replaces a leaked one at once.
- Up to 15 connections per server.
GitHub link previews
- Paste a link to an issue or pull request and FireFly shows its title, status, labels and who it's assigned to.
- Paste a link to some lines of code (
โฆ/blob/main/app.py#L10-L20) and FireFly shows those lines, up to 30.
- Works for public repositories straight away, and private ones with a GitHub token.
Issues from Discord
- Staff right-click a message โ Apps โ Create issue (or use
/issue). The issue links back to the Discord message, gets your labels, and FireFly says so in the same place when it's closed.
- The bot's owner adds the GitHub token on the dashboard. It's saved in the
.env file and never shown again.
Daily standup
- At the time you pick, on the days you pick, FireFly DMs everyone with the team role a button and up to 5 questions. Answers go into one summary in a channel that updates as people answer, showing who's off and who it's still waiting for.
- I'm off today button,
/standup for anyone with DMs closed, and an optional nudge after 2 hours.
On-call rota
- Put people in order, choose daily or weekly handovers and the hour, and the on-call role moves to the next person by itself. Handovers can be announced.
/oncall now shows who's on call and who's next. /oncall cover hands over the rest of a shift.
Incidents
/incident open makes a channel for it, pins a status card, pings whoever is on call and your incident role, and announces it.
- Post updates with a button or
/incident update: they build a timeline on the card. Resolve asks what happened and posts a summary with how long it took.
- The dashboard lists recent incidents.
๐งโ๐ป New server template: Developer team
- Channels for the team, engineering (code review, help, bugs), feeds (commits, CI, releases, deploys), operations (on-call, incidents) and voice rooms for standup and pairing.
- Roles: Tech lead, Developer, On-call, Release pings and Guest (guests can't see the engineering channels).
- Applying it switches on link previews, a weekday standup for @Developer in #standup, the on-call role and incidents under Operations.
Also: the new commands are in /help under Developer tools, standup answers are included in /mydata, and Developer tools settings can be copied to another server (the webhook addresses aren't).
Two Branding fixes
- The server's icon now shows in the sidebar. With "This server's icon and name" picked, the sidebar showed the server's initials instead of its icon. It was looking for the icon in the wrong place.
- The Upload button for a background picture sits next to its text instead of far away at the right edge of the card.
Back to the 5.24 layout
- The server map, the timeline under it and the click-to-edit message boxes from 5.25 have been taken out again. The dashboard opens on the Overview as before, and the welcome, goodbye and level-up messages are plain text boxes again.
- Everything else is exactly as it was in 5.24: quests, badges, /profile, the anti-spam check, quiet channels, compact view and the rest are all still here.
- If you had opened the server map, the dashboard simply opens on the Overview now. Nothing you saved is affected.
๐บ๏ธ A new Home: the server map (Home โ Server map)
The first step of the dashboard redesign. Instead of starting from FireFly's list of features, Home now starts from your server.
- Your real categories and channels, with what FireFly does shown on each one: the welcome message on #welcome, the count on #counting, quiet channels, role menus, alerts, sticky messages, scheduled posts, form and ticket buttons, the mod log and more.
- Pick a channel and the panel on the right lists everything that happens there. Edit takes you straight to that setting and lights it up.
- A dot per channel shows how alive it is: brighter means busier this week, hollow means no chat. An orange dot means something there is waiting for staff (unanswered ModMail, reports, suggestions or appeals), with the number next to it.
- Add something to this channel lists what you can set up there.
- Across the whole server shows the features that aren't tied to one channel (protection, levels, coins, backups, AIโฆ) and whether each is on.
- "Only channels FireFly uses" hides the rest when you have a lot of channels.
- The dashboard opens on the map once after this update. Overview is still there, one tab over, and nothing else has moved.
๐ One timeline (under the map)
- Everything that happened, newest first, in one list: log entries, settings changes, and deleted or changed channels and roles.
- Undo is on the line itself for anything that can be undone: a settings change goes back, a deleted channel or role comes back.
- Filter by Moderation, Members, Settings, or Channels & roles. The full Logs and Audit log pages are one click away.
โ๏ธ Edit what members see (welcome, goodbye and level-up messages)
- These messages are now shown the way they look in chat, with FireFly's name and the BOT tag. Click the message to change it, click away and it shows the result.
- Words that change for each person ({user}, {server}, {count}, {level}) are filled in and highlighted, so you see a real example and not the code.
- Add buttons drop those words in where your cursor is, so you don't have to remember them.
- Turning "Show as an embed" on or off changes the preview straight away.
- Works in light mode and compact view. More messages (rules, tickets, quests) will follow the same pattern.
๐ฏ Daily quests (Community โ Quests & badges)
- Every day the whole server gets the same few small goals, like "send 15 messages", "solve today's /word" or "play 3 casino games". Members see them with /quests, with a progress bar for each.
- Finishing a quest pays coins (and the same amount of XP if Levels is on). Finishing all of them pays a bonus and builds a daily streak.
- Quests are only picked from features you have switched on. Nine kinds: chatting, /daily, /work, counting, the word game, trivia, the casino, reacting to messages and time in voice.
- You choose how many a day (1 to 5), the reward, the bonus and which kinds can come up.
- When someone finishes one, FireFly says so with a quiet message that disappears after 25 seconds (you can turn that off).
- Fair play: chat messages only count once every 8 seconds, reactions to your own messages don't count, and voice time needs someone else in the channel.
- The dashboard shows today's quests, how many members finished each and your top questers.
- Off by default.
๐
Badges and /profile
- /profile shows a member's level, coins, streaks and badges. Anyone can look at their own or someone else's.
- 21 badges to collect: levels 5/10/25/50, 1,000 messages, coins earned, /daily streaks, word-game streaks, trivia wins, a legendary shot on the dealer, starboard posts, quests done, a year in the server and boosting.
- Badges are worked out from what FireFly already keeps, so long-time members get theirs the first time they look. New ones are called out on your own profile, along with the next three you could earn.
- /quests and /profile are in /help, and quest progress and badges are included in /mydata (view and delete).
๐ "What would this have caught?" (Safety โ Protection โ Anti-spam)
- Before you switch anti-spam on or change its numbers, press the new button. FireFly reads the recent chat in your busiest channels (up to a week back) and shows who those settings would have caught, how often, and what they wrote.
- It uses the numbers on the page even if you haven't saved them. Nothing is changed and nobody is punished.
- It also lists any known or look-alike scam links in those messages, and tells you if the scam-link filter is off.
- Staff and ignored roles are left out, exactly as they would be for real.
๐ Overview: this week at a glance
- Four new tiles under the server numbers: messages, people chatting, joined and left this week, each with a 14-day trend line and the change from the week before. Click one to open Insights.
๐ฐ Weekly report: highlights
- The Monday report now ends with the fun numbers for whatever you have switched on: the biggest casino win of the week, new starboard posts, where the count is, how many members did quests and solved the daily word, and the longest streaks.
๐ Quiet channels (Server โ Quiet channels)
Discord doesn't let any bot mute a channel for your members: muting is each person's own setting. So FireFly now does the two things a bot *can* do for busy channels like mini-games, counting or bot commands:
- Silent channels: tick a channel and everything FireFly posts there is sent silently: no sound, no phone notification, no red badge. Game results, level-ups and counting replies stop buzzing people.
- Optionally FireFly also doesn't ping anyone in those channels (names still show, they just don't notify). On by default.
- It covers every FireFly feature, including slash-command replies and threads inside the channel. Messages from members aren't affected.
- One click posts and pins a "how to mute this channel" note for members who want it quieter still.
- Opt-in channels: the channel is hidden from everyone until they press a button. Nobody sees or hears it unless they ask to, which is the only way to make a channel quiet by default for the whole server.
- FireFly makes the role, sets the channel permissions and posts a "Show or hide" button. Members press it once to see the channels and again to hide them.
- Untick a channel and FireFly puts its permissions back exactly how they were.
- A channel that's already private can't be made opt-in (that would let anyone in with one click), and neither can your rules or system channel.
- The page shows your busiest channels this week as candidates.
Compact view
- A new button at the bottom of the sidebar (next to light/dark) switches the whole dashboard to a tighter layout: smaller cards, thinner rows, one line per member on Members and shorter entries on Logs, so more fits on screen. Also in Ctrl+K ("Compact view"). Remembered per browser.
Copy setup from another server, finished (Settings โ General)
- Preview first. Pressing the button now shows exactly what would happen before anything changes: what gets added, what's already here and skipped, and which channels and roles the other server uses that this one doesn't have.
- Pick which features' settings to copy (welcome, moderation, protection, levels, coins and games, community, AI, brandingโฆ) instead of all or nothing.
- Four more things can be copied: YouTube/Twitch/RSS alerts, scheduled posts, sticky messages and shop items.
- Copied alerts remember what was already announced, so nothing old gets posted again.
- One-off scheduled posts that already went out aren't copied.
- Copying twice no longer makes duplicates. Automations, forms, auto-replies, commands, alerts, scheduled posts, stickies and shop items that are already here are skipped.
- Fixed: copying ignored the plan's limits, so a free server could end up with more custom commands, forms or auto-replies than it's allowed. It now copies up to the limit and tells you how many were left out.
- Silent-channel settings are copied with the rest; opt-in channels aren't, because they change channel permissions and are set up on their own page.
๐ช Better coins for the daily word game (/word)
- Fewer guesses pay more. Your "Coins for solving the word" setting is now the prize for solving it in 6. Solving it faster pays more: 3ร in 1 guess, 2.5ร in 2, 2ร in 3, 1.5ร in 4 and 1.25ร in 5. With the usual 50, that's 150, 125, 100, 75, 63 or 50.
- Streaks pay a bonus: +10% for each day of a streak after the first, up to double at 11 days in a row.
/word now tells players how much they can win today, and both the private result and the post in the channel say how much they won.
- The dashboard (Games โ Mini-games) shows the whole prize table as you type. Untick Pay more for fewer guesses and for daily streaks to go back to one flat prize.
- As before, coins are only paid while the server's economy is on.
Quality of life: 11 smaller things that make FireFly nicer to use every day
In Discord
- Right-click menus: right-click (or long-press) a member โ Apps:
- Rank card shows their level.
- Profile (staff) shows their info.
- Warn (staff) asks for a reason, then warns them.
- Right-click a message โ Apps:
- Summarize from here (AI) catches you up from that message onwards. Only you see it.
- Add to starboard (staff) puts a great message on the starboard without waiting for stars.
- A smarter /help: it only lists what's switched on in your server, hides staff commands from members, and has a button per category with a one-line description of every command.
- Friendlier counting:
- "hundred ten" now counts as 110 (you don't need "one hundred ten").
- When someone breaks the chain, FireFly says what they wrote and what the right number was.
- Staff get a ๐ Put the count back button, for when a long chain was broken by accident or by a troll. It only works if nobody has started counting again.
On the dashboard
- Ctrl+K finds settings, not just pages. Type "embed", "goodbye" or "cooldown" and jump straight to the card, which lights up so you can see it.
- "Changed by Maya ยท 2 days ago" under each settings card. Click it to see every change to that card and undo any of them.
- Send me a test: welcome, goodbye, level-up, rules, ticket button and custom-role panels can be sent to your own Discord DMs as a private preview. Nobody else sees it. (The old test that posts in the channel is still there, now called "Test in the channel".)
- Members: you can now warn several ticked members at once, with one reason.
- Saved filters on Logs and Members: set up a filter, press Save this filter, and it's one click next time. Saved in your browser, per server.
- Alerts in your Discord DMs (Settings โ Dashboard access): each staff member picks which alerts they get by DM (ModMail, reports, rogue-staff alerts, approvals, data requests, custom roles to checkโฆ), with optional quiet hours. At most one DM per kind every 2 minutes.
- What's new: after FireFly updates, admins see a short "What's new" card on the Overview. It's also in Ctrl+K.
Safer updates
- If a new version can't start, FireFly puts the old one back by itself. After an update the new version is "on trial". If it crashes while starting, or stops 3 times in a row before getting online, FireFly copies the previous version back, restarts, DMs the bot owner, and shows a red "Update was undone" button on the dashboard with the details.
- After a minute online without trouble, the update counts as good.
- Your
.env, data and backups are never touched by any of this.
- Works for Update now on the dashboard and for
update.sh / update.bat.
Fixed
- On the Overview's "Needs attention" list, the See Premium button did nothing when the item's title had an apostrophe ("You've used all 5 custom commands").
๐ซ Shoot the dealer (just for laughs)
- When: after you lose at blackjack, roulette or higher or lower, a ๐ซ Shoot the dealer button appears.
- The button: it only works for the person who lost, once, within a minute. It fires a water pistol at the dealer.
- What can happen:
- ๐ Dodge: the dealer ducks behind the chip tray, opens a tiny umbrella, or turns out to be a cardboard cutout.
- ๐ฆ Soaked: the dealer storms off, a mop comes out, and a new dealer takes over the table. Every server keeps count: "Dealer #14 Disco Dennis".
- ๐ฏ Legendary shot: the toupee lands in the punch bowl.
- ๐คฆ Backfire: your pistol was pointing the wrong way.
- ๐จ Security: they take your water pistol and you're out of the casino for 60 seconds.
- It never changes anyone's coins, so the casino odds stay exactly the same.
- The dealer has a name: "Dealer #3 Slick Rick wins." in blackjack.
- On the dashboard: a "Dealers soaked" leaderboard in the Casino card, and a switch to turn the whole thing off (Community โ Games โ Casino).
- Roulette: you can now bet on Green (0), which pays 35:1. Before, betting on 0 meant choosing "One number" and typing 0.
Fixed: "Unknown interaction" errors on buttons that change roles.
Discord only waits 3 seconds for a reply to a click. When changing someone's roles took longer than that (Discord rate limits, a busy moment, swapping roles in a "pick one" menu), the role still changed but the reply failed and the error log filled up.
- Affected: role menus, rules Accept, verification, event RSVP roles, shop items that give a role, and custom commands that toggle a role.
- These now tell Discord "working on itโฆ" first, then change the roles, then answer. People see a brief "FireFly is thinkingโฆ" instead of an error.
- If Discord refuses the change, the person now gets a clear message instead of nothing.
Light mode
- Three choices: Dark, Light, or Same as my device (follows your computer or phone and switches with it).
- Changing it: click the โ/โพ button at the bottom of the sidebar, or search "colours" with Ctrl+K.
- It's personal: each person picks it for their own browser. It doesn't change anything for other staff, or in Discord.
- What's covered: every page, pop-up, tag, chart and the sign-in screen, with no flash of the wrong colours while loading.
- Server dashboard looks: a server's Dashboard look still applies its brand colour, fonts and corners in light mode. Its colour scheme only applies in dark mode, since those schemes are dark.
- Discord previews (messages, cards) stay dark, like Discord itself.
Look and feel
- Unsaved changes are never lost by accident:
- Edit something and a dot appears on that card, plus a bar along the bottom: "You have unsaved changes ยท Discard ยท Save all".
- Leaving the page, switching servers or closing the tab asks first.
- If someone else changes the same page while you're editing, FireFly no longer overwrites your edits. It tells you instead.
- "Deleted ยท Undo": deleting a custom command, auto-reply, automation, scheduled post, alert or shop item no longer asks "are you sure?". It deletes straight away and shows an Undo button for a couple of minutes.
- Needs attention at the top of Overview lists only what needs someone, most urgent first:
- Inbox items, data requests and custom role approvals
- Health-check problems
- Features switched on but not finished, like counting with no channel, rules not posted or the custom-role panel not posted
- Free-plan limits you've hit
Each one has a button that takes you to the fix. When nothing's wrong it says "All good".
- Loading placeholders instead of blank pages while a page loads.
- Toasts: the same message no longer stacks up, at most 3 show at once, and on phones they sit above the bottom bar.
- Phones: the top of the screen is now one slim bar with the server picker and page menu. Help, refresh and log out are in the Menu.
New navigation
The dashboard is regrouped by what you're trying to do, with no group over 7 pages:
| Group | Pages |
|---|---|
| Home | Overview, Inbox, Insights, Explore |
| Moderation | Members, Messages, Cases & warnings, Bans & appeals, Logs, Audit log & undo, Staff |
| Safety | Protection & verification, AutoMod, Backups |
| New members | Welcome & goodbye, Rules, Role menus, Custom roles, Preview as a new member |
| Community | Levels, Economy & shop, Games, Events, Polls & giveaways, Starboard & birthdays, Suggestions |
| Support | Tickets, Forms |
| Automation | Automations, Auto-replies, Custom commands, Scheduled posts, Alerts |
| โจ AI | AI helpers |
| Server | Channels, Roles, Permissions, Voice channels, Cleanup, Templates |
| Settings | General, Branding, Dashboard access, Plan, Privacy & data requests |
Split pages:
- "Welcome & logs" โ Welcome & goodbye and Logs.
- "Economy & games" โ Economy & shop and Games (casino, trivia, word game, counting, party games).
- "Starboard & more" โ Starboard & birthdays and Voice channels.
- Settings โ General, Dashboard access and Plan.
- Cases and Warnings share a page, with a switch at the top.
Also new:
- Green dots show which features are switched on, and "Show only what's switched on" hides the rest.
- Favourites: click โ on any page to pin it to the top of the sidebar.
- Recently visited pages come first in Ctrl+K search.
- Inbox also shows data deletion requests and custom roles waiting for approval, and they count towards the Inbox badge.
- Phones get a bottom bar: Home, Inbox, Members, Favourites, Search and Menu.
- Old links like
#automation and #community still work.
Logs page (Moderation โ Logs)
- Searchable history: everything FireFly logs is kept for 30 days and searchable, even when the mod-log channel is off.
- Filters: kind, event ("Message deleted", "Member joined"โฆ), person (name or ID), channel, date range and text. Each entry has a Profile button and "More like this".
- Fine-tuning the mod log:
- Turn individual events off without losing them from this page.
- Ignore channels for message and voice logs.
- Send each kind (members, messages, moderation, server, voice, access) to its own channel.
- Log entries about a person are included in
/mydata.
Custom roles: refused names are logged
- Whenever FireFly refuses a custom role name, staff are told. That covers the word filter, a rude emoji icon, a staff-sounding name or the AI check.
- Mod log: each refusal is posted to the mod log (moderation) with who tried it and why. The name is hidden behind a spoiler so nobody sees a slur by accident.
- Repeat attempts: 3 refused names from the same person in a day are marked โ ๏ธ and send a dashboard notification.
- Refused names list on the Custom roles page: who, when, what stopped it and how many tries they've made. Names stay hidden until you click them, and there's a Profile button. You can clear one person's tries or all of them.
- Not logged: ordinary mistakes like a name that's too long, already taken or a staff colour.
- You can turn off the mod log posts. The dashboard list is always kept, for 90 days.
- Refused names are included in
/mydata (as moderation records).
Custom roles (Community โ Custom roles)
Members make a role that's just theirs: a name, a colour and, on servers with Boost level 2, an emoji icon.
- The panel: pick a channel and click Post the panel. Members use the ๐จ button there to create or change their role, or remove it.
- One per person: making a new one changes the role they already have.
- The roles are cosmetic only: no permissions, not shown separately in the member list, not mentionable. They sit right under FireFly's role so the colour shows, or above a role you pick.
- Keeping names clean:
- FireFly's filter refuses sexual, vulgar, hateful, drug-related and staff-sounding names, and links.
- It catches tricks like f.u.c.k, 5h1t, fuuuck, accented letters and invisible characters, without blocking innocent words like *Class*, *Grape*, *Assassin* or *Scunthorpe*.
- Your server's own Discord AutoMod keyword lists apply too, plus any extra words you add (* for "anything").
- If AI helpers are set up, the AI double-checks names the filter let through.
- Rude emoji icons (๐๐๐ฆโฆ) are refused, and colours that look like your staff roles' colours can be blocked.
- Try a name on the dashboard to see if it would pass.
- Optional staff approval: roles wait in a channel (or the mod log) with Approve and Deny buttons, or on the dashboard. The member gets a DM either way.
- Who can make one: limit it to members with certain roles (boosters, level 10โฆ), to people who've been in the server a while, and to one change per hour, day, week or month.
- Staff control: see every custom role on the dashboard. Rename, recolour or remove any of them, with an optional DM.
- Clean-up: roles are deleted when their owner leaves, and are included in
/mydata (deleting your data deletes your custom role).
Clearer Premium on free servers
- โจ markers: Branding and AI helpers show a โจ in the sidebar and in the tabs along the top, so you can tell they're Premium before opening them.
- Limit counts on Add buttons: buttons like New command, New form, New alert, New automation, Add shop item and New auto-reply show how many you've used, e.g. "4/5". The count turns red when you're out, and hovering says how many Premium allows.
- Better upgrade pop-up: it lists everything Premium adds (now including AI helpers and Branding) and every higher limit. When Premium isn't set up in Discord yet, the bot owner gets a hint on how to add the Subscribe button.
- No more silent features:
- Mentioning @FireFly on a free server gets a friendly "chatting is part of Premium" reply with the Subscribe button, at most once per channel every 6 hours.
- Turning on voice XP or daily backups without Premium now shows the upgrade pop-up instead of saving a setting that would do nothing.
- If one was already switched on from before, the dashboard says "not active on the free plan".
Fixed: Higher or lower paid out too much.
A tie is a free re-guess, but the multipliers were priced as if ties lost. That gave players about 2.7% profit on every guess, so someone could farm coins by always taking the safe side.
- The multipliers now keep a 5% house edge on every guess. Examples: 7 โ 1.89ร, 2 โ higher 1.03ร, Q โ higher 11.4ร.
- On an ace (higher) or a king (lower) you can't lose, so that guess is now "safe, 1ร": it turns over the next card without changing your pot.
Checked and correct:
- Slots return 92.85% over time.
- Roulette is a European wheel, returning 97.3% on every bet.
- Blackjack returns about 99.4% with good play: 3:2 for a blackjack, dealer stands on 17, double on the first two cards, no splitting.
- Coin flip, duel and rock paper scissors are a fair 50/50.
- Jackpot pot odds match each person's share of the pot.
Also fixed:
on a server that had only just restarted, /mydata could say "ask again in a few minutes" the first time, and RSS/YouTube alerts waited 5 minutes for their first check.
Dashboard look (Premium, Server โ Branding โ Dashboard look)
Make the dashboard feel like your server. Settings are per server, and everyone managing that server sees them.
- Midnight (FireFly), Ocean, Forest, Ember, Grape, Rose, Slate, Pure black.
- Brand colour, a dark scheme tinted with your brand colour.
- Headings: Sora, Space Grotesk, Outfit, Fredoka, Playfair Display, Bebas Neue, Press Start 2P or Nunito.
- Text: Inter, Nunito, Atkinson Hyperlegible (easiest to read) or the device's own font.
- Corners: round, soft or sharp.
- Background:
- Plain, a glow in your brand colour, the server banner, or your own picture.
- Pictures under 8 MB are resized to fit.
- Dim and blur sliders keep text readable.
- Sidebar: show the server's icon and name instead of the FireFly logo.
- Public pages: you can optionally use the same colours and heading font on the server's public leaderboard and ban-appeal pages.
- Live preview: every change shows on the dashboard straight away while you're on the Branding page. Leave without saving and it goes back.
- Copy from another server includes the background picture.
Cleanup advisor (Server โ Cleanup)
- Finds what your server has outgrown:
- Quiet channels with no messages for 60 days (you can pick 30 days to a year). Text channels are checked from Discord's own history, so they show up straight away.
- Voice channels nobody has joined, and categories with nothing in them.
- Roles nobody has, and duplicate roles with the same name.
- Custom emojis nobody uses (in messages or reactions).
- Anything FireFly or Discord uses (welcome channel, mod log, reward roles, the rules channelโฆ) is never suggested. Click Keep on anything else that's there on purpose.
- Archive hides a channel in a read-only "๐ฆ Archive" category that staff can still read. Bring back puts it where it was, with its old permissions.
- Deleted channels and roles can be undone from the Audit log page. Deleted emojis go into a recycle bin for 30 days.
- Deleting things here asks a second admin first when two-person approval is on.
- Voice and emoji use is counted from now on, so those suggestions start appearing once FireFly has watched for the number of days you picked.
Member data requests (/mydata, plus Server โ Data requests)
/mydata view shows a member what FireFly keeps about them and gives them a full copy as a file. It's only visible to them.
/mydata delete deletes their own data straight away: level, coins, game stats, birthday, reminders, AFK status, RSVPs and similar.
- Moderation records (warnings, cases, staff notes, tickets, ModMail, form answers, appeals) aren't deleted automatically. The request comes to the dashboard, where staff click Delete records or Keep (with a reason). The member gets a DM either way.
- Members see how many staff notes there are, never what they say.
- Used in a DM with FireFly,
/mydata covers every server the member shares with it.
- Staff can look up any member by ID to download their copy, or delete their data for them (for requests made by ModMail or email).
- The privacy policy on fireflybot.net explains all of this.
- Counting catches up after FireFly was offline (an update, a restart, an outage). When it comes back, it reads what was counted while it was away:
- Right numbers carry the count on, and the people who counted them get their coin rewards.
- Mistakes made while nobody was watching are forgiven instead of resetting the count.
- It posts one short note, for example *"I was offline for a bit and caught upโฆ the next number is 61."*
- Before, the first person to count after FireFly came back was wrongly marked as breaking the chain.
Off-server backups to Cloudflare R2 (Bot owner โ Backups)
- Every day FireFly makes a complete backup: all servers' data (settings, levels, coins, warnings, cases, ticketsโฆ),
secret.key, .env and server structure backups. It's encrypted with your backup password (AES-256) and uploaded to your own Cloudflare R2 bucket, which is free up to 10 GB.
- Old backups are removed after the number of days you choose (30 by default). Back up now and Download a backup buttons are there too.
- If a daily backup fails, FireFly DMs you.
- Restoring:
- On a new server, put the .ffbak file in the FireFly folder and run bash install-linux.sh. It finds the backup, asks for the password and brings everything back, bot token included.
- On the same server, run bash restore.sh <file>. On Windows, run python restore.py <file>.
- What was there before is always moved aside, never deleted.
- A step-by-step setup on the dashboard; R2 keys are tested before they're saved and never shown again.
- New requirement:
cryptography, installed automatically by Update now.
Fixes
- Emergency access works again. On a server you can't open, the dashboard asked for the inbox count, got "private" back, redrew the page, and asked again in a loop (hundreds of times a second), so the emergency button couldn't be clicked. Fixed, and a "private" answer can no longer start a loop.
- The emergency access banner now says you opened it and the owner was told, instead of "the server let you in".
- The installer no longer shows a harmless
.env warning when restoring.
- Fixed an error in the log (
int() argument must be ... not 'NoneType') when Discord sends an audit log entry with no target. The undo history, mod cases and the "who added FireFly" check now skip those entries instead of crashing.
- Blackjack says how it pays: "Blackjack pays 3:2 ยท other wins pay 1:1" is on every game, and wins show what comes back (for example *Blackjack! You won 150 (3:2, you get 250 back)*).
- A blackjack on an odd bet now rounds the 3:2 win up in the player's favour (a bet of 5 wins 8, not 7).
Chat with FireFly: just @mention it (AI helpers โ Chat with FireFly, Premium)
- Members type @FireFly and a question, or reply to one of its answers, and FireFly replies right in the channel. It follows the conversation, knows the last few messages, and uses your server info and rules.
- Pick a personality: ๐ Friendly helper, ๐ฆ Playful owl, ๐ฏ Short and clear, ๐ฎ Hype gamer, or write your own ("a wise old wizard who speaks in riddles").
- Looks things up on the web when needed (if Web answers is on), with quiet source links under the reply.
- Safe by design:
- It never pings anyone (no @everyone, @here or users).
- It says it's a bot if asked, and can't take moderation actions.
- It responds kindly and points to help if someone seems to be struggling.
- Instructions hidden in chat messages can't change how it behaves.
- Replying to other FireFly messages (like level-ups) doesn't start a chat. Only a typed @mention or a reply to a chat answer does.
- Choose who can chat (everyone or staff) and which channels. There's a short cooldown per person (โณ reaction), and each reply counts toward your daily AI limit.
- The website demo now opens with a chat scene.
AI web answers (AI helpers โ Web answers, off until you switch it on)
/ask can search the web when your server info doesn't cover the question, such as a game update, a release date or a how-to. Answers come with a Sources list of the links it used.
- Your server info and rules always come first. Questions about your own server's rules, roles, staff or events never go to the web.
/search (optional): members can look up anything on the web, with sources. Only they see the answer unless they share it.
- Its own daily limit (30 by default), separate from the normal AI limit. When the limit is reached,
/ask still answers from your server info.
- Choose the sites: a list of sites to never use, or only allow certain sites (for example your game's wiki).
- Web pages are treated only as information, so instructions hidden in a page can't take over the AI. Source links are checked and cleaned before they're shown.
- Uses Claude's built-in web search ($10 per 1,000 searches) or OpenAI's, with the same key. If web search isn't switched on for the AI account, FireFly says how to turn it on.
- OpenAI: newer models that think before answering now get enough room to reply.
/ask works straight away. It no longer says the server hasn't added any info. It now also knows the server's name and description, its channels and their topics, upcoming events, and which FireFly features are on. Server info you write and your rules still make the answers much better.
/ask and /draft only use channels and events the person can see, so private channel names never reach the AI.
- The AI helpers page shows what
/ask can answer from, and a You have unsaved changes ยท Save bar appears as soon as you change something, so changes aren't lost.
AI helpers (Premium), using your server's own Claude or OpenAI key (Automation โ AI helpers)
/summarize: catch up on a busy channel. Bullet points of what happened, who said it, open questions and decisions. Only you see it unless you share it.
/draft (staff, in tickets): a suggested reply only you can see, with Send, Edit, then send and Try again. You can add a note like "ask for their order number". It uses your rules and server info, and doesn't invent facts.
/ask: members ask questions and get answers from your rules plus the server info you write on the dashboard. If the answer isn't there, it says so and points to staff.
- Flagging: new messages are checked for harassment, hate, threats, sexual content, scams, doxxing or someone who may be struggling, and mods get an alert with Delete, Time out 10 min and Looks fine buttons. Normal swearing and banter are ignored. Auto-delete is optional and off by default. With an OpenAI key it uses OpenAI's free moderation check.
- Your key, your bill: the server pays its AI provider directly. FireFly checks the key, stores it encrypted, and never shows it again. Set a daily request limit and see usage per helper.
- Messages are treated only as text to read, so instructions hidden inside them can't take over the AI.
- The website privacy policy now explains exactly what each helper sends and where.
Rules with an Accept button (Community โ Rules)
- Write your rules one by one, or start from a template (be respectful, no spam, keep it safe for work and more), then post them as one message with an I accept the rules button.
- Accepting gives roles (for example Member) and can take roles away (for example New). Make the role the one that can see the rest of the server, so new people must accept first.
- Updating edits the same message, so links to it keep working.
- Ask everyone to accept again after a big change: FireFly takes the role back from everyone except admins until they accept the new version.
- You can choose the title, intro, closing text, numbering, colour, a picture, and the button's text and emoji. There's also a private reply after accepting, an optional DM copy of the rules, and a mod-log entry for each accept.
- See how many people accepted the current rules, how many accepted an older version, and who still doesn't have the role.
Formatting buttons on every message box
- B, *I*, U, ~~S~~, spoiler, inline code, code block, heading, quote, bullet and numbered lists, small text and links, on every message and embed text box.
- Ctrl+B / Ctrl+I / Ctrl+U work while typing, and Ctrl+Z undoes a formatting change.
- ๐ Preview shows how the text will look in Discord, and the embed builder's preview now shows formatting too.
- Goodbye, level-up, birthday and auto-mod messages are now full text boxes, so they get the buttons too.
Branding (Premium): make FireFly look like part of your server
A new Server โ Branding page with a live preview of a message, a welcome card and a rank card. Free servers can try everything in the preview, and saving needs Premium.
- Brand colour: every FireFly message that would be FireFly amber uses your colour instead. Green "done" and red "problem" messages keep their colours.
- Your footer (with your server icon) on FireFly's messages.
- Your emojis: swap FireFly's โ
โ ๐ โ ๏ธ ๐ โญ for your server's own custom emojis.
- Plain text mode: simple messages go out as text instead of cards. Anything with buttons or pictures stays a card.
- Card themes: Night, Midnight, Neon, Sunset, Forest, Ocean and Pastel, plus 7 fonts for names (Inter, Space Grotesk, Bebas Neue, Fredoka, Playfair, Pacifico, Press Start), plus your own background picture.
- Names: call levels and XP whatever you like (for example "Rank" and "Feathers") on rank cards,
/rank and /leaderboard. You can also set the coin name and symbol, including your own emoji.
- Your dashboard: while managing that server, the dashboard uses your brand colour, and Home shows your Discord server banner.
- Copy from another server you manage, or Reset to FireFly.
- Branding settings are kept if Premium ends; FireFly just goes back to its own look until it's renewed.
A redesigned Channels page
- Looks like Discord's sidebar. Channels sit indented under collapsible categories. Each category has a + to add a channel straight into it, and FireFly remembers which categories you've collapsed.
- Click a channel to edit it in a side panel instead of a row of 8 unlabeled icons. The panel has:
- name, category, topic, slowmode and 18+ settings
- Lock, Messages, Permissions and Duplicate buttons
- a one-click Sync when its permissions differ from the category
- when it was created and when the last message was sent
- its ID with a copy button
- Delete
- Drag and drop: drag channels to reorder them, drop one onto a category to move it there, and drag categories to reorder them. Text channels always stay above voice channels, the same as in Discord.
- โฏ menu on every channel and category for everything else, including Move up or down and Move to categoryโฆ, which also works on phones.
- Filters and search: find a channel by name, or show only Text, Voice, Locked, Slowmode, Out of sync or Quiet 30+ days channels.
- See more at a glance: the faces of who's in each voice channel right now (updated live), and a Quiet tag on channels with no messages for 30+ days.
- The bulk buttons only appear when you tick something, as a bar at the bottom: Lock, Unlock, Move toโฆ and Delete.
/trivia no longer repeats questions. Each server now goes through every question once, in a random order, before any comes back.
- 277 trivia questions (up from 40), covering science, geography, history, games and films, food, sport, words and maths.
- You can add your own questions to
firefly/assets/trivia.txt, one per line: question | right answer | wrong | wrong | wrong.
/shitty can be kept to one channel. Choose it on Economy & games โ Mini-games โ Can only be started in. Anyone who runs /shitty anywhere else is told which channel to use. Leave it on *Any channel* to allow it everywhere.
- The website no longer shows an email address. Questions on the Privacy and Terms pages go to the support server.
New party game: /shitty
- A Ride the Bus style card game for 2 to 23 players, played with two decks. Run
/shitty in any channel. People pick a 1ร, 2ร or 3ร multiplier to join, and the host presses Start.
- Four guessing rounds, each dealing you a card:
- Red or Black: give or take 1.
- Higher or Lower: give or take 2.
- Inside or Outside: give or take 3.
- Suit: give or take 4.
- In rounds 2 to 4 you can call Same. Hitting the same rank without calling it means taking double, and calling it right means giving double.
- Ride the Bus: a Take row and a Give row of 6 cards flip one at a time. Each matching card in your hand is worth the row number, and a ๐ฏ row match (an Ace on row 1, a 2 on row 2 ... a 6 on row 6) is doubled. Everything is multiplied by your multiplier.
- When you give, you pick who gets it from a menu. If nobody answers in time, the guess counts as wrong, and an unpicked give goes to the next player.
- A tally shows who took and gave the most. The ๐ Rules button explains it all.
- Dashboard (Economy & games โ Mini-games): switch the game off, choose whether the tally counts drinks, sips, shots or points, and see who has taken the most over all games.
- No coins are involved.
The casino: 7 new games, including member vs member
/slots: three reels. Two cherries pay 2ร, any pair gives half back, three diamonds pay 500ร.
/blackjack: Hit, Stand or Double against the dealer. Blackjack pays 3:2.
/roulette: a European wheel. Bet on red or black, odd or even, high or low, a dozen, or one number (pays 35:1).
/highlow: guess whether the next card is higher or lower. Each right guess grows the pot, and you can cash out whenever you like.
- Member vs member:
- /duel @someone: both put the same bet in, and one walks away with it all.
- /rps @someone: rock paper scissors for coins. Picks stay hidden until both of you have chosen, and a tie refunds both.
- /pot: a jackpot anyone can join. When the timer ends, one person wins everything; the more you put in, the better your odds.
- /rob @someone: try to steal part of someone's wallet. If you're caught, you pay them a fine. It's off by default, there's a cooldown, and the victim gets a 30-minute shield.
- Casino settings on Economy & games: switch each game on or off, set a smallest and biggest bet, keep games in one channel, set the jackpot timer and the /rob odds.
- Casino stats show how much has been played and paid out per game, what the house keeps, the biggest wins, and any running jackpot.
- Only one game per person at a time, so nobody can bet the same coins twice.
- The Bot owner section now shows in the sidebar as soon as the dashboard opens, instead of after the current server has finished loading.
- Bot & updates now says when FireFly was last updated, and from which version (for example "Updated from 5.5.5 to 5.5.6 2 minutes ago"), so you can see an update worked.
- Update from the dashboard. When there's a new version, Bot owner โ Bot & updates (or the green *Update toโฆ* button in the sidebar) has Update now. FireFly downloads it, checks it hasn't been tampered with, keeps a copy of your current version and a backup of your data, installs it and restarts itself. The page reloads by itself when it's back, usually within 30 seconds. No terminal needed.
- Go back puts the previous version back (with a restart) if something seems wrong after an update.
- Only the bot's owner can see or use these.
update.sh and update.bat still work as before.
- FireFly no longer goes offline over Spotify features. If they're switched on but Discord hasn't allowed FireFly's Presence Intent, FireFly now starts without them and says so on Bot owner โ Bot & updates ("Blocked by Discord", with how to fix it). Before, the whole bot stopped and the dashboard showed "Bad gateway".
- When FireFly runs as a service on a server, it no longer prints the dashboard password in the system log. It says it's saved in
.env instead.
The daily word game (/word) now plays like Wordle
- A real board: your guesses show as coloured letter tiles in a picture, with a keyboard underneath that shows which letters are in the right place, in the word, or ruled out. No more remembering what's greyed out.
- One board that updates with each guess, instead of a new message every time.
- Only real words count. A made-up word or one you've already tried doesn't use up a guess. About 19,500 words are accepted.
- A short text line under the board also lists the known letters, for screen readers and small screens.
- 777 daily words instead of 145, so it won't repeat for about two years. The new list starts the day after you update, so nobody's word changes in the middle of a game.
- The win message changes with how fast you got it ("Genius!" in one, "Phew!" in six). The result shared in the channel is the same spoiler-free grid as before.
- New: a Bot owner section in the sidebar, which only the bot's owner sees. Everything that's about FireFly itself, rather than one server, is together in one place:
- All servers (moved from Home)
- Premium: paying servers, free grants and test subscriptions (moved from Settings)
- Bot & updates: version and updates, download all data, the error log, invite links, Twitch keys (moved from Alerts), Spotify features and Kick
- Sign-in & access: Discord sign-in and the owner password (moved from Settings)
- Developer access: servers that have let you in with /support-access, and everything you opened
- Server Settings now only has that server's settings, so server admins no longer see cards that were only for you.
- On a private server, the Bot owner section stays in the sidebar so you can still reach your own pages.
- Fixed: for the first seconds or minutes after the server running FireFly started, some features could be held back: rogue-staff protection and anti-spam couldn't step in, stats counters didn't update, chat coins weren't given, and the first developer visits weren't recorded. They now work from the moment FireFly starts.
- Fixed: the permission checklist when editing a role (and @everyone) was squashed, with the boxes and names piled on top of each other. That came in with 5.3's permission map, whose coloured squares borrowed the same style name.
Your server is private, even from FireFly's developer
- The bot's owner (the developer) can no longer open a server's messages, members, cases, tickets, ModMail, notes, settings or permission map on the dashboard, unless they're staff in that server or the server lets them in. They still see each server's outline (name, size, health and plan) on All servers, where private servers show a ๐.
- New:
/support-access for admins. Let the developer in when you'd like help, for 1 hour, 24 hours, 3 days or 7 days. End it any time, or see everything they opened. The same controls are on the dashboard under Settings โ FireFly developer access.
- Every time the developer opens your server, it's listed for your admins, and the first visit is posted in your mod log. A banner reminds the developer they're on support access.
- Emergency access for real abuse (a raid, or illegal content using FireFly): one hour, and only with a written reason. The server's owner gets a DM with that reason straight away, and it's posted in the mod log.
- Live updates, notifications and anti-nuke DMs from servers the developer can't open no longer reach the developer.
- The Privacy Policy and FAQ explain exactly what the developer can and can't see, including that this is a rule FireFly follows rather than encryption.
- For private installs: set
OWNER_PRIVACY=0 in .env to switch the rule off.
- Help & support at the bottom of the dashboard's sidebar. It opens one place with the support server, "Report a bug", help for the page you're on, the setup assistant, Explore, every slash command, what's new in each update, and handy tips (Ctrl+K search, notifications and the app, the permission checkup).
- FireFly has a support server: https://discord.gg/s34FX4rZhq. It's linked from
/help, the welcome message FireFly sends when it's added to a server, the dashboard's ? help on every page, and the website.
- Fixed: some files in the download were read-only, which stopped the updater on Linux. The updater now copes with read-only files from older versions too.
FireFly Premium can now be bought in Discord
- Servers subscribe to FireFly Premium monthly, through Discord: from FireFly's store page in Discord, the new Subscribe button in
/premium, or the dashboard. Discord handles the payment, and Premium covers the whole server.
- Premium turns on the moment someone subscribes. FireFly thanks them in the server's system channel and posts it to the mod log.
- When a subscription is cancelled, the server keeps Premium until the end of the month it paid for, then goes back to the free plan. Nothing it set up is deleted. A refund ends Premium straight away.
- FireFly checks with Discord every 30 minutes, so a restart or a missed message can't leave a server on the wrong plan.
- Hitting a free limit on the dashboard now shows a "That's a Premium thing" window with a Subscribe in Discord button, instead of a red error.
- Settings โ Plan shows who subscribed, whether it renews, and when a cancelled subscription ends.
- For the bot's owner: the Premium servers list shows paying servers and a count, and DMs you for every new subscription and every cancellation. Test gives a server a free Discord test subscription to try the whole paid flow. Free grants and your own servers work the same as before.
- Website: the Premium plan has a Subscribe in Discord button, and the Terms and Privacy pages explain payments (handled by Discord; FireFly never sees payment details).
- On a Linux server, the dashboard's Update toโฆ button and the console now give the Linux steps (
bash update.sh) instead of telling you to double-click update.bat.
Easy Linux server setup
- New
install-linux.sh: run bash install-linux.sh in the FireFly folder on a Linux server. It installs Python if needed, asks for your bot token (hidden while you paste), installs FireFly's packages, and sets FireFly up as a service that starts on boot and restarts if it crashes. Then it checks FireFly logged in and shows your dashboard password. Safe to run again any time; bash install-linux.sh uninstall removes the service.
- New
update.sh: the Linux version of update.bat. It stops the service, updates, and starts it again. If there's no new version, FireFly isn't stopped. bash update.sh rollback goes back one version.
- The updater gives Linux instructions on Linux instead of mentioning
.bat files, and keeps the .sh scripts runnable after an update.
- The service file now logs straight away, so
journalctl -u firefly shows the startup messages.
- HOSTING.md's Linux section is rewritten around the installer.
- Counting game: numbers can now be typed as words as well as digits:
twenty-three, one hundred and five, a thousand. Capitals, hyphens and punctuation don't matter, and anything after the number is ignored, the same as with digits ("seven lets go!" counts as 7).
New: Permissions (Server โ Permissions)
See exactly who can see and do what in every channel, and why. Discord only lets you check one role or one channel at a time; this shows the whole server at once.
- Checkup: FireFly looks for problems and lists them worst first:
- High: staff-looking channels that everyone, or a role most members have, can see; @everyone (or a big role) able to ping the whole server; dangerous powers like Ban, Manage Server or Manage Webhooks on @everyone or on a role most people have.
- Medium: one role allowing what another denies, for people who have both (the allow wins, which surprises people); staff roles placed above FireFly's own role; announcement channels everyone can post in.
- Tidy-up: overrides that change nothing, empty overrides, overrides for deleted roles or people who left, overrides on Administrator roles, and channels that drifted out of sync with their category.
- Most problems have a one-click fix. "Clear all" tidies up every useless override at once without changing anyone's access. Mark anything that's on purpose as It's fine and it stops being flagged.
- Map: every channel against every role in one grid. Each square shows what someone with that role can do there: hidden, read only, post, manage or admin. A dot means the channel itself set it. Click any square for Discord's reasoning, step by step.
- One channel: how many people can see it, post in it and manage it; every role's access and override; personal overrides; and the list of people who can see it.
- One person: every channel they can see or not, with the reason in plain English, plus their server-wide powers.
- What ifโฆ: see which channels someone would gain or lose, and any new powers, before you give or take away a role.
Mod log: access changes (Welcome & logs, on by default)
- When a channel's permissions change, the mod log says who can now see or post in it, or who lost access, in plain English. Changes made at the same moment (like a lockdown) come as one message.
- Roles that gain or lose powers like Ban, Administrator or Manage Server are logged with how many people have the role.
- A new channel with a staff-looking name that everyone can see is flagged straight away.
- Big changes (a private channel opening up, a role with lots of members getting new powers) also pop up as a dashboard notification. Turn them on in Settings โ Notifications on this device.
Notifications and an installable app
- The dashboard can pop up a notification on your computer or phone for new ModMail, new reports, rogue-staff alerts and approvals that need you, even when the tab is in the background. Each device picks what it wants (Settings โ Notifications on this device).
- Install the dashboard as an app from your browser's menu ("Install" or "Add to Home Screen") so it opens in its own window like a normal app.
New: All servers (Home, only you see it)
- Every server FireFly is in on one page: members, owner, messages this week, setup health, Premium, and when FireFly was added. Open any of them in one click.
- Message all server owners: send important news (a big update, planned downtime) to every server owner by DM, or to every server's mod-log channel.
Better moderation tools
- Saved reasons: keep a list of common reasons (Warnings page). They show up as quick picks when you warn, time out, kick or ban, on the dashboard and in Discord's
/warn, /timeout and /ban.
- Evidence on cases: add screenshot links, message links or notes to any case, so the next mod sees why it happened.
- Warn and delete: right-click a message in Discord โ Apps โ *Warn and delete*, or use the new button on the Messages page. The message goes and the author gets a warning in one step.
Levels: XP boosts and seasons (Levels)
- Double XP events: 1.5ร, 2ร or 3ร XP for an hour up to a week, with an optional announcement.
- Weekend boosts: double or triple XP every Saturday and Sunday.
- Role boosters: certain roles (like server boosters or supporters) earn extra XP.
- Monthly seasons: a second leaderboard that starts fresh each month. FireFly posts the winners when a season ends, and everyone's all-time level is kept.
/leaderboard has a *season* option, and the dashboard can switch between all-time and this season.
New setup assistant
- Pick what kind of server it is (gaming, community, creator, study, support or friends) and FireFly ticks the essentials for it: welcome messages, mod log, scam-link and rogue-staff protection, anti-spam, anti-raid, levels and more. Change anything, then press Set up. Missing channels, like a private #mod-log, are made for you. Run it any time from Settings.
Settings history with undo (Settings)
- Every change to FireFly's settings is saved: what changed, from what to what, and who changed it. Undo puts it back. Kept for 90 days.
Copy setup from another server (Settings)
- Copy FireFly's settings, automations, forms, auto-replies and custom commands from another server you manage. Channels and roles are matched by name; anything that doesn't exist here is skipped and listed.
Help on every page
- A small ? next to each page's title explains the page in a sentence, with a tip.
- New
/setup command in Discord (admins only) links straight to the dashboard for that server.
A new dashboard layout
- Seven sections instead of 34 links: Home, Moderation, Safety, Community, Support, Automation and Server. Only the section you're in opens, so the sidebar stays short.
- Tabs along the top of every page for the other pages in that section, so you can jump between related pages without the sidebar.
- New: Explore features (Home). Every FireFly feature on one page: what it does, whether it's on for this server, which ones are Premium, and a "Recommended next" row. Search it or filter by section, and click any feature to go straight to it.
- The Inbox count now shows on the Home section even when it's folded away.
New: Automations (Automation โ Automations)
- "When this happens, do that", with no code. When someone joins (optionally with a certain invite), reaches a level, gets a role, boosts the server, a ticket is closed, an application is accepted or denied, or a suggestion gets enough ๐.
- Then give or take away a role, post a message, DM them, or give coins or XP. Up to 5 steps each. Four ready-made ideas to start from.
- Free servers can have 3 automations; Premium raises it to 50.
New: New-member preview (Server โ New-member preview)
- See exactly what someone experiences when they join: account checks, verification and captcha, the roles they get, the welcome message, card and DM, the automations that run, and which channels they can see and type in, before and after verifying.
- Points out common mistakes, like new members being able to post in #rules, or seeing lots of channels before they verify.
New: Events with RSVP (Community โ Events)
- Plan a game night, movie night or meeting. FireFly posts it with Going, Maybe and Can't go buttons and keeps the list up to date.
- People who are going get a role for the event, so the reminder (15 minutes, an hour or a day before) only pings them.
- Pick a voice channel, or let FireFly open one when it starts and delete it after. FireFly counts who actually shows up and can give them XP.
- "Pick the busiest time this week" fills in the hour your server is most active. You can also add it to Discord's own Events list.
New: Keep your regulars (Insights)
- Shows people who used to chat a lot and have gone quiet for two weeks, and newcomers who joined but never said anything. Tick who to check in on and send them a friendly DM in one click. People you already checked in on are marked.
New: Smart timing (Scheduled posts)
- "When people are around": FireFly posts at the busiest hour in the next day or week, based on your server's activity heatmap.
New: Mini-games
/trivia: a quick question, first right answer wins. /word: today's five-letter word, six guesses, with a streak and a shareable result. Winners get coins when the economy is on (set how many on the Economy page).
New: Kick and Bluesky alerts (Alerts)
- Post when a Kick streamer goes live, or when someone posts on Bluesky. Kick works without keys; for the most reliable alerts, add
KICK_CLIENT_ID and KICK_CLIENT_SECRET from Kick's developer settings to .env.
New: Music, the safe way
/watch opens Discord's own Watch Together in your voice channel, so everyone can watch or listen to YouTube together, with YouTube's blessing.
/np shows what someone is playing on Spotify right now, with the album cover and a link. /charts and the new Music charts card on Insights show the server's top artists and songs this week. Only totals are kept, never who listened to what. These need Discord's Presence intent: tick it in the Developer Portal, then switch Spotify features on (Insights โ Music charts) and restart FireFly.
New: Staff inbox (Inbox, at the top of the sidebar)
- One list of everything waiting for staff: ModMail conversations, reports, open tickets, applications, ban appeals and suggestions. The sidebar shows how many are waiting.
- Claim something so others know you've got it, and add staff notes only staff can see. Filter by kind, or show only what nobody has claimed.
New: ModMail
- Members DM FireFly to reach a server's staff. Each conversation becomes a thread in a private staff channel (FireFly can make one for you). Staff reply in the thread, or on the dashboard, and FireFly passes it on as a DM.
- Start a message in the thread with ! to keep it as a staff-only note. Replies can show the staff member's name or just "Staff". If someone is in several of your servers, FireFly asks which one.
New: Report to staff
- Members right-click any message โ Apps โ Report to staff, and can say why. Your staff get a copy (even if the message is deleted later) with buttons to delete it, warn or time out the author, or dismiss it. Several reports of the same message are merged.
New: Staff report card (Staff, under Moderation)
- For the last 7, 30 or 90 days: each staff member's cases, tickets closed, typical time to first reply, ticket rating, applications, appeals, reports and ModMail replies.
- New option: after a ticket closes, FireFly can ask the member to rate the help from 1 to 5 stars.
New: Undo button for your server (Audit log)
- Deleted a channel or role by mistake, or a hacked account went on a spree? The Audit log page now lists recent changes with an Undo button.
- Deleted channels come back with their permissions and category. Deleted categories come back with their channels moved back in. Deleted roles come back and are given back to everyone who had them. Changes to names, topics, colours, permissions and channel overrides go back to how they were.
- Each change shows who made it (from Discord's audit log), including changes made in Discord itself or by other bots. Changes are kept for 14 days. Old messages in a deleted channel can't be brought back.
New: Rogue-staff protection (Protection)
- If one person bans, kicks, or deletes channels, roles or webhooks too fast (you pick how many, and how fast), FireFly takes away their staff roles and times them out, or kicks or bans them, and DMs the server owner and you. It works for actions done in Discord itself too, which is how hacked staff accounts usually wreck servers.
- Each alert has an Undo what they did button that puts everything back in one go.
- Trusted roles are never stopped. The server owner, you and FireFly are always trusted.
New: Two-person approval
- Optional. Big dashboard actions by admins (mass kicks or bans, deleting several channels or roles, restoring a backup, applying a template) wait until a different admin approves them on the Protection page. Nobody can approve their own request.
New: Scam-link protection (Protection)
- Deletes phishing links (fake Nitro, fake Steam, fake Discord logins) as soon as they're posted, and can also time out, kick or ban the sender. Optionally posts a short warning in the channel.
- Uses a community list of thousands of known scam sites that updates every 6 hours, a built-in list for when that can't be reached, and a check that catches new lookalikes like "dlscord" or "steamcommunlty".
- There's a box to test any link.
New: Captcha for verification (Protection โ Verification gate)
- Optionally, after clicking Verify me, new members type a code from a picture. Three wrong tries and they need a new code.
- Back to how it was before 4.9.1: FireFly says a short hello in the server when it's added, and the 3rd warning times someone out for an hour by default (change it under Warnings).
Adding FireFly changes nothing until you want it to
- FireFly no longer posts a hello message in a server when it's added. Only the person who added it gets a private DM with the setup steps, which now also says that nothing is switched on yet.
- Automatic punishments for warnings now start off in newly added servers (before, the 3rd warning timed someone out for an hour). Turn them on under Warnings. Servers that already have FireFly keep their current setting.
- New FAQ on the website: "Will FireFly change anything when I add it?"
Six new server templates (12 in all)
- Minecraft / game server: a whitelist application form that gives @Whitelisted when accepted, a
/ip command, builds, screenshots, trading and server status.
- Esports team / clan: a tryout form that gives @Trial, roster roles (Captain, Main roster, Substitute, Trial), a private team area with strategy and VOD review, and XP for voice practice.
- Roleplay community: a character application form, lore, out-of-character chat, and in-character channels that only open once a character is approved.
- Art & commissions: showcase, work-in-progress and sketchbook channels with a starboard, critique and art challenges, commission requests through private tickets, and a role menu for Artist / Commissions open / Critique welcome.
- Small business / shop: deals, order help through private tickets, reviews, and auto-replies that answer "shipping", "refund" and "hours" questions.
- Open-source / dev project: help, a bug-report form (staff triage it in a private channel), feature requests with voting, a releases channel ready for GitHub release alerts, and Maintainer / Contributor roles.
- As before, templates only add what's missing and make a backup first. Forms, commands, auto-replies and role menus that already exist aren't duplicated if you apply a template twice.
Forms
- New option: "People can send it again before staff decide". Useful for bug reports; applications stay one at a time.
Fixes
- The Health check on the Settings page showed solid yellow bars instead of its results. The Insights heatmap's squares and the health check rows shared a style name, so the heatmap's colouring leaked onto the health check. Each now has its own.
New: FireFly Premium, per server
- Every feature still works for free, with fair limits: 5 custom commands, 15 auto-replies, 5 scheduled posts, 5 role menus, 5 reaction-role messages, 2 forms, 3 alerts, 2 stats counters and 10 shop items.
- Premium raises those to 50 / 100 / 50 / 30 / 30 / 25 / 50 / 10 / 25 and adds three extras: your own background on welcome and rank cards, XP for time in voice, and a daily automatic backup.
- Servers that already have more than the free limit keep everything; they just can't add more until they're under it. A saved card background is kept and comes back if the server gets Premium.
- Settings โ Plan shows a server's plan, how much of each limit it's using, and a Get Premium button. The Overview shows "Free plan" or "โจ Premium" next to the server name.
/premium shows the same in Discord.
Give Premium to anyone, free (only you see this)
- Settings โ Premium servers lists every server FireFly is in. Give Premium forever or for 1 week to 1 year, add time to an existing grant, leave yourself a note ("Paid on Ko-fi", "friend"), and optionally post a short announcement in that server.
- You can also give Premium by server ID before FireFly joins.
- Servers you own always have Premium.
- Server admins can't give themselves Premium: those controls are owner-only, checked on every request.
Website
- A new Plans section compares Free and Premium, with an "Ask about Premium" button (set
premiumUrl in config.js to a Ko-fi or Patreon page; otherwise it uses your support server or email).
- The Terms page explains how Premium works.
Easier-to-read server picker
- The server dropdown at the top of the sidebar is now FireFly's own menu instead of the browser's built-in one, which could show light text on a white list on Windows.
- Each server shows its icon, member count and your access (Admin or Moderator). Once you're in more than 6 servers, a search box appears. Arrow keys, Enter and Escape work.
- Every other dropdown in the dashboard now uses dark colours too.
Put the dashboard online without Cloudflare Access
- You sign in with Discord too. FireFly asks Discord who owns the bot and gives that account full owner access from any device. No password needed away from your PC.
- New switch: "Owner password works on other devices" (Settings โ Sign in with Discord). Turn it off and the password only works on the PC running FireFly. From anywhere else, the only way in is a Discord account that manages one of your servers, so there's nothing for strangers to guess. FireFly won't let you turn it off from another device unless you're signed in with Discord, so you can't lock yourself out.
- Guessing protection: 30 wrong passwords in an hour, from any mix of addresses, pauses password sign-in from other devices for an hour and DMs you. Using the dashboard on your own PC keeps working.
- When the password isn't allowed, the sign-in screen just shows Sign in with Discord.
- The dashboard refuses to be shown inside other websites (protects against trick pages that hide its buttons under something else).
- A warning shows if your password is short while it still works from other devices.
- Your own Discord sign-ins are marked Owner in the "Signed in now" list.
Tidier navigation
- Pages are grouped by job: Moderation (Members, Messages, Warnings, Cases, Bans & appeals, Audit log), Safety (Protection, AutoMod, Backups), Server setup, Automation, Support (Tickets, Forms, Suggestions) and Community (Levels, Economy, Polls & giveaways, Starboard & more, Alerts). Overview and Insights stay at the top.
- Click a group's name to fold it away. FireFly remembers which groups you closed, shows how many pages are inside, and always keeps the page you're on visible.
- Every page has its own icon now (Cases, Suggestions and Starboard used to share icons with other pages), and long names are shorter ("Alerts", "Forms").
- Ctrl+K still finds pages by their old words: try "youtube", "twitch", "applications" or "xp".
- On phones, the menu is now a grouped list instead of a jumble of buttons.
New: forms & applications (Automation โ Forms & applications)
- Make a form (staff application, partner request, report, anything) with up to 5 questions, short or long answers, required or optional. A ready-made staff application is one click away.
- Post its button in any channel. Members click it and a pop-up form opens right inside Discord, no website needed.
- Answers go to a staff channel with Accept and Deny buttons, and to the dashboard, where you can search them and add a note.
- Accepting can give a role automatically. The member gets a DM either way (write your own or use the friendly default).
- Someone can't send the same form twice while they're waiting, and you can set how many days before they can send it again.
- Moderators can accept and deny; only admins can make or change forms.
Edit FireFly's own messages (People โ Messages)
- FireFly's messages now have an Edit button: fix a typo in an announcement, change the embed's title, text, colour, footer or picture, after it's been posted.
- Link buttons: announcement embeds can have up to 5 buttons that open a website (rules, store, sign-up form). You can add, change or remove them later too.
XP for time in voice (Levels)
- Optional: members earn XP for every minute they spend talking in voice. Only counts when they're with at least one other person and not muted, deafened or in the AFK channel, so it can't be farmed by idling.
/rank and the leaderboard show time spent in voice.
Fixes and polish
- A new automated check opened every page and clicked every button. It found nothing broken for real use; two messages ("Unlock all" and "Reroll") are now extra careful in case Discord sends back less than expected.
Fixes
- Saving on the Bans page (ban appeals) showed "Cannot set properties of undefined (setting 'appeals')" if you hadn't visited certain other pages first. The setting itself was saved, but the dashboard tripped over it afterwards. Fixed for every Save button, and a new automated check now opens every page fresh and clicks every Save button.
Two dashboard access levels
- Admins (Manage Server, Administrator, or an admin role you pick) get everything for their server.
- Moderators (a moderator role you pick) see Members, Messages, Warnings, Cases, Bans, Tickets, Suggestions, Insights and the Audit log. They can warn, time out, kick, ban, delete messages, lock channels and handle tickets, appeals and suggestions, but can't change settings. FireFly checks this on every action, not just by hiding buttons.
- Set both on Settings โ Who can use the dashboard.
A good first impression on new servers
- When someone adds FireFly, they get a DM with three steps: sign in to the dashboard, check FireFly's role position, and try
/help. The server gets a short hello too. If DMs are closed, the steps go in the server instead.
- New
/help: every command by category, the server's own custom commands, and links to the website and dashboard.
- Dashboard address setting (Settings โ Sign in with Discord), used in those messages. Signing in on the PC itself keeps working through 127.0.0.1.
Getting verified by Discord
- New VERIFICATION.md: the checklist for Discord's verification (required past 100 servers), with ready-to-paste answers for why FireFly needs the Members and Message Content intents, written to match what the code really does.
- From 75 servers, FireFly's window and the health check remind you to apply.
New: moderation cases (People โ Cases)
- Every warning, timeout, kick, ban and unban gets a case number, including ones done with other bots or Discord's own right-click menus (FireFly reads them from the audit log as they happen).
- Each case shows who did it: the moderator's name for actions on the dashboard or with slash commands, "FireFly (automatic)" for anti-spam, anti-raid and warning limits.
- Filter by kind, search by name, ID, reason or
#number, and fix a reason afterwards.
/case 42 shows one case (and can change its reason), /cases @member shows someone's record. Moderators only.
- Member profiles now show their full moderation history.
New: ban appeals
- Banned members open your public appeal page, sign in with Discord (so you know it's really them), and answer your question. FireFly only shows them servers they're actually banned from.
- New appeals are posted to a channel you choose. On the Bans page staff read them and Unban or Deny, with a reply the person sees when they come back.
- One open appeal at a time, and a wait (you pick: a day to a year) after a denial.
- When FireFly bans someone, it DMs them the reason and the appeal link first.
- Needs the public pages address (see below).
New: emoji reaction roles (Role menus)
- React to a message to get a role, the classic way. Post a new message or use one that's already there; up to 20 emoji (custom emoji work too).
- Three modes: add and remove, only one role at a time, or add only.
New: bring levels across (Levels โ Import levels)
- From MEE6: one click, as long as MEE6's leaderboard is public. FireFly uses the same XP curve as MEE6, so everyone keeps exactly the same level.
- From a spreadsheet (CSV) with user IDs and XP or levels, for any other bot.
- Choose whether to keep whichever XP is higher (safe) or use the imported number.
New: public pages address
- Ban appeals and public leaderboards need an address that skips Cloudflare's email login, like
https://app.fireflybot.net. Set it on Settings โ Sign in with Discord โ Public pages. On that address FireFly only shows public pages; the dashboard and its data can't be reached through it.
- Public leaderboard (Levels): a shareable page with your server's top 100.
One-click updates
- New
update.bat: close FireFly, double-click it, start FireFly again. It downloads the newest version from fireflybot.net, checks it against a checksum (a tampered or broken download is refused), keeps a copy of your current version in old-versions, backs up your data, and never touches .env, data or backups.
update.bat rollback puts the previous version back.
- The dashboard shows a green Update to โฆ button above the sidebar footer when a new version is out, with the steps. Only the owner sees it.
Safer storage
- Everything FireFly saves now lives in one database file,
data/firefly.db, instead of many small files. Saves are all-or-nothing, so a crash or power cut can't leave a half-written file. Your existing data moves across by itself the first time; the old files are kept in data/old-json-files.
- A copy of the whole database is saved to
backups/data every day (the newest 7 are kept).
- Download all data on Settings โ FireFly version & your data.
Startup self-check
- A few seconds after starting, FireFly's window says either "everything looks good" or lists what to fix in plain words: missing permissions, a weak dashboard password, missing packages, a folder it can't write to.
New: Sign in with Discord
- Staff can open the dashboard with their own Discord account instead of your password. The login screen shows a Sign in with Discord button once it's set up.
- They only see servers where they have Manage Server or Administrator, or a role you choose (Settings โ Who can use the dashboard). This is checked on every action, so removing someone's role takes away their access immediately.
- Owner-only things stay hidden from them: the error log, Twitch keys, Discord sign-in settings and adding the bot to new servers. Copying a layout from another server only works for servers they also manage.
- Sign-ins last 7 days. The owner can see who's signed in and sign anyone (or everyone) out. Only a scrambled version of each sign-in is stored, so the data file is useless to anyone who copies it.
- Set it up on Settings โ Sign in with Discord: the page shows the exact redirect addresses to paste into the Developer Portal.
New: who did what
- Changes made on the dashboard are now credited to the person who made them: in Discord's audit log ("FireFly Manager dashboard ยท by Maya"), warnings, notes, ticket closes, coin changes and temporary roles.
- Settings โ Recent dashboard changes lists the latest changes in plain English ("Maya warned a member", "Owner changed settings").
- Your name and avatar show at the bottom of the sidebar when you're signed in with Discord.
Security
- Now that the dashboard can be reached from the internet: after 10 wrong passwords from the same address, it stops accepting passwords from that address for 10 minutes. This works correctly behind a Cloudflare Tunnel.
New: Add FireFly to a server
- ๏ผ Add FireFly to a serverโฆ at the bottom of the server list, plus a button on the Settings page, in Ctrl+K, and on the empty screen when FireFly isn't in any server yet.
- Shows your invite link with a Copy button, an "Open it here" button, and a QR code for phones.
- Choose Administrator (every feature works straight away) or Only what FireFly needs (asks for exactly the permissions FireFly uses, which server owners find less scary).
- Warns you if Public Bot is off in the Developer Portal (meaning only you can use the link), with a direct link to the right page. It notices when you turn it on, without a restart.
- When FireFly joins or leaves a server, the server list updates by itself with a message.
- FireFly also prints the link in its window when it starts.
- The QR code uses the small
segno package, which start.bat installs. Without it, the link still works, just without the QR code.
New
- Ghost-ping alerts (Protection): when someone @mentions a person or role and then deletes the message, or edits the mention out, within 2 minutes, FireFly says who did it and what they wrote. It always goes to the mod log, and optionally also to the channel.
- Roles back on rejoin (Welcome & logs โ Auto-roles): people who leave and come back get their roles back, so leaving doesn't dodge a punishment role and regulars don't have to ask again. Roles with admin, kick, ban or manage powers are never given back automatically.
- Voice activity in the mod log (optional): joins, leaves and moves between voice channels.
- "What FireFly is doing here" on the Overview: every feature at a glance, on or off, one click away.
Health check
- Now also warns about missing Pillow (when picture cards are on), broken YouTube/Twitch/RSS alerts, and counting, starboard or suggestions channels FireFly can't post in.
New: one-click server templates (Server โ Templates)
- Six ready-made layouts: Gaming community, Creator / streamer, Study group, Friends hangout, Product / support and Team / workplace.
- Each one creates roles (with sensible permissions), categories and channels: read-only rules and announcements, a staff-only area, voice rooms with limits, slowmode on help channels.
- It also switches on the FireFly features that fit: welcome messages with a picture card, the mod log, a member role for newcomers, levels, the counting game, starboard, the suggestions box, join-to-create voice, birthdays, or a ticket button. Features you've already set up are left alone.
- A preview shows exactly what will be created, marking what you already have. Templates only add what's missing: nothing is renamed, changed or deleted, @everyone is never touched, and FireFly makes a backup first.
- The setup wizard links to templates for brand-new servers.
New: picture cards
- Welcome picture card (Welcome & logs): a generated image with the new member's avatar, name, your own line of text and their member number. Pick the accent colour and upload your own background picture. A live preview updates as you type.
/rank picture card (Levels): avatar, level, rank, and a progress bar to the next level, in your accent colour. You can switch back to the plain embed.
- Cards are drawn on your own computer with the bundled Inter font. Emoji and characters the font can't draw are left out, so names never show as empty boxes. Very long names shrink, then get cut off with "โฆ".
- Needs Pillow, which
start.bat now installs. If it's missing, FireFly still runs and just sends the normal message.
New: temporary roles
- Give someone a role for 1 hour, a day, a week, 30 days or any length. It's removed automatically. Do it from a member's profile on the dashboard, or with
/temprole member role 7d. The mod log records it.
- Giving the same role again moves the end date instead of stacking. You can end one early from the profile.
New: /afk
/afk lunch marks you away (and adds [AFK] to your nickname where possible). Anyone who mentions you gets a short reply saying you're away. Your next message welcomes you back and puts your nickname back.
New: Economy & shop (Community โ Economy & shop)
- Members earn coins with
/daily (with a streak bonus of up to +60% for 7 days in a row), /work (with a cooldown you choose) and, optionally, a few coins for chatting (at most once a minute).
/balance, /pay, /richest, and /coinflip for betting (can be switched off, with an optional biggest bet).
- A shop: sell roles (FireFly gives the role straight away) or perks staff hand out by hand (staff get a mod-log message). Optional stock limits.
/shop lists items and /buy suggests them as you type. For safety, roles with admin or moderation powers can't be sold.
- On the dashboard: rename the currency and symbol, see every wallet, give, take or set anyone's balance with a reason, see recent activity, and reset everyone if needed.
New: Counting game (Community โ Starboard & more)
- A channel where members count up together. โ
for a correct number, ๐ every hundred, โ and a reset when someone gets it wrong or counts twice in a row (both optional).
- Tracks the current number, the best ever, and how many times the chain broke. "Set the numberโฆ" lets you continue from another counting bot.
- Optional coins for each correct number.
New: YouTube, Twitch and RSS alerts (Community โ YouTube & Twitch alerts)
- YouTube: paste a channel link or @handle and FireFly posts each new upload. No API key needed.
- Twitch: posts when a streamer goes live (once per stream), with the stream title and game. Needs free keys from dev.twitch.tv; the page has step-by-step instructions and saves them to
.env. Keys are checked with Twitch before they're saved.
- Anything with a feed: subreddits (
r/name), news sites, blogs, Steam game news, GitHub releases, podcasts.
- Optional role or @everyone ping, your own message wording (
{name}, {title}, {link}, {author}, {game}), a test-post button, pause/resume, and "Check now".
- Anything already posted before you add an alert isn't announced, so your channel doesn't fill with old videos. At most 3 new posts at a time.
- Problems (a dead link, a site refusing, a deleted channel) are shown on the alert in red instead of failing silently.
New: custom slash commands (Automation โ Custom commands)
- Make your own
/commands from the dashboard. Replies can be text or a card, pick one random line (for an 8-ball or random tips), and be visible only to the person who used them.
- A command can give or take away a role, for self-serve ping roles like
/pingme.
- Limit a command to certain roles.
- One-click starters:
/rules, /ip, /socials, /8ball, /pingme.
- Commands appear in Discord a few seconds after saving. Several edits in a row are sent to Discord together.
- Names that clash with FireFly's own commands are refused.
Fixes
- On phones, some pages were slightly wider than the screen, so the right edge of lists and cards was cut off. Found by a new automated check that scans every page at phone width.
- Long addresses in help text now wrap instead of stretching the page.
The aim of this release: the things people usually add separate bots for, now in FireFly.
New: Insights (Server โ Insights)
- Messages per day, people chatting, and joins vs. leaves, for the last 7, 30 or 90 days, with this week compared to last.
- "When people chat" heatmap: every hour of the week, so you can see the best time to post announcements.
- Busiest channels and most active members.
- Do new members stick around? Shows how many people who joined stayed and how many have said something, and lists the newcomers who haven't spoken yet so someone can say hi.
- Optional weekly report posted every Monday morning (or press "Send one now").
- Counting starts when you install this version. Nothing is fetched from old message history.
New: Suggestions (Community โ Suggestions)
- Members use
/suggest or just type in the suggestions channel. Each suggestion gets ๐/๐ buttons (one vote per person; click again to take it back) and its own discussion thread.
- On the dashboard: filter by status, sort by newest, most votes or best score, then respond with Approved, Being considered, Done or Not going ahead plus a short reply. The suggestion updates in Discord and the author can get a DM. Decided suggestions close voting.
- Optional anonymous suggestions.
New: Starboard, join-to-create voice and birthdays (Community โ Starboard & more)
- Starboard: messages that get enough โญ (or any emoji you choose) are copied to a hall-of-fame channel. The count updates live, the copy is removed if stars drop, people starring their own message don't count, and age-restricted posts never leak into a normal channel.
- Join-to-create voice: one click creates a "โ Join to create" channel. Joining it gives you your own voice channel, which is deleted when everyone leaves. Owners get
/voice name, /voice limit, /voice lock, /voice unlock and /voice kick.
- Birthdays:
/birthday set (month and day only, no year), /birthday upcoming, a wish posted at the hour you pick, and an optional birthday role for the day. Feb 29 birthdays are celebrated on Feb 28 in other years. You can add or remove birthdays from the dashboard too.
New: reminders
/remind when:2h what:check the oven for anyone. Works with 10m, 2h30m, 1d, 1w 2d and so on, up to a year. /reminders lists or cancels yours.
Other
- The health check now also looks for the Move Members, Create Public Threads and Add Reactions permissions these features need.
- README updated with every page and slash command.
Reliability
- Fixed the requirements file: polls need discord.py 2.4 or newer, but the file allowed 2.3, so a fresh install could crash when making a poll. FireFly now also says clearly at startup if Python or discord.py is too old, instead of showing a confusing error.
- Damaged data files no longer wipe your settings. If a file in
data/ gets corrupted (say, the PC lost power mid-save), FireFly keeps the broken copy as name.broken-<date>.json and tells you, instead of quietly starting over.
- The error log can't grow forever. Once it passes 1 MB, the oldest half is trimmed.
- Automatic backups are tidied up. FireFly keeps the newest 25 "beforeโฆ" backups per server. Backups you make yourself are never removed.
New
- Daily automatic backups (Backups page): one snapshot a day while FireFly runs, keeping the last 14 (you can change the number). On by default.
- The dashboard password stays the same. If you leave
DASHBOARD_PASSWORD blank, FireFly makes one the first time and saves it to .env, so it doesn't change every restart.
- "Keep me signed in on this computer" on the login screen. Logging out forgets it.
Phones and small screens
- The page list folds into a menu button that shows the current page, instead of taking up the whole top of the screen.
- List rows wrap their buttons underneath on narrow screens, so names and details aren't squashed. The server header on the Overview no longer breaks the name across three lines.
New
- Anti-spam (Protection page): catches people sending too many messages too fast, or repeating the same message. FireFly deletes the spam and times them out, warns them (counts toward automatic punishments), kicks them, or only deletes the messages. Admins, people who can manage messages, and roles you choose are never caught. A 30-second cooldown stops it double-punishing.
- Export members to a spreadsheet (Members โ Export). Uses your current search, filter and sort, and includes roles, warnings, level, messages, last active and who invited them.
- Edit role menus: change the roles, title, text, color or mode, and the message in Discord updates (it's reposted if someone deleted it).
- Edit scheduled posts instead of deleting and recreating them.
/ticket add, /ticket remove, /ticket close inside ticket channels, for staff and the person who opened the ticket.
- Copy a layout from another server (Backups โ "From your other servers"): create the roles and channels another of your servers has, using its backup.
- Keyboard shortcuts: press
? to see them; / jumps to the search box on the current page.
- Members with mod notes show a notes tag in the members list.
Fixes
- Found by the new tests: adding the notes tag briefly broke the notes list in member profiles. Fixed before release.
New
- Auto-replies (new page): FireFly answers when a message contains, starts with, or exactly matches some text, or contains a whole word. Options: reply as a card, reply to the message, delete the triggering message (great for scam phrases), only in certain channels, and a cooldown so it doesn't spam. A test box shows which auto-reply would answer any message.
- Sticky messages: a message that's reposted at the bottom of a channel whenever people chat, so rules or instructions are always visible.
- Stats counters (Channels โ Stats counters): locked voice channels like "Members: 248", "People", "Bots", "Boosts", "Channels" or "Roles" that update by themselves.
- Give or remove a role for everyone (Roles โ the people icon on a role): people only, bots only, or everyone. Runs in the background with a progress bar and a Stop button.
- Audit log filter by kind of change: channels, roles, members, bans and kicks, messages, invites, server settings, AutoMod.
Quality of life
- The sidebar's Live/Refresh/Log out bar stays visible on short screens.
- Plurals read properly everywhere ("3 replies", "2 entries").
Fixes
- An automated check now makes sure no two dashboard API routes can collide.
New
- Health check (Settings): spots missing permissions, FireFly's role being too low, the member list not loading, slash commands not set up, mod-log/welcome channels FireFly can't post in, and recent errors. Each problem says how to fix it. The Overview shows a "setup problems" button when something needs attention.
- Error log viewer (Settings โ Error log): read, copy or clear
data/errors.log from the dashboard.
- Invite tracking: FireFly works out which invite each new member used. The mod log says "Invited by โฆ", profiles show who invited someone and how many people they've invited, and the Overview lists top inviters.
- Temporary bans: ban for 1 day, 3 days, a week or 30 days; FireFly unbans automatically. The Bans page shows when each one ends. Also available as
/ban โฆ days:.
- Bulk ban and bulk timeout on the Members page (alongside give/remove role and kick). Bulk ban works for user IDs that aren't in the server.
- Move channels and categories up or down on the Channels page.
Quality of life
- Browser back/forward buttons work between pages, and refreshing keeps you on the same page.
- Members page: "Load more" instead of stopping at 300 people.
- Messages page: "Load older messages" and a search box for the loaded messages.
- New slash commands listed on the Settings page.
Fixes
- Channel ordering is now deterministic when Discord reports equal positions.
Anti-raid, setup wizard, tickets, levels, member profiles with mod notes, live updates, verification gate, polls and giveaways, autostart and hosting guide.