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!
@pigsinspace72
No need! "/vr" is just an alias to "/voteroulette", you can also use "/vtr". Visit the commands page for more info on them. :)
Hey ebiggz, Im getting some command interference from voxel sniper. Is it possible to change the /vr command to something else? or at least be able access to the source so I can change it myself?
@buddy16748
You're really close! The only thing we gotta change is the spacing for the xp levels and currency. Currently, VoteRoulette thinks those settings are being applied to the dirt item. The xp and currency needs to be in the same level as the "items" node. Ordering doesn't matter, so I put the xp and currency first so it's easier to see what's going on:
Someone mind helping me?
I want them to get 5 XP Levels, 4 Dirt, 3 Diamonds, $100 In game money per vote? I don't know what I did wrong..
Standard:
items:
234:
amount: 3
3:
amount: 4
xpLevels: 5
currency: 100
@ebiggz
Thanks, and thanks :)
@diannetea
Sorry you are having issues. Thankfully the reason why it's not working is because we just need to make a quick change to how this reward is set up, not the symbols :) Give this a shot:
I'm having a problem with setting up a few of the rewards, I have a mob arena which gives tickets that players can trade for items, and I was going to have this randomly give them out, but the lore on them is very specific so it can be used as a currency item in both Shopkeepers and Boss Shop. Because it is using symbols in the lore this doesn't seem to allow them as rewards.
Actually, I think it might also just be due to the fact that I am not using normal data values for paper. Unfortunately I have to do so, so people can't just use regular paper in the shops. This does not work either:
@TheChiz
That's an interesting idea and sounds cool. I'd have to completely redo how milestones are setup though, as it kind of changes the notion of what a milestone is. I'm not sure how I could pull that off without breaking the way I have it set up now. However, I've been toying with how to implement a new reward type I am calling "Votestreaks". Rewards given out for consecutive days voted. And I think they would replicate close to what you are looking to do.
One thing you could do now, is on the last milestone have it run the command "- vtr stats %player% settotal 0". This would start them over for milestones.
Hey last question!
Is there a way to reset milestones to repeat after the last one? So what I want to do is have maybe like 10 milestones per month (and do the math correctly so like if I want people to get a reward for voting every week it'll be like get 21 votes then 42 votes cause we have 3 voting sites).
But can you reset the milestones to loop back after the very last one. So if I do it correctly, if someone votes every day for a month, then they'll hit the last milestone or repeat. (However if people aren't consistent then it won't be monthly....soo maybe what a better option would be "Reset milestones of everyone after 30 days" and let this be changeable in the config to however many days a player wants, and then maybe add a "Lifelong Milestone" one that stays constant even if you implement the other feature I mentioned.
Just some ideas that I think would be amazing :)
@Dsiddia
Not a problem at all! Have fun. :)
@ebiggz
Oh!, haha. My mistake! Totally forgot to check there! Thank you very much. :)
@Dsiddia
Yup already have! You can use /vtr or the full /voteroulette command. Visit the commands page for more info on all of that :)
Could you maybe add a different command instead of /vr? Maybe a sub command? It conflicts with voxel sniper's replace command. :(
@cheesewiz70
That's a great question. You can use a "dataID" node under the Item ID like this:
However, this has made me realize an error I made with this as currently VoteRoulette only accepts dataID's that are 1 through 16. I've fixed this and uploaded the new build to Bukkit for approval.
If you don't want to wait for that you can grab the new build here. The build also includes an automatic update checker but since the linked version is a snapshot, the update checker will be disabled.Update is out!How would I add something such as spawn eggs to the kit where the id is 383:120?
@TheChiz
You're most welcome!
And yes, I actually added that feature for you in 1.9.2: "/vr remind"
Just wanted to say, thank you very much for adding the things I suggested! (and the credit haha that was cool)
I hope you continue to keep making amazing things, we should talk one on one sometime sir!
EDIT: Oh I was wondering, do you plan to add the ability for an admin to force out a vote reminder broadcast /vtr broadcast or something like that. Thanks!
FU amazing! Thanks a lot!
@huan612shuo
Glad you got it working!
ah! ok I found the problem I have my Galistener in my plugin folder they mixed up lol