Settings-Discord-Party-Plugin
Discord Party Configuration

Runs your Discord karaoke room for you. Only the singer whose song is playing can talk, missing singers get paged automatically, and filler music can play into the channel between songs. You run QUP; the bot runs the room.
Discord Party comes with QUP. Its settings are in Preferences → Plugins → Discord Party (Preferences is Ctrl+P).
QUP moves an "On Stage" role as the rotation advances, rather than server-muting people. That matters: a server-mute sticks to a user across sessions and channels, so the classic failure is somebody turning up next week still muted with nobody remembering why. A role has no such memory.
How a show runs
You screen-share QUP (the CDG window and its audio) into the karaoke voice channel with Go Live. By convention only the current singer opens that share — it's their private feed. The singer sets their Discord input to Stereo Mix with "listen to this device" enabled on their microphone, so the room hears the karaoke and their voice as one already-synced stream.
Everything else — who can talk, who's up, what fills the gaps — is what this plugin handles.
The status line near the top of the pane shows the bot's status (for example "Not connected" or "Disabled") and the last thing it did in the room.
Enable Discord room automation — The master switch. Off by default. Clicking Connect ticks it for you. While it is on and the bot, server and voice channel are set, the bot connects by itself each time QUP starts.
Bot
Create an application at discord.com/developers/applications, open the Bot tab, click Reset Token, and paste the token here. No privileged intents are needed.
Bot token — The token from the developer portal. Treat it like a password; anyone holding it controls your bot.
Connect / Disconnect — Brings the bot online or takes it offline. Disconnecting also unlocks the room and clears the stage, so it's safe to use mid-show.
Copy invite URL — Copies a link that adds the bot to your server with exactly the permissions it needs. Connect first: the link needs the bot's ID. Open the link in a browser and pick your server. Use this rather than hand-picking permissions — under-granting Manage Roles is the usual reason setup fails.
After inviting, go to Server Settings → Roles and drag the bot's role above the "On Stage" role. Discord won't let a bot manage a role that outranks it.
Server & channels
Server — Which Discord server to run. Populates once the bot connects.
Karaoke voice channel — Where the show happens. This is the channel QUP locks and unlocks.
Announcements channel — Where "Now singing" and "Up next" posts go, and where missing singers are paged. Optional; leave as (none) to stay silent, but then nobody gets a ping when they're up.
Refresh lists — Re-reads servers and channels from Discord, for when you've just created one.
Set up my channel — Saves your settings, then prepares the room: gives the bot its own permissions on the channel, creates the "On Stage" role if it's missing, denies Speak to @everyone, and registers the /iam and /whoami commands. It is safe to run again at any time — it's also the test button. Each step is listed in the box below the buttons. If a step fails it stops there and tells you what to fix; it never leaves the room half-locked.
Show rules
Grace period for a missing singer (seconds) — How long a singer gets to appear before their song is skipped. Default 60 (up to 3600). Set it to 0 to skip immediately instead of waiting.
Open mic — Who can talk, and when.
- Off — room stays locked all show — Only the current singer and you can speak.
- On — room opens between songs, plus the applause windows below — The room opens between songs, and for a window at each end of a song so people can cheer. This is the default.
- Always — never lock the room (badges and paging still run) — Nobody is ever silenced.
The two applause windows can only be set when Open mic is On.
Open for the first N seconds of a song (0 = off) — The applause window at the start. Default 10.
Open for the last N seconds of a song (0 = off) — The applause window at the end. Default 15. Seeking into or out of this window re-opens or re-locks the room as you'd expect.
Bot plays filler music into the voice channel — Off by default. Sends your filler music into Discord between songs, so the room isn't silent while nobody is sharing. The karaoke performance itself is not sent this way. With this off the bot doesn't sit in the voice channel at all.
Skip the song if the singer leaves the channel mid-song — Off by default: the track plays out and you can hit Next yourself. Turn it on to treat walking off as a skip. Either way there's a few seconds' grace, because Discord drops people out of channels briefly all the time.
Require the singer's PIN for /iam — On by default, and recommended. Claiming a name opens a private dialog asking for the singer's PIN, so nobody can take somebody else's slot. Singers who sign up on their phone get a PIN automatically; anyone who signed up before this feature existed needs to open the QUP app once so their PIN syncs. Until then /iam will tell them there's no PIN on file, and you can map them by hand below. After 10 wrong tries, a Discord user has to wait two minutes before trying again. Off: anyone can claim any name.
Singer mapping
QUP has to know which Discord account belongs to which singer name. Singers do this themselves with /iam in Discord — it asks for their singer name and PIN in a private dialog nobody else can see. /whoami tells them who they're currently mapped to, and running /iam with the name left blank un-claims it.
The table shows every mapping (Discord user, QUP singer name, and Source: slash when the singer used /iam, manual when you added it) and lets you fix things by hand.
Add / edit… — Map a Discord user ID to a singer name yourself. Type the singer name exactly as it appears in the rotation. This skips the PIN entirely, which is your escape hatch when someone's PIN isn't working mid-show. To get a user ID, right-click the person in Discord and choose Copy User ID.
Delete row — Removes the selected mapping.
Suggest from room… — Lists the people currently sitting in the karaoke voice channel so you can map one without copying IDs around. Suggestions are never applied automatically — nicknames and duplicate first names make guessing unsafe.
Duets — Map a second Discord user to the same singer name and both go on stage together. Since PINs are meant to be shareable, a duet partner can simply run /iam with the same name and PIN and sort it out themselves.
What happens during a show
When a song starts, QUP takes the role off whoever had it, gives it to the singer whose song is playing, and posts "Now singing" to the announcements channel. When the song ends the role comes off again.
If the singer isn't in the voice channel, QUP pauses the song, pings them in the announcements channel, and waits out the grace period. If they turn up, it resumes. If they don't, it skips to the next song exactly as if you'd pressed Next.
If a singer has no mapping, the show carries on — they simply don't get the role, and a note in the announcements channel asks them to run /iam.
Save settings — Saves the configuration and applies it to the running bot. Settings are also saved when you close the Preferences window.
If Discord goes down
Nothing that happens on Discord's side can affect your local playback. A dropped connection, a revoked token, or the bot being kicked all degrade to the same thing: room automation stops, a message appears in the status line at the top of this page, and the music keeps playing.
Updated on version 2.35.0, October 31, 2026