Modules

Bingo

Bingo is a competition run through Sparrow, played in teams or solo. Players complete tasks for points and send a screenshot as proof, and staff review every submission. You build the bingo on the dashboard, and players take part in Discord or on the bingo's own web page.

How a bingo works

1. Staff build the bingo on the dashboard: its tasks, its teams or players, and who can review.
2. Sparrow creates the bingo's channels and roles. In a team bingo, each team gets its own private channel and board.
3. Players send a screenshot as proof with /bingo submit, the Submit button on the leaderboard, or the Bingo Portal.
4. Staff approve, modify, reject or undo each submission. Approved points show on the board right away.
5. The bingo ends when time runs out or someone finishes every square. The winners are announced, and a week later Sparrow removes the bingo's channels and roles.

Creating a bingo

Open Bingo Panel → Create Bingo on the dashboard. The bingo is a draft until you start it, so you can save and come back any time. Players can't see it yet. You can also start from a template.

Changes on every tab save together with the Save Changes bar at the bottom. Adding or removing something, like a task, a team or an allowlist entry, saves right away.

Before you can start, a team bingo needs its channels set up in General and at least one team. A person can only be on one team per bingo. If you add someone who's already on another team, Sparrow says which team they're on and doesn't add them.

Solo bingo

Pick Solo in the General tab's Mode while the bingo is still a draft, and everyone plays on their own card. Nobody needs a team or a channel of their own. The leaderboard message becomes the bingo's panel, with four buttons:

• Join: players join themselves, before or during the bingo. They get a DM with links to the panel and the Bingo Portal.
• Submit: a form with the square, the screenshot, how many (when a square needs more than one) and an optional note.
• My card: their own bingo card, only to them.
• Leaderboard: everyone's places, 10 a page, starting on the page with their own.

In the General tab's Players panel you choose:

• Who can join: one or more roles, or everyone.
• Staff accept each player: joining sends a request with Accept and Deny buttons to the review channel. Staff can also decide on the dashboard's Players tab or the Bingo Portal.
• A player role: given when someone joins (or is accepted), and taken back when the bingo is archived.
• Show squares on the leaderboard, or points only.

The roles that can join and the player role can see the bingo's panel and submission channels. Staff can add or remove players on the Players tab. A solo bingo can have up to 50 players, or 500 with Premium.

Tasks, tiers and hidden tasks

Each task has a name, a description, points, and how many times it has to be completed. A task that needs a team to do something five times is one task with a required count of 5, and a player can submit progress toward it a piece at a time. A task can also have a picture, like the item or boss it's about, which shows on its square on the bingo card.

Group tasks into tiers. Sparrow suggests Easy, Medium, Hard and Elite, or you can make your own. Teams can browse their tasks by tier on their board.

A task can also be hidden: invisible until it's revealed to a team. You choose what reveals it:

• a team reaching a number of points,
• the first team to reach a number of points,
• a team completing every task in one or more tiers, or
• the first team to complete those tiers.

"First team" reveals are exclusive: only the winning team ever sees the task, and it appears in that team's channel. A task can also unlock on a date. Staff can reveal a hidden task to one team, or all of them, at any time with /bingo task reveal. When a team or player has done every square they can see and only locked hidden ones are left, staff are told in the review channel and can unlock them right away with one button (or on the Bingo Portal's staff page).

The bingo card

On the Bingo Card tab, pick Bingo card instead of List, and Sparrow draws a real bingo card:

• The leaderboard gets the main card. Each square shows a circle for every team that finished it, and a hidden task stays a "?" until every team has unlocked it, so nobody spoils it.
• Each team board gets that team's own card: done squares, squares waiting for review, progress on tasks that need more than one, and the hidden tasks they've unlocked.
• The tier buttons under a team board show one tier on its own, as a private picture with the Incomplete, Pending and Completed filters.
• The Bingo Portal shows the same cards as a live page (in a solo bingo, each player's own card), with a tier filter that fades the other squares out but keeps them in place.

Done squares show a gold X with the name of the member who did it, or, with Photos, the screenshot staff accepted fills the square. A task's own picture shows behind its square either way. Choose 3 to 7 squares across, and drag a square onto another (or click one, then the other) to arrange them. The cards redraw by themselves after every submission, review and change.

The bingo bonus gives extra points for each full row, column or diagonal (diagonals count when the card is a full square, like 5 x 5 with 25 tasks). A finished line gets a gold frame and its bonus counts in the standings and on the Bingo Portal. A card holds up to 49 squares. A bingo with more tasks uses the list board.

Submitting and reviewing

Players run /bingo submit, pick the task, and attach a screenshot. Sparrow works out their team from their roles. If someone is on two bingos at once, the task list shows which bingo each task belongs to. They can add a note for staff, and say how many they completed. Players can also submit from their card page on the Bingo Portal: every open square has a Submit button there.

Each submission reaches staff with Approve, Modify and Reject buttons. Staff can also review from the Bingo Portal, where Approve lets them add a comment for the player, and Discord updates too. Made a mistake? /bingo undo sets a reviewed submission back to pending and takes back its points. The player is told why, with a link to their submission. Every decision is recorded in the bingo's audit thread.

Team boards and channels

Each team gets a private channel and a board that shows their progress and points, with their bingo card when you use one. Boards update when a submission is sent or reviewed. The leaderboard message shows the top 10, with buttons for everyone:

• Submit: the same form as a solo bingo (the square, the screenshot, how many and a note). Sparrow finds the team from the player's roles.
• My team's card: their team's card or board, only to them.
• Full leaderboard: every team, 10 a page, with their own team marked.

Someone who isn't on a team is told so, and nothing is sent. Staff can move a team's board to a different channel with /bingo teamboard post, refresh them all with /bingo teamboard refresh-all, and refresh the leaderboard with /bingo dashboard refresh.

Sparrow only deletes channels it created. A channel you picked yourself is never removed when the bingo is archived.

Who can run a bingo

Staff access to a bingo comes from any one of these:

• Bingo Staff roles: set for each bingo in its General tab. They can review and use the staff commands for that bingo only.
• Bingo Manager Role: set in Bingo Settings → Roles (or with /roles). Manages and creates every bingo.
• Sparrow Master Roles and server admins (Administrator or Manage Server): full access to everything.

Everyone with one of these is added to the bingo's private channels automatically, and removed if they lose the role. None of these roles need any Discord permission. See Access & Permissions.

The Bingo Portal

Every bingo has its own web page. Members sign in with Discord and Sparrow shows them the right view: team members see their team's card, tasks, members and charts, solo players see their own card, staff see the review queue, and everyone else in the server sees the standings and the main card. Nobody needs a password for this. Share the link from the Start tab. Someone outside your server who gets the link sees nothing unless you let them in.

Players signed in with Discord can submit squares right from their card page. The standings show 10 a page, with a search box and a filter for everyone, the winners, or the places around your own.

In the Advance tab you can also:

• allow public access with a password, with an optional expiry. Anyone with the password can see the standings without signing in, but not a team's or staff view.
• give each team its own team password, instead of checking their roles.
• use the Manual Allowlist: pick a member or a role, and whether they can see the Dashboard (standings), one team's portal, or the staff view. A member you add gets in even if they're not in your server, like a guest judge.

After a few wrong passwords, sign-in is paused and the visitor is told to contact bingo staff. It doesn't say whether they belong to a team. You can clear a pause early on the Bingo Portal page.

Changing or removing a password signs out everyone who used the old one. A password works for 12 hours before it has to be entered again.

Ratings

Bingo has its own category in Reviews. Turn it on under Reviews → Bingo → Review Settings, where you also choose the log channel, and members are asked to rate the bingo after results go out. Ratings show up in Reviews (where you can search by reviewer) and as a Ratings card on the bingo's page in Bingo History. Each bingo can also use its own rating message instead of the server-wide one.

Templates

To run the same kind of bingo again, use Save as template in the Bingo Panel's ⋯ menu (or the Task tab), then start a new one from Bingo Templates. A template keeps the tiers, tasks, task pictures, hidden task reveals and Bingo Card settings. It doesn't keep teams or members, dates, channels or submissions, so you add those each time. Sparrow also has starter templates.

For a one-off copy, pick Duplicate in the same menu: a new draft with the same setup, plus the description, logo, staff roles and review message. Teams, members, dates and channels start fresh.

Winners, ending and archiving

A bingo ends in one of three ways:

• Time runs out, and the most points wins.
• Someone finishes every square, including hidden ones they can still unlock. They win straight away, whatever the points. It goes by when they sent their last square: if someone else sent theirs earlier and it's still waiting for review, that review comes first.
• Staff run /bingo end.

Pick how many winners in the General tab: 1, or the top 2 to 10. Whoever finishes every square first is always 1st, and the rest go by points. A place needs at least 1 point to win. The results post names every winner, and each player or team gets their own place.

Results are posted in the bingo's dashboard channel and to each team's channel. Seven days later, Sparrow removes the bingo's channels and roles (or staff can do it right away with /bingo archive, which asks you to confirm and lists exactly what will be deleted).

If submissions are still waiting for review when the end date arrives, new submissions are locked and the bingo ends once staff finish reviewing. The leaderboard and the Bingo Portal say how many are still waiting. /bingo end asks first when some are still waiting: if you end anyway, they stay unreviewed and earn no points. After a bingo has ended, a review can't be undone, but Modify still works.

Nothing about the results is lost: standings and every submission stay in Bingo History on the dashboard, and the bingo's audit thread stays in your audit forum. Pick the forum, and a category for archived channels, in Bingo Settings.

Free servers & Premium

Bingo is free, the bingo card included. Every server can run as many bingos as it likes at once, with up to 300 tasks each, 10 saved templates, reveals on a date or by points or tiers, a portal password for visitors, a custom review message for one bingo, a custom footer and the Bingo Manager Role. The one difference is size: a bingo can have up to 10 teams for free, or 25 with Premium, and a solo bingo up to 50 players for free, or 500 with Premium. Teams and players you already have keep playing if Premium ends.

Commands

Players use the first five. The rest are for staff, and only staff see them suggested in Discord. See Access & Permissions for what each staff tier means.

Have a question that isn't here? Check Common Questions or open a ticket in our support server.