TriviaTreasure for Spigot

Welcome to TriviaTreasure!

Introducing TriviaTreasure: the ultimate chat game for testing your players' knowledge and having a blast! With our easy-to-use in-game menu, you can create your own custom questions and answers, making the game truly unique and tailored to your interests. Set rewards for the winners, and even schedule automatic trivia games at a time that suits you and your players.

Trivia requires minimal setup and is easy to get started with - just install the plugin and you're ready to go! Simply start the game with /trivia start, and the questions will start showing up in chat. The first player to answer each question correctly wins that round, and whoever has the most correct answers at the end of the match takes home the rewards. So, gather your friends and put your skills to the test with Trivia!

Customize Questions and Answers

In Trivia, you can view and manage your customizable questions and answers using the in-game menu. Simply open the menu to see a list of all the questions you have created.



You can click on any individual question to edit its text or answer, or click on the emerald icon to create a new question.
When creating a new question, a chat prompt will appear where you can enter the question and one or more correct answers. This allows you to include multiple correct answers for each question and make your trivia games more flexible and engaging.

Customize Rewards

Rewards are an essential part of any trivia game! As the host, you can set up rewards for first, second, and third place winners, as well as per-round rewards.

Simply drag and drop the desired winning items into the empty slots in the Rewards menu, and configure any additional settings, such as money rewards, experience points, and custom messages. You can even set up commands as rewards to integrate with other plugins and crates systems.

The menu will look like this, and for this example, the first place winner will receive this cool stick:


To save changes, simply exit out of the menu, and winners will receive these rewards on the next game.

Starting the Game

A Trivia game can be started in three ways: from the in-game menu, where you can adjust settings before starting the game; from the chat using the /trivia start command; or from scheduled games. When a game begins, it will display a summary of the game's settings, including the total number of questions, the time limit for each question, and whether or not questions will be repeated.

During the game, questions will be asked round by round. The first player to answer a question correctly in chat wins that round. If no one answers the question within the time limit, the round is skipped. The player who wins the most rounds at the end of the game is declared the winner and receives their rewards.

During the game, a progress bar will be displayed at the top of the screen to show the current round and the total number of rounds.




Schedule Games

Trivia games can be hosted manually, but they can also be set up to run automatically at regular intervals.

To enable this feature, set Scheduled games to true, and set Scheduled games interval to the gap in minutes between hosted games. Finally, set Scheduled games minimum players to the amount of players that are needed to be online for the hosted game to start!

Players can use the /trivia schedule command to view the next scheduled game time.

Language Support

By default, the messages in this plugin are in English, but you can use custom messages in other languages by setting them in the messages.yml file. The file includes placeholders for values, along with explanations of their meanings.
You can also change the colors of the messages using & color codes or hexadecimal codes. To use hexadecimal codes, use the format [#ABCDEF] for the color #ABCDEF.

Commands

These are the commands registered for Trivia:

• /trivia: opens the menu to start a game, modify questions and rewards, or view plugin information (requires trivia.admin permission)
• /trivia start [rounds]: quickly starts a trivia game with the specified number of rounds (defaults to 10 if not specified) (requires trivia.admin permission)
• /trivia stop: immediately stops the current trivia game in progress (requires trivia.admin permission)
• /trivia skip: skips the current question being asked during a trivia game in progress (requires trivia.admin permission)
• /trivia version: displays the plugin's version, API version, and author information (requires trivia.admin permission)
• /trivia reload: reloads the local plugin files after making changes to them (requires trivia.admin permission)
• /trivia stats: shows the player's stats, including win count, money, and experience earned (requires trivia.player permission)
• /trivia schedule: shows the time until the next scheduled game, if enabled (requires trivia.player permission)
• /trivia help: displays an in-game reference of available commands (requires trivia.player permission)

Demo



Other

Placeholder API

Features optional PlaceholderAPI support:

%trivia_game_wins_first%: shows the number of player's wins in first place
%trivia_game_wins_second%: shows the number of player's wins in second place
%trivia_game_wins_third%: shows the number of player's wins in third place
%trivia_game_participation%: shows the number of player's games participated in
%trivia_round_wins%: shows the number of player's rounds won (questions answered correctly)
%trivia_money_won%: shows the player's total monetary earnings from Trivia
%trivia_experience_won%: shows the player's total experience earnings from Trivia
%trivia_game_in_progress%: displays "true" if a game is currently in progress, "false" otherwise
%trivia_next_game%: shows the time until the next scheduled game


Vault API

This plugin features optional support for the Vault API, which is required for giving money as a reward.

bStats API

This plugin uses bStats to collect anonymous usage data. You can view the statistics for this plugin at https://bstats.org/plugin/bukkit/TriviaGUI/7912

Compatibility

The native version of this plugin is for Spigot 1.17 (shown in /trivia version) and tested in Spigot 1.18. The plugin was compiled in Java 17, but it should (most likely) compile in Java 11.