Introduction

This plugin is based on org.spigotmc:spigot-api:1.20.1-R0.1-SNAPSHOT, branching out from my previous project zhisuan11core.

Generally, you can regard it as a simple Database Management System, which manage a Q&A system in a Minecraft server.

It also helps me prepare in advance for my database system course assignments.

Now, it uses AnvilGUI to provide blank quiz system.

Configuration

The Q&A system has two ways to storage data: YAML, MYSQL.

Since plugin version 1.1.0, fill-in-the-blanks quiz has been supported!

If you choose YAML type, please set your quiz at Quiz.yml in the format below:

Choice:
  - Question: "Which of the following is not a valid IP address?"
    Options:
      A: "172.28.45.56"
      B: "192.168.0.1"
      C: "240e:360:6f43:500:d14d:dbd0:97:b3b3"
      D: "127.256.3.34"
    Answer: D
    Reward: DIAMOND
  - Question: "Which of the following file formats are not considered compressed files"
    Options:
      A: "zip"
      B: "rar"
      C: "7z"
      D: "png"
    Answer: D
    Reward: DIAMOND

Blank:
  - Question: "1+1=?"
    Answer: "2"
    Reward: DIAMOND

Since version 1.1.2, you can set Reward a number if you have Vault based plugins.

However, they must be written in a String format, which means wrapping them with double quotation marks.

Or if you prefer MYSQL, please create a new database named serverquiz and set your basic config in advance:

config:
  storage: MYSQL
  host: { your host }
  port: { your port }
  name: { your name }
  password: { your password }
  database: serverquiz

The configuration file has been updated! You can easily set some configurations now. Other config options is shown below:

###########################################
##             Update checker            ##
###########################################

updateChecker:
  # Option: modrinth/github
  source: modrinth
  enable: true

##############################################
##            Broadcast messages            ##
##############################################

broadcast:
  # The text must be written in a single line
  text: "§e============\n§6§lNew Quiz begins! \n【Click here】 to join§r§e\n============"
  hover: "§7Click to join Server Quiz!"
  # The time between each quiz, the unit is seconds
  interval: 900

##############################################
##             Answer messages              ##
##############################################

messages:
  # A player has already given the correct answer
  hasWinner: "The quiz has already been solved!"
  # You have answered the quiz
  hasAnswered: "You have already answered this quiz!"
  # Your answer is right
  correct: "You have solved the quiz!"
  # Your answer is wrong
  wrong: "Your answer is wrong!"
  # Send Reward
  sendReward: "Reward has been sent to you: "
  # Update player's score
  score: "Your score board has been updated!"

##############################################
##              The GUI text                ##
##############################################

gui:
  title: "Quiz Menu"
  question: "Question"
  reward: "Reward"
  # Available for choice quiz
  choice:
    option: "Option "
    # Whether to arrange options randomly
    random: true
  # Available for blank quiz
  blank:
    answerSheet: "Answer sheet"
    answerTitle: "Type your Answer"
  # Scoreboard settings
  scoreBoard:
    title: "§rYour quiz score board"
    # ServerQuiz has some built-in variables, which can be used here:
    # - %serverquiz_name% : the player's name
    # - %serverquiz_correct% : the number of questions correctly answered by the player
    # - %serverquiz_total% : the total number of questions answered by the player
    # - %serverquiz_accuracy% : the accuracy of the player answering questions
    lore:
      - ""
      - "§ePlayer: §f %serverquiz_name%"
      - "§eCorrect: §f %serverquiz_correct%"
      - "§eTotal: §f %serverquiz_total%"
      - "§eAccuracy: §f %serverquiz_accuracy%"

Command

Since version 1.1.1, you can change quiz in the game using command /quiz edit choice or /quiz edit blank.

However, this function is still in development. You'd better do it through Database Manager.