[1.21] Ultimate Trivia - Create & Play Custom Chat Quizzes!

Ultimate Trivia - Quizzes for your Minecraft Chat!
Ultimate Trivia is the perfect plugin for your Minecraft chat. From colours to messages to questions. You can customise this plugin to your liking. Perfect for servers that want to add interactive events and fun challenges.

Next update: Bugfixes and Improvements

✨ Features Update
✅ Random Trivia Questions – Questions are randomly chosen from a configurable list.
✅ Difficulty levels - configure different questions and set everything individually for EASY, MEDIUM, HARD questions
✅ Rewards for winners - Adjustable item rewards for the winners of the quiz
✅ Timed Quiz Events – Players have a configurable time limit (default: 30 seconds) to answer each question.
✅ Automatic Quiz Events – A new quiz starts automatically within a configurable interval (default: 5-20 minutes).
✅ Flexible Answering System – Supports both full answers and partial answers inside parentheses.
✅ Short answer? - If set, you will receive a “You're close” message.
✅Time remaining - Display the remaining time in the action bar
✅ Sound Effects – Customizable sound effects for starting, winning, and losing a quiz , all configurable via config.yml.
✅ Firework Celebration – A firework spawns at the winner’s location when they answer correctly, with customizable colors .
✅ Operator Commands & Actionbar Notifications – Operator or player with the specific permission (see below) can manually start quizzes, with actionbar messages instead of chat spam.
✅ No Answer? – If no one answers correctly, the quiz ends, and the correct answer is revealed (if enabled in config).
✅Detailed command - You have the option of executing /quiz start | end | reload | info

Commands:
/quiz start – Start a new quiz
/quiz end - End a new quiz
/quiz reload (Reloads the config and creates a new folder if necessary)

/quiz info

⚙️ Configuration:
Edit config.yml to add your own questions in the format:

questions:
  # Formatting of the questions:
  # - "Question";Answer;
  # IMPORTANT: Don't forget the ; and the space after the -
  easy:
    - "Which mob is attracted to glow berries?;Fox"
    - "What material is needed to make a Nether portal?;Obsidian"
    - "Which enchantment allows you to walk on water?;Frost Walker"
    - "What tool do you need to mine diamonds?;Iron Pickaxe"
  medium:
    - "Which potion effect allows you to jump higher?;Jump Boost"
    - "What is the rarest ore in the Overworld?;Emerald"
    - "Which hostile mob can break doors on hard difficulty?;Zombie"
    - "What is the name of the dimension where Endermen spawn naturally?;The End"
  hard:
    - "How many blocks high can you fall without taking damage?;3"
    - "What is the crafting recipe for a bookshelf?;6 wood planks, 3 books"
    - "Which block is used to craft a beacon?;Obsidian"
    - "What is the default maximum build height in Minecraft?;319"

difficulties:
  EASY:
    text: "Beginner"
    color: "#00FF00"
  MEDIUM:
    text: "Advanced"
    color: "#FFFF00"
  HARD:
    text: "Expert"
    color: "#FF0000"

quiz-interval-min: 5  # Minimum minutes until the next question
quiz-interval-max: 20 # Maximum minutes until the next question
action-bar-threshold: 10 #Time in seconds from when the available time should be displayed in the action bar

# Time limits for different difficulty levels
quiz-time-limit:
  EASY: 30  # Seconds for easy questions
  MEDIUM: 20  # Seconds for medium questions
  HARD: 10  # Seconds for hard questions

winner-sound: true  # Sound at win
winner-firework: true  # Firework at win
show-correct-answer: true  # Show the right answer in chat
show-player-answers: true  # Show player answers in chat
show-close-answer: true  # Show message when a player is close to the correct answer
close-answer-threshold: 3  # Maximum number of allowed mistakes for a "You're close!" message
show-time-in-chat: true # Shows the time with a new question in the chat
show-action-bar: true  # Show action bar for time warnings
show-question-frame: true # Displays new questions with a frame

# Colors for quiz messages (Hex values)
quiz-colors:
  EASY:
    title-start: "#FF5733"
    title-end: "#FFC300"
    description-start: "#33FF57"
    description-end: "#57C3FF"
    close-answer-start: "#FFFF33"
    close-answer-end: "#FFD700"
  MEDIUM:
    title-start: "#5733FF"
    title-end: "#C300FF"
    description-start: "#57FF33"
    description-end: "#C3FF57"
    close-answer-start: "#FFD700"
    close-answer-end: "#FFA500"
  HARD:
    title-start: "#FF3333"
    title-end: "#FF5733"
    description-start: "#FF3333"
    description-end: "#FF9900"
    close-answer-start: "#FFA500"
    close-answer-end: "#FF4500"

# Customizable messages
messages:
  question: "❓❓ {DIFFICULTY} Question: {question}"
  time-left: "You have {time} seconds to give the right answer!"
  correct-answer: "The right answer was: {answer}"
  no-answer: "The quiz is over! No one has given the correct answer."
  winner: "{player} has won the quiz!"
  close-answer: " You're close! Try again."

# Firework settings
firework-color: "random"  # Can be a specific Hex-Color or "random"

# Sound settings per difficulty
sounds:
  EASY:
    new-question:
      sound: "BLOCK_NOTE_BLOCK_PLING"
      pitch: 1.3
    no-answer:
      sound: "ENTITY_VILLAGER_NO"
      pitch: 0.7
    winner:
      sound: "UI_TOAST_CHALLENGE_COMPLETE"
      pitch: 0.9
    close-answer:
      sound: "BLOCK_NOTE_BLOCK_HARP"
      pitch: 1.2
  MEDIUM:
    new-question:
      sound: "BLOCK_NOTE_BLOCK_BELL"
      pitch: 1.1
    no-answer:
      sound: "ENTITY_VILLAGER_NO"
      pitch: 0.8
    winner:
      sound: "UI_TOAST_CHALLENGE_COMPLETE"
      pitch: 1.0
    close-answer:
      sound: "BLOCK_NOTE_BLOCK_HARP"
      pitch: 1.1
  HARD:
    new-question:
      sound: "BLOCK_NOTE_BLOCK_BASS"
      pitch: 1.0
    no-answer:
      sound: "ENTITY_VILLAGER_NO"
      pitch: 0.9
    winner:
      sound: "UI_TOAST_CHALLENGE_COMPLETE"
      pitch: 1.2
    close-answer:
      sound: "BLOCK_NOTE_BLOCK_HARP"
      pitch: 1.0

⚙️ Winner Items:
Customise the name, color, title and sound of the winning item

settings:
  winner-title: "Congratulations!"
  winner-subtitle: "You won the Quiz!"
  winner-sound: "ENTITY_PLAYER_LEVELUP"
  winner-sound-pitch: 1.2
  winner-title-start: "#FFD700"
  winner-title-end: "#FFA500"
  winner-subtitle-start: "#00FF00"
  winner-subtitle-end: "#009900"
  winner-rewards: true

rewards:
  EASY:
    - "DIAMOND;1;Shiny Diamond;#00FFFF;#0000FF"
  MEDIUM:
    - "GOLDEN_APPLE;2;Golden Apple;#FFFF00;#FFA500"
  HARD:
    - "NETHERITE_INGOT;1;Legendary Netherite;#FF0000;#800000"

Permissions:
UltimateTrivia.use: Allows the player to use quiz commands.
UltimateTrivia.start: Allows the player to start a quiz.
UltimateTrivia.end: Allows the player to end a quiz.
UltimateTrivia.reload: Allows the player to reload the quiz configuration.
The default for each permission is Operator.

How It Works:
A quiz starts automatically or via /quiz.
The question appears in chat, with players having 10-30 seconds (Default value) to answer.
The first player to answer correctly wins, getting a firework and receives one or more items as a reward
If no one answers, the quiz ends and reveals the correct answer.
A new quiz will start randomly between 5-20 minutes (Default value) later.