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!
@mark1102
You can find those in the Votifier's config file. You will need to set the IP to be the same as your servers. I would visit Votifier's troubleshooting page or make a ticket with them if you are still having issues.
@mark1102
I had this problem too. To find the IP and port, go to the votefier config. On websites that list your server, you need your Public Key, which is found in the RSA folder in your votefier plugin folder.
I'm having a bit of a problem. I can't seem to find the Votefier IP or Port If somebody could help me out that would be great!
@ebiggz
You're welcome. Thanks for taking care of this so quickly.
Keep up the good work!
@igwb
Thank you sir!
Great question. You can, however, I see there's a bug where the enchantment improperly registers for books. I've fixed the issue and it will be available in the next update.
Great plugin! Thanks.
Is there any way to add enchanted books as a reward?
@Alphabravo9
I've uploaded an update for VR that includes the beginnings of a localization file, you should see it within the next 24 hours or so.
@simsmode210
That's right. This should work fine, as long as Votifier does, however I have never personally tested it. 1.7 API has changed alot vs 1.6 however not for any of the API I use in VR so simsmode should be good in that respect. Let us know if you get it working, sims!
<<reply 2065278>>
AKA => simsmode210
If you've got votifier installed, and voteroulette installed, there should be no realon why your server being FTB shouldn't work.
I'd suggest going with the versions of the plugins that say that they support 1.6.4 though. However, I doubt the API has changed enough to where having a 1.7 plugin on a 1.6.4 server would be of any trouble. But, always a possibility.
<<reply 2064566>>
AKA => Ebiggz
I would love that!
I have had trouble in the past with understanding everything just from watching someone else do something, mostly because there are so many variables that aren't gone over, simply because what other people are doing, is not exactly what I'm trying to do. Otherwise I'd use that plugin obviously. XD I didn't expect you to be a professional. Heck, if you were, I'd hope very much that you'd be doing it for a career and not still here fiddling with minecraft. But I can take a hint... I would appreciate ANY help you could offer. And thank you. Thank you.
hey guys, will this work on an FTB direwolf20 (1.6.4)server. We have been trying to configure votifier for hours to no avail!
@Italplayer
Sounds like VoteRoulette isn't getting notified by Votifier. You can turn debug mode on in Votifier to see if your votes are properly coming though.
Alright so I've downloaded this plugin it registers, and all. But the problem is that when I vote it doesn't work i was surprised by this because the timer works and all the messages. Any idea of what this might be?
@JustisR
You're very kind! In all honestly though, I've only been diving into the world of programming for just under a year now. I have much to learn before I could consider being even close to professional or teach anything. I too have been relying on tutorials to teach myself. I'll gladly show you the videos I've found most useful. But you need to see tutorials as teaching you concepts that you can apply elsewhere, not just in the example they are using. Once you get that, the only thing that limits you is your imagination of what to create. Then you can apply the concepts you've learned to get the result you want. Let me know if you want some links!
What are the odds... No... Wait...
What are my chances, at being able to be tutored by you, in learning how to professionally code plugins in java?
I have done a few simple ones, but it leaves me so limited when all I can do are simple things that other people show in tutorials. I don't want to have to make copies of other people's work, other people's imaginations. I want to create, build things of my own, never before seen. And I can't do that if I have to watch someone else every time I need to get a job done... I would love it more than anything if I could have a teacher, such as yourself, who can coach me in my struggles to be self sustained.
I've seen your plugin, it's amazing. I love it, I use it for all the servers who's owners ask me to set up votifer. And suggest it to anyone who will listen.
I've seen you, the way you talk to your plugin users, it's wonderful, so open, descriptive, and honest. You talk how I talk in my head. It's impressive.
If there were any stranger I'd prefer to knock info into my head, it be you.
@diannetea
Can you explain what you mean by that? Is it making an error in the console? Is only one reward being given?
Adding a chance to rewards makes the randomization not work properly.
@Alphabravo9 I'll fast track a localizations file where I'll make it so you can change most of the text in VR. I got some time coming up this next week that will allow me to do that.
@ebiggz
Yes, to spanish. I can translate it if you want.
@Alphabravo9
Currently this is not possible. Eventually I'd like to make most text customizable though. Are you looking to change it to a different language?
Any way to customize the welcome message for claiming rewards? I want to setup an alias but dont know how to change the message.
Thanks, never new that :D