SimplePoll

SimplePoll

SimplePoll is a small polling plugin made for servers that want an easy way to let players vote on things.

Need to decide the next event? Let players pick the next map? Want to settle a server argument? Just make a poll and let everyone vote.

Features

• GUI for viewing active and completed polls

• Pages automatically when you have a lot of polls

• Server-wide announcements when a new poll is created

• Clickable [Click here to answer it!] button in the announcement

• Simple chat-based poll creation wizard

• Vote by clicking an option or typing its number in chat

• Set a time limit for polls, or let them run forever

• Option to let players change their vote

• Polls are saved to disk and survive restarts

• Different ways to handle tied votes

• Pretty much everything can be changed in the config

• Custom GUI titles, items, slots, lore, sounds, and messages

• Supports normal & colors and hex colors

• No database required

How It Works

Players can use /poll to open the main menu.

From there, they can see any active polls and look through completed polls from previous votes.

To vote, just open a poll and click the option you want.

If you prefer using chat, you can also type the number of the option instead. The GUI tells you what number to type, so there's no need to remember anything.

Once the poll ends, SimplePoll figures out which option got the most votes and announces the result.

Creating a Poll

Creating a poll is meant to be pretty simple.

If you have the simplepoll.create permission, you can either click the Create Poll button in the GUI or run:

/poll create

You'll then be asked a few questions in chat:

1. Give the poll a name
2. Enter the question
3. Add your options
4. Set how long the poll should last
5. Look over everything
6. Confirm it

If you mess something up or just change your mind, type cancel at any point to stop.

Poll Announcements

When someone creates a poll, SimplePoll can let the entire server know about it automatically.

The message looks something like:

Poll » PlayerName has made a poll: Server Event! [Click here to answer it!]

The button is actually clickable. Players can click it and SimplePoll will run /poll for them.

You don't have to make your own tellraw command or mess around with JSON.

Don't want announcements? That's fine too. You can turn them off with:

poll-announcement.enabled: false

Voting

Voting is pretty straightforward.

Open a poll, choose an option, and your vote is saved.

If voting.allow-vote-changes is enabled, players can vote again if they change their mind. Their old vote gets replaced, so voting twice doesn't give them two votes.

If it's disabled, their first vote stays.

Ending Polls

Polls can end automatically when their timer runs out.

Admins can also end them early with:

/poll end <name>

Once a poll ends, the option with the most votes wins.

If two or more options are tied, you can decide what SimplePoll should do with the tie.

The available modes are:

• All tied options win
• Pick one of the tied options randomly
• The option that was added first wins

Commands

Command	Description
/poll	Opens the main poll menu
/poll create	Starts creating a new poll
/poll active	Shows active polls
/poll completed	Shows completed polls
/poll end <name>	Ends an active poll early
/poll cancel <name>	Cancels an active poll
/poll reload	Reloads config.yml

Permissions

Permission	Default	Description
simplepoll.use	true	Lets players use /poll and vote
simplepoll.create	op	Allows players to create polls
simplepoll.end	op	Allows players to end polls
simplepoll.cancel	op	Allows players to cancel polls
simplepoll.reload	op	Allows players to reload the config
simplepoll.admin	op	Gives all SimplePoll permissions

Configuration

SimplePoll is intentionally pretty configurable.

You can change things like:

• Minimum and maximum poll options
• Poll duration
• Whether polls can have no time limit
• How many completed polls are saved
• Whether players can change their votes
• Whether players can see vote counts
• How ties are handled
• Whether new polls are announced
• GUI names and sizes
• GUI item materials
• GUI slots
• Item names and lore
• Sounds
• Plugin messages
• Chat prefixes

Colors use the normal Minecraft format:

&a &c &d

Hex colors are supported too:

&#55FFFF