TriviaCore | Advanced Quiz Plugin v1.0

TriviaCore - The Professional Educational Quiz System
TriviaCore is a high-performance, interactive quiz plugin designed to engage your community through competition and learning. Whether you are running a language-learning server or a classic network, TriviaCore provides modern tools to make it happen.

Key Features

• Interactive JSON Chat: Supports "Fill-in-the-blank" modes with clickable chat options. Players can click an answer directly in their chat window.
• Dual Storage Engine: Choose between local YAML storage or high-speed MySQL for cross-server synchronization (perfect for networks).
• Visual BossBar: A dynamic countdown timer at the top of the screen provides visual feedback and maintains tension.
• Discord Integration: Automated alerts via Webhooks when a quiz starts. Includes customizable embeds with question previews.
• Custom Reward Sets: Define multiple reward tiers in config.yml (e.g., Standard, Legendary) and assign them to specific questions.
• Typo Tolerance: Integrated Levenshtein algorithm allows for minor typos in long answers, making it fair for all players.
• Developer API: Custom events (QuizStartEvent, QuizWinEvent) allow other developers to build addons or complex logic.
• Hex Color Support: Full support for modern Minecraft colors (&#RRGGBB) in all messages.

Commands & Permission

• /quiz start:
  • Manually force a random quiz to start.
  • Required permission: quiz.admin
• /quiz stop
  • Immediately cancel the active quiz.
  • Required permission: quiz.admin
• /quiz stop
  • Reload all configurations, messages, and quiz files.
  • Required permission: quiz.admin
• /quiz stats [player]
  • View your own or another player's total wins.
  • Required permission: none

Documentation & Configuration

1. Creating Quizzes (quizzes.yml)
   Define questions in categories. Use type: FILL_BLANK for interactive clickable options.
   categories: spanish_verbs: type: FILL_BLANK reward-set: legendary # Link to config.yml rewards question: "&eComplete the sentence: &bYo ____ un perro." answers: ["tengo"] options: ["tengo", "tienes", "tiene", "tenemos"]
2. Custom Reward Sets (config.yml)
   You can define multiple command lists. The plugin executes these as the Console.
   rewards: sets: default: - "eco give %player% 500" - "broadcast &a%player% won the quiz!" legendary: - "eco give %player% 5000" - "give %player% netherite_ingot 1"
3. PlaceholderAPI Integration
   Integrate win counts into your Tab, Scoreboard, or Holograms:
   %triviacore_wins% - Returns the total number of quiz victories for the player.

Developer API
Listen to events in your own custom addon:
@EventHandler public void onQuizWin(QuizWinEvent event) { Player winner = event.getWinner(); String answer = event.getAnswer(); // Your custom reward or logging logic here }

Installation

1. Drop TriviaCore.jar into your plugins folder.
2. Restart the server to generate default files.
3. Configure the plugin as you like.
4. Run /quiz reload