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!
@TheChiz
Currently there isn't a command that resets everyone's but I can look into including that one soon.
Using the %player% variable in a command only works when you have it in a reward/milestone, as VR replaces %player% with the name of the voter.
Lastly, you can access players stats in the players.yml file located in VoteRoulette's data folder.
@applebranch
That's correct, I decided to not support decimals and rather support chance written just as you wrote it: 1/200
Read the change log for 1.9.2 to read a little more about that.
@ebiggz:
I've had a look but haven't seen this answered yet:
Say I want there to be a 1/200 chance of something, the chance value should be 0.5%, but it seems VoteRoulette can't handle decimals as it refuses to give rewards if I set it to this value in config (and it says 0.5 is not a valid chance in the console).
Is there a way of setting chance to being less than 1/100?
@ebiggz
I was wondering. Is there a command we could run from the client or console (and set it up on like crontab) so that it does the resetting of everybody's vote count. So at the end of the month. Boom, everyone starts fresh, if that is currently there could you help me. If not, could it be added :) That would be an easy solution to resetting every ones stuff monthly or whatever.
EDIT: Actually I think your first reply to me gave me exactly what I needed. So I ran it, however it didn't work correctly. Maybe I did something wrong
http://puu.sh/7AGz3.png
You can see I get that but I ran "/vtr stats %player% settotal 0" Thanks for all your support :)
DOUBLE EDIT: Is the total votes stored in any file somewhere for the players? Like if I wanna see a list of everybody's vote total, is that located somewhere? I'd like to show off the top voters each month publicly
@PocK123
VoteRoulette is a tool that allows you to give whatever you want. If you want to give something extra to a different perm group, set up another reward that only they can receive :)
If you want to learn how to set a reward up for that, visit the permission group setup in the advanced reward customization section of the Configuration Guide
@X_angelz_X
Thank you, sir!
Just wanted to point out, this is one of the most amazing, and well thought out designs for a vote listener, keep up the amazing work guys!
@Cluter123
Yep, that's already in the works for the /vr top command
Hey Ebiggz! Could you add a topvoter option? Like if you do /topvoter, it displays the monthly top voters?
@ebiggz
IDK.Something when they vote to get extra items/money
@TheLittleBigBoss
This is something appropriate to create a ticket for. I've made one for you. We will troubleshoot your issue there.
I am having a problem with this on my server. when i edit stuff on the V.R. on my server and reload the plugin or even restart. it won't update. i am stuck with the default ./vote message please help!
@xGumBax
If they are online when they vote, then they will get the reward for the world they are standing in. If they vote while they are offline, there's no way to tell which world they are in. The claiming is apart of the offline voting support.
i need help, i dont want that my users have to claim the rewards, i just want if they vote in another world, that they get rewarded with the specified reward in config, please help
@PocK123
Using permissions per reward/milestone would only work if the player was online. So to be able to support offline players as well, instead you can put a "players" node in the milestone/reward and specify which players are eligible that way.
I'm not sure what you mean by something brand new for VIPs/Donors?
Can you please add permissions for each milestone and something brand new for VIPs/Donors ?
@turtle2k
This is something appropriate for a ticket. I've made one for you. We can work on the issue there.
Hey im having trouble when people vote they dont get there items or the message im running the current votifier and the website recognizes it
@diannetea
This is better suited for a ticket. I've made one with the comment, we'll continue there.
My players are not actually receiving any of the rewards, even when it's a command and they receive the message that the action went through, it doesn't. I have absolutely no idea how this could be happening. No errors, Spigot build 1327, VoteRoulette 1.9.6