(3.0.0 - 3.25.6) 2.0.2 (3.0.0 - 3.25.6) 2.0.1 (3.0.0 - 3.25.6) 2.0.0 (3.0.0 - 3.25.6) 1.7 (3.0.0 - 3.25.6) 1.6 (3.2.0 - 3.25.6) 1.5.0 (3.2.0 - 3.25.6) 1.4.0 (3.2.0 - 3.25.6) 1.3.0 (3.2.0 - 3.25.6) 1.0.2 (3.2.0 - 3.25.6) 1.0.1 (3.2.0 - 3.25.6) 1.0.0
BetterVoting is a PocketMine-MP plugin for letting players claim their rewards from voting for your server.
BetterVoting uses your server's api key which means you don't need to download any VRC files. BetterVoting is also an active project which means any issues can be resolved as quickly as possible.
When you first install BetterVoting, you will get a default config that looks like this:
# API Key from https://minecraftpocket-servers.com
api-key: ""
claim:
# Message Variables:
# {real-name} - The voter's full username
# {display-name} - The voter's display name
# & - Change message color
# {x} - Voter's X coordinate
# {floor-x} - Voter's X coordinate rounded
# {y} - Voter's Y coordinate
# {floor-y} - Voter's Y coordinate rounded
# {z} - Voter's Z coordinate
# {floor-z} - Voter's Z coordinate rounded
broadcast: "{real-name} has voted for free rewards!" # Message to be broadcast when a player votes
message: "Thanks for voting for our server" # Message to send to the player who voted
items:
# Items to be given to the player when they vote
# Item format: "ItemName:Damage:ICount:CustomName:EnchantName:EnchantLevel"
# Item IDs are not supported, use the item names instead
# Replace spaces with "_" for item names
# For no custom name/default item name, put "default"
# First 4 fields are required, enchants are optional
# You can have unlimited enchants, just follow the format "EnchantName:EnchantLevel:EnchantName:EnchantLevel" etc
# There is also support for PiggyCustomEnchants, use same format as normal enchants
- "diamond_sword:0:1:Vote Sword:sharpness:5:unbreaking:3"
- "diamond_pickaxe:0:1:default:efficiency:2:driller:3"
commands:
# Commands to be executed by console when a player votes
# Do not include "/" at the start of the command
- "title {real-name} title &aVote"
- "title {real-name} subtitle &7Thanks for voting!"
top-votes:
title: "&aTop Votes This Month" # Message sent before displaying top votes
display: 10 # Amount of top votes to dispay, can't be bigger than 500
format: "&6{number}. &b{username}: &e{votes}" # Format of displaying top voters
The first thing you can see in the config is api-key
. This is what BetterVoting uses to connect to the vote website and claim players' votes.
To get your API key, go to Manage Your Servers on minecraftpocket-servers and paste in your API key.
Notice: As of now, BetterVoting only supports minecraftpocket-servers, and 1 server. Multi website support is a planned feature
Next in the config you will see claim information. The broadcast
key, this is the message that get's broadcasted to the server when a player votes
The message
key is the message sent to the player after they vote
Variable | Description |
---|---|
{real-name} | The voter's full username |
{display-name} | The voter's display name |
& | Change message color |
{x} | Voter's X coordinate |
{floor-x} | Voter's X coordinate rounded |
{y} | Voter's Y coordinate |
{floor-y} | Voter's Y coordinate rounded |
{z} | Voter's Z coordinate |
{floor-z} | Voter's Z coordinate rounded |
The items
array is the items the player will be given for voting. If you follow the guidelines you shouldn't have any problems.
Notice: Issues regarding items not working will be closed, as it works fine if you follow the guidelines
The commands
array is the commands to be executed by console when a player votes. Don't include the /
in commands.
You can use the message variables in commands aswell
The top-votes
array is the information used for /vote top
. title
is the message sent to the player before sending the top voters.
display
is the number of voters to send to the player. format
is the message sent to the player for every top voter.