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!
Hey, i was wondering how to edit /vote
@ebiggz
Yeah, sorry that was a stupid question, i figured it out like 10 minutes after xD, thanks for the awesome plugin though! No other like it!
@MrCleanIsDirty
I'm not sure what you are asking.
You can leave it as is. There's just a possibility that nothing will get picked. Or you can make/change a reward to not have chance settings.
http:pastebin.com/K8skCpcJ like this for example.
@ebiggz
Do i keep there chances in percents though? Or do I write them out as 1/100 like you said
@MrCleanIsDirty
I would remove the chance settings for one of the rewards you want to be as the fall back. Maybe one of the more common ones. Like the "Enchant", "Money", or "Crap Items". You could remove the chance for all 3 even, so after VR does the chance check for the super rare stuff, and if a rare one wasn't picked, it will pick a random one from the 3 without chance :)
@ebiggz
So how would you put my chances in the config to be equal to my current config.
@Barney6262
Hey Barney, sorry I didn't mean to ignore you, things just got lost in the mix. But if you are receiving the reward when you do forcevote, that means everything on VoteRoulettes end is working properly. The forcevote command initiates the same process as a vote coming from a website does. So that means Votifier isn't telling VoteRoulette about the votes. Is everything hooked up properly with your voting sites and Votifier? Votifier has a debug option in it's config that you can to turn on to test if it's properly receiving votes.
Got any ideas for the issue i have ebiggz? i still cannot get it to work :/ if i do /vr forcevote i get a diamond btw, so that part works but members get nothing if they vote, no messages or anything
@MrCleanIsDirty
Thanks!
First thing that should be pointed out is that you have a vote threshold set at every 4 votes, so players will only be getting considered for a reward every 4th vote to begin with. Secondly, you have chance set for every reward, (the highest being 25%). Which means there is a high possibility that no reward will be given at all. The way VoteRoulette calculates chance is per reward, instead of adding up all the reward's chances. It's not expecting you to make all the chances add up to 100%. The general process is, VoteRoulette goes through each reward and gets a number 1 through 100 and checks if that number is equal to or less than the percent you specified. So let's say you made a reward at 10 percent, VR gets a number 1 through 100. Say that number was 34. VR checks if 34 is equal to or less than 10. It's not, so VR continues to the next reward with chance and repeats the process. Once VR checks all the rewards with chance, and if all of them failed, VR will get a random reward from a list of rewards that don't have chance specified (If there are any). So if I were you, I'd make a reward that doesn't have a chance set. That one that will act as a fall back if all your other rewards aren't chosen.
You can test out your rewards by using the /vr forcevote [player] command. That initiates the same processes as a vote coming from a website does.
Hope this helps! :)
[00:21:01] [Server thread/INFO]: ?a?fMr_Mindroan ?bjust voted for ?f?lCleanCraft?b on ?a?lMinestatus ?band was rewarded for it!
That's what I get in console. The player that votes doesn't recieve a message that he did vote and doesn't get an item too. Here's my config here: http://pastebin.com/xkQs71Qz
@MrCleanIsDirty
Could you use pastebin to show me your console when someone votes and also your current config?
@ebiggz
This time I have a genuine problem, whenever someone votes, the message is logged to console, but not to the server or player, and players don't recieve items when they vote.
@ebiggz
Oh crap, sorry was like 4AM and I was completely tired and mixed this page with Votifier's. That's very embarassing xD.
@MrCleanIsDirty
That is a Votifier error. I'd make a ticket with them so they can help you get it resolved. :)
@ebiggz
seemingly no. when i do /vr reload the chat shows 'reload complete' and the console doesn't seem to flag anything: http://pastebin.com/TsJKqPQX
Hey, i'm getting this error and whenever someone votes, it recognizes they votes, it just doesn't work, please help. Error log: http://pastebin.com/VAddn19k
@Barney6262
Are you getting any errors when you type "/vr reload"?
@deleted_13804588
Yep, you can use "/vtr" instead. Visit the command page for more info on the aliases you can use.
Hey, awesome plugin but as another person on here said, Voxel Sniper conflicts with this plugin. Thanks
@ebiggz
The message.yml: http://pastebin.com/KCg8Dhy2 The config: http://pastebin.com/1yTWrWHy
although i have not edited either that much :/