KMDA Trivia: Synchronized multiple-choice trivia for your guild, your friends, and your whole raid group

What is it?

Highlights

• Multiplayer for any group. Party, raid, or instance group. Only the group leader or an assistant can host.
• Solo play. No group needed. You can host for yourself to practice, learn the panels, and test your own custom questions before a real event.
• Fast-answer scoring. 10 points for an instant correct answer, minus 1 point per full second, never below 1.
• Host timers. 10, 15, 20, 30, 45 or 60 seconds, or no timer at all. Optionally end a question as soon as everyone has answered.
• Live host panel. Question card, answer distribution bars, responses, standings, pause, previous/next, and one-click announcements of the answer and scores to chat.
• Player panel. Four big answer buttons, a countdown bar, instant right/wrong feedback, and your running score.
• Topic icons. Each topic has its own small crest that fades in on the question card.
• Custom topics. Paste your own questions, validate them, and use them right away (see below).
• KMDA look. Royal blue and gold, straight from the guild certificate.

What's in the initial release

Getting started

1. Install the addon and log in. Everyone in the group should run the same version.
2. Type /kt to open the player window.
3. To host, type /kt lead (you need to be the group leader or an assistant, or playing solo).
4. Pick a topic and a timer, then press Send Question.
5. Players tap an answer. Press Announce Answer and Announce Scores whenever you like.

Practice solo, and test your own questions

• The pasted text is only ever read as data, never run as code, so a table from another guild cannot do anything unexpected.
• Validation checks every question (all four choices, a valid correct letter, no duplicate answers, and that it fits the network message limit) and tells you exactly which one needs fixing.
• Guilds can share their own question sets as plain text.

{
    ["My Guild Lore"] = {
        icon = "XX",   -- optional 2-character icon token
        {
            q = "What is our guild's name?",
            a = "Kiss My Darnassus", b = "Kiss My Orgrimmar",
            c = "Kiss My Stormwind", d = "Kiss My Thunder Bluff",
            correct = "A"
        },
    },
}

Slash commands

* new in 1.1.0h
/kt config                                                             Opens config panel with accesss to play mode
                                                                             custom topics and help

How multiplayer works

• Addon messages, not chat spam. Everything travels as hidden addon messages on the prefix kmdatrivia. Nobody sees codes in their chat window.
• The host broadcasts, players whisper back. The host sends each question to the group (instance, raid or party channel). Answers are whispered only to the host, so other players cannot see them and the host never has to read the group channel.
• Small, validated messages. A question is sent as one compact message, kept under the 255-byte limit. Every built-in question is checked against that limit on load, and every imported question is checked before it is saved.
• Handlers per message type. The addon routes each incoming message to a small handler: START_Q (new question), PAUSE / RESUME, END_Q (reveal the answer), SB (scoreboard pages), RESET, ANSWER, and SYNC_REQ.
• Only the host is trusted. Clients ignore question, pause, end and scoreboard messages from anyone who is not the group leader or an assistant.
• Built to survive throttling. Outgoing messages wait in a queue and go out through a token bucket, so bursts are paced instead of silently dropped by Blizzard's throttle.
• Fair timing. The host keeps the clock and sends the elapsed time with each question, so a late joiner or a /reload does not break the countdown.
• Recovery. After a /reload or when you join the group mid-question, the addon asks the host for the live question (SYNC_REQ) and catches up.
• Safe imports. Pasted topic tables go through a small data-only parser, never through Lua's code loader.

Please read: when to use it

Open source, and credits

Thank you