VoteRoulette
Randomized rewards for voting
Home | Permissions | Commands | Config Guide | Files | Change Log | Dev
VoteRoulette is a comprehensive, customizable, and fun Votifier vote listener. VoteRoulette allows you to make a list of rewards and players will receive one at random when they vote for your server on Minecraft server lists. This makes voting exciting and different each time a player votes and will encourage them to vote again to see what they will get next time!
Features
- Extremely flexible! VoteRoulette doesn't just give anything, it does anything.
- Easy to setup! Includes an in-game Award Creator. Avoid those pesky YAML syntax errors!
- Highly customizable rewards!
- Rewards can contain any combination of items, currency, commands, and xp levels.
- Items in rewards support enchants, custom names, lore descriptions, variable amounts, and Data ID's (For things like colored wool, or any other block/item in the game).
- Rewards have tons of other options too! Set things such as permission groups (Vault required), chance modifiers, delays for commands, eligible websites, eligible players, number of consecutive days of voting required, and so much more! (See the Config Guide.
- Ability to set a vote threshold. Players won't receive a reward till they have met the threshold. This is useful when you have your server posted on multiple server lists and you want players to vote on them all before they get rewarded.
- Special rewards called "Milestones" that are awarded to players when they have reached a set amount of votes. This gives players a goal and even more incentive to vote.
- Ability to make Milestones recurring. Make a Milestone set to every 50 votes or a single epic Milestone at 300 votes!
- Offline voting support! If a player votes for the server but isn't in game to receive rewards, the rewards will be there waiting for them to claim the next time they log on.
- Option to have awards auto-claimed when a player logs in!
- Inventory Protection. If a reward won't fit in a players inventory, VoteRoulette will notify the player and let them reclaim once they have cleared space.
- You can disable Inventory Protection, too. Items will instead fall at the feet of the player if their inventory is full.
- Visual Representations of Rewards/Milestones!
- Players can easily see the contents of Rewards/Milestones in a mock inventory screen.
- Editable Broadcast Messages! (Supports color codes)
- Set a custom message for a specific Reward/Milestone that will override the default message.
- A /vote command. Lists all your voting sites to the player.
- Ability to make Fancy Links™ which allow you to hide those long ugly links behind clickable text.
- Reminders!
- A periodic reminder for all players to vote!
- An automatic reminder after 24 hours have passed since a player's last vote!
- Extensive Multi-World support!
- Set specific worlds per Reward/Milestone.
- Globally blacklist worlds!
- Stats Tracking!
- See the top all time voters using the Scoreboard.
- MySQL support!
- UUID support!
- VoteRoulette uses Mojang's account system API (https://api.mojang.com/profiles/minecraft) in order to ask for the UUID of a given player name. You can turn off this functionality in the config by setting useUUIDs to false. (as of v2.2.2).
- A player blacklist. Prevent certain players from getting rewards.
- Option to switch blacklist to a whilelist. Only players in list can receive rewards!
- Option to switch blacklist to a whilelist. Only players in list can receive rewards!
- Option to turn randomization off! Just want to have a single reward and skip the randomization processes? No problem! VoteRoulette can be as simple or complex as you want it to be.
- Localization Options! Files are available to edit a lot of text in VoteRoulette!
- Check out and share translations in the forum!
- Automatic update checking! Always be notified of the latest version! You can disable this in the config by setting checkForUpdates to false.
- Update Safe! VoteRoulette doesn't use any native Minecraft code and therefore won't break with future versions of Bukkit. (Given there isn't major API changes)
- Metrics tracking! Help us see how VoteRoulette is used. (as of 2.0.1)
- Using Hidendra's plugin metrics system, the following information is collected and sent to mcstats.org: A unique identifier, the server's version of Java, whether the server is in offline or online mode, VoteRoulette's version, server's version, OS version/name and architecture, core count for the CPU, number of players online, Metrics version
- If you do no want these stats collected, you can turn them off at /plugins/PluginMetrics/config.yml by setting opt-out to true.
Requirements
You must have Votifier installed.
If you want to have rewards that give currency or rewards that only apply to certain permission groups, you must also have Vault installed.
Getting Started
- Make sure Votifier is at least on your server. If you plan to use the currency and permission group options, make sure Vault is installed as well. Are you using BungeeCord? Check out this post!
- Place VoteRoulette in your server's plugins folder. Do NOT place it in Votifier's "listeners" folder.
- Start your server to let VoteRoulette generate the default files. A copy of the config can also be found here.
- Edit settings and add awards. Visit the Config Guide for help or the Award Setups forum for ideas.
- Type "/vr reload" in your console to put the changes into effect!
Still stuck? Ask for help on the VoteRoulette forum!
Planned Additions
- Timed Milestones; Weekly, monthly, daily
- Set a votestreak with a range of days
- Custom fireworks support for item prizes
- Out-of-game Award Creator GUI?
Visit VoteRoulette's Trello page to see what I am currently working on!
I welcome your feedback! Drop me a comment telling me what you think. If you have any suggestions or ideas, please feel free to submit a ticket with a feature request.
If you have found a bug, issue, or error, please submit a ticket rather than leaving a comment! Players who post errors or file contents straight into a comment will be ignored and comments may be deleted.
Like this plugin? Contribute to the pizza and drinks fund. I deeply appreciate your support!
If you are on 1.9.4, you can use color codes and make custom lines now:
http://pastebin.com/Bk7UpJRa here
@huan612shuo
Can you use pastebin to paste a copy of your messages.yml? Also are you getting any errors when you start your server or type /vr reload?
Help! When I type /vote it shows up 'Vote for us everyday for ingame rewards and more!' before it shows up the links but now it doesnt pls reply this asap!
@trancedkuja
Yup, that'll do it! Have fun :)
@ebiggz
Thanks a ton, I just didn't do a 4 space indent, that's why it wasn't working previously!
@trancedkuja
Great question. Here's an example of how to set up some rewards with currency:
Just keep in mind that you must have Vault installed for the currency features to work. If you want to learn what else you can do with rewards, the example reward in the default config gives good direction. :)
Hello,
I am interested in using the plugin for my server, however I do not know how to set up currency rewards.
Basically I would like my players to be rewarded 1 token (currency) per vote. How can I do this? Thanks.
@TheChiz
I didn't out right include this because I support the "&" color codes, since links have the possibility of containing "&" symbols and numbers, it would break those, and I didn't want to create a whole other form of color tags just for the vote command. It felt unintuitive and clunky. But I'll see what I can do.Edit: I've added global support for %color% tags in the messages.yml file. I've submitted the update to Bukkit, you should see it soon.
@blockzdajap
Yes there is! Use a "dataID" node for the item. so for example:
Hi
How do u add items that have 397:1 the colon and then number? Items like these i cant because of the ":1" Is there a way?
Hey ebiggz!
Would there be any possibility of adding color codes and formatting/messages for the /vote command, GAListener allows you to full customize this with multiple lines (their default config will show you that) and I was hoping you could do that or do you have any plans for it in the near future?
Thank you!
@HaakonHawk
You're most welcome!
@ebiggz
Thank you!
Everything works now! :D
@HaakonHawk
As for the messages file, the last section with the voting websites must be in a list format and does not support color codes. Replace it with this:
edit: I've added warnings about list format and color codes for the websites section to the default messages.yml, as I can see it was misleading. I apologize for that.
As for the the chat message in-game, VoteRoulette does not say ever say that. One possible cause is since "/vr" is set as an alias to "/voteroulette", if you have another plugin that might have registered "/vr" as a command or another alias, it may also be trying to do something too. Try using the full "/voteroulette" and see what happens. I've also set "/vtr" as another alias that you could use as well.
@ebiggz
Here's the whole message file: http://pastebin.com/Q7FP7N3h
Edit: Also, when using the command ingame i get: "You have entered an invalid Item ID" error in chat. And there's no errors in the console!
@HaakonHawk Are you getting any errors in the console when you type /vr reload? Could you possibly post a pastie of your messages.yml file so I can try to reproduce the issue? The messages file is working just fine for me on my end.
Of some reason... The message file won't take effect.
I reload the config by using /vr reload and i've also tried restarting the server. But the file won't take effect at all... The normal config file works fine though! The only problem with the message error is that the /vote command is useless! :|
Please reply if you know how to fix this!
@matagin
Those aren't errors, just warnings.
Priority only really applies if you have milestones that could potentially happen at the same time. Say you make a milestone "A" at 10 votes and you set it to be recurring (So it happens every 10 votes. 10, 20, 30, etc). And then you set another milestone "B" at 50 votes that doesn't recur. When a player reaches 50 total votes, they qualify for both milestones "A" and "B". Priority is a way of telling VoteRoulette which milestone you want given to the player. (You could also tell VoteRoulette to give a random milestone in this case, which ignores priority).
Priority can be any number, but 1 is considered highest priority, think "first priority", and the default priority given to milestones if you don't specify is 10, which is what those messages are telling you.
So if you wanted the milestone "B" to always be given at 50 votes, then you want to make sure its a higher priority than milestone "A" that is recurring every 10 votes. Assuming milestone "A" is at the default priority 10, then you could set milestone "B" to priority 9 (or any number before 10) and it would always come before milestone "A".
It starts getting tricky when you have lots of milestones that are recurring and overlapping each other. Priority is just a way to manage that :)
If none of your milestones overlap each other and/or everything is working for fine for you, then you don't need to worry about those warnings.
Lastly, if you want those warnings to go away, you can put in the "priority: " node for your milestones, that way VR isn't saying "Hey I'm setting the milestones priority to 10 since you didn't specify one" every time.
I have milestones where players get different rewards after they vote a certain amount of times. I keep getting these priority errors.
Line 204: [09:49:53] [Server thread/WARN]: [VoteRoulette] No priority format for milestone: 5 Votes found, Setting priorty to default of 10... Line 206: [09:49:53] [Server thread/WARN]: [VoteRoulette] No priority format for milestone: 15 Votes found, Setting priorty to default of 10... Line 208: [09:49:53] [Server thread/WARN]: [VoteRoulette] No priority format for milestone: 25 Votes found, Setting priorty to default of 10... Line 210: [09:49:53] [Server thread/WARN]: [VoteRoulette] No priority format for milestone: 35 Votes found, Setting priorty to default of 10... Line 212: [09:49:53] [Server thread/WARN]: [VoteRoulette] No priority format for milestone: 50 Votes found, Setting priorty to default of 10... Line 214: [09:49:53] [Server thread/WARN]: [VoteRoulette] No priority format for milestone: 75 Votes found, Setting priorty to default of 10... Line 216: [09:49:53] [Server thread/WARN]: [VoteRoulette] No priority format for milestone: 100 Votes found, Setting priorty to default of 10... Line 218: [09:49:53] [Server thread/WARN]: [VoteRoulette] No priority format for milestone: 115 Votes found, Setting priorty to default of 10...
The same type of error shows when a player votes and reaches a milestone. Is it required to set a priority for each one? Would the reward for 115 votes be priority 1? and then I work my way down?