Docs / Votes and rewards
The CraftRank plugin
CraftRankVotes is our free plugin for Paper, Spigot, Purpur and Pufferfish 1.13 and newer. It asks CraftRank for new votes every 30 seconds, so there are no ports to open and no Votifier keys to copy. It runs your reward commands, adds a /vote command and reminds players who have not voted today.
Install
- Download CraftRankVotes.jar and put it in your server's
pluginsfolder. On a network, install it on the lobby or any backend server. - Restart the server. The file
plugins/CraftRankVotes/config.ymlis created. - In your dashboard, open Plugin & API for your server, press Create API key and copy it.
- Paste it as
api-keyin the config, write your rewards and run/craftrank reload.
The Plugin & API page then shows Connected with the plugin version.
Rewards in config.yml
api-key: "PASTE-YOUR-API-KEY-HERE"
rewards:
commands:
- "give {player} diamond 1"
give-offline: false
broadcast: "&6{player} &evoted and got a reward! &7Type &f/vote"
thanks: "&aThanks for voting! Here is your reward."
reminders:
on-join: true
every-minutes: 30
commandsrun from the console for every vote.{player}is the player's name.give-offline: falsekeeps the reward until the player joins.truegives it right away.- Leave
broadcastor a message empty ("") to turn it off. Color codes with&work.
Commands
/vote(or/votes): a clickable vote link, and when the player can vote again./craftrank: shows whether the plugin is connected./craftrank reloadreloads the config./craftrank test <player>gives a test reward./craftrank spawn [radius]: copies the blocks around you so visitors can walk around your spawn in 3D on your server page./passportand/quests: for players, see below.
The admin commands need the craftrank.admin permission (operators have it).
More features
- PlaceholderAPI (1.3+):
%craftrank_rank%,%craftrank_votes%,%craftrank_player_streak%,%craftrank_player_next_vote%,%craftrank_top_name_1%and more. The full list is on the Plugin & API page and in the config. - Play tracking (1.4+,
play-tracking): sends who is online every 5 minutes, names and play time only, no IPs or chat. This powers player passports, weekly quests and the most loyal servers ranking. - Community vote goals (1.6+): a boss bar and automatic rewards. See Vote goals.
- Store delivery (1.7.0+): runs the commands for what players buy in your CraftRank Sites store. See store delivery.
- Pro rewards: streak, milestone and top-voter rewards for servers with Pro.
Good to know
- When the plugin connects for the first time, older votes count as delivered, so nobody gets rewarded twice.
- Votes from the last 7 days that were not delivered yet, for example while your server was down, are picked up when it is back.
- If you also use Votifier with a reward plugin, players get two rewards. Already using other vote plugins? Read using CraftRank Votes with other vote plugins.