Bukkit

ChatContests
ChatContests is a fun plugin to allow server admins to add repeating contests to their server which provide the winning player with prizes

Installation
Drag the built file into the plugins folder, and you will be good to go.

For further configuration, once you run the server once go to plugins/ChatContests and edit the config.yml or the contests.jsonfiles.

Usage
Player
As a player, when the chat message appears saying there is an active contest, all you need to do is answer the question in chat

Admin
contests.json
The contests.json file is where all the contests are stored. The file must be a JSON array (everything contained in []) with each contest then being wrapped in {}.

A contest can have multiple prizes

Basic Prize

{
  "action" : "command",
  "option" : "give {player} minecraft:gold_ingot 1"
}

Basic Prize Array

[
  {
   "action" : "command",
   "option" : "give {player} minecraft:gold_ingot 1"
  },
  {
   "action" : "command",
   "option" : "give {player} minecraft:diamond 1"
  }
]

Basic Contest

{
   "question": "What is 9+10?",
   "answer": "19",
   "prizes" : [{
     "action" : "command",
     "option" : "give {player} minecraft:gold_ingot 1"
   }]
}

Basic contests.json

[
  {
   "question": "What is 9+10?",
   "answer": "19",
   "prizes" : [{
     "action" : "command",
     "option" : "give {player} minecraft:gold_ingot 1"
   }]
  },
  {
   "question": "Are you alive?",
   "answer": "yes",
   "prizes" : [{
     "action" : "command",
     "option" : "give {player} minecraft:gold_ingot 1"
   }]
  }
]

prizePools.json
The prizePools.json file is where all the prize pools are stored. The file must be a JSON object (everything contained in {}) with each pool then being wrapped in "poolName": {}.

The config with a single pool will look like:

{
    "default": [{
        "action": "COMMAND",
        "option": "give {player} minecraft:gold_ingot 1"
    }]
}

with two pools it will look like: 

{
    "default": [{
        "action": "COMMAND",
        "option": "give {player} minecraft:gold_ingot 1"
    }],
    "pool2": [{
        "action": "COMMAND",
        "option": "give {player} minecraft:gold_ingot 1"
    }]
}

Prize Action Types

• COMMAND

config.yml

# Welcome to ChatContests config.yml
# Here you can configure everything about the plugin

prefix: '&3Contests'

# Interval in seconds
interval: 300

newContestMessage:
  - '&7&l---------------'
  - '&f'
  - '&fA new contest has begun!'
  - '{question}'
  - '&f'
  - '&7&l---------------'

winnerAnnouncementMessage:
  - '&7&l---------------'
  - '&f'
  - '&fThe winner is'
  - '{player}'
  - '&f'
  - '&7&l---------------'

checkForUpdates: true

Commands

• /chatcontests reset
• /chatcontests trigger
• /chatcontests reload

Permissions

• chatcontests.use - default: everyone - Allows ability to answer questions
• chatcontests.admin - default: op - Allows use of admin commands

Issues
Feature Requests
Feature requests are always welcome! Please create an issue with the tag feature

Bugs
We always want to stamp out bugs, please create an issue with the bug tag and then also list the plugins you use, any errors from the console, screenshots (if possible) and steps to re-create the issue.

The more info we have, the more likely we are to patch the bug 

Contributions
Contributions are welcome, just make a Pull Request or an Issue with the correct tag and they can be discussed

Proof of Concept Stage
The plugin is currently in proof of concept stage, meaning that it may have bugs or be inefficient. The goal of the first versions is to gauge interest. Once ready, the plugin will be re-coded for the most part ready for official release.

Metrics (bStats)

This project uses bStats to gether information on how many servers use it. If you want to disable metrics you can do so by editing the bStats config file located in

For more information please visit https://bstats.org/

Update Notifications

This project pings the spigot hosted version to check if there are any updates available. This can be disabled in the config.yml.

License
MIT