RUST Easy Vote v2.0.43

Easy Vote is the most advanced vote plugin available. Everything can be customized without knowing anything about coding.

Please Note updating from v2.0.35 to v2.0.43 you will need to delete your oxide/lang/en/EasyVote.json and oxide/config/EasyVote.json to clear any ligering color codes

Video​

Features​

• Closest reward feature, please see FAQ where i try explain this feature to you all!
• Players receive a reward every time they vote successfully. You can edit the available rewards in the configuration file.
• You can make more reward variables by adding new line in Commands json. Commands are just console commands, so this way EasyVote support every oxidemod plugins which have console commands.
• Add custom reward based how many time player has voted. You can add many as you like custom rewards, there is no limits.
• Supports Rust-Servers.net, Rust-Servers.info and BestServers.com but you can add other voting API sites by editing config file.
• Global Announcement - Alert to every player in server. Who and how many time player has voted.
• And much more!

Reward Variables​

These are called "Commands" in config file!!!Also note that these are just CONSOLE COMMANDS, so you can make more by just add new line! Rename variable name and use it in Rewards.

Note: If you make new "Commands", you have to add same named line in lang/EasyVote.json lang file. You can see existing commands there as well.

• item.name: <amount> -- You get item list from Oxide itemlist
• addgroup: <group>-<time> -- Add a player to a group for a specific time (Request: Timed Permissions)
• grantperm: <permission>-<time> -- Give a player a permission for a specific time (Request: Timed Permissions)
• money: <amount> -- How much gave money per vote (Request: Economics)
• oxidegrantgroup: <group name> -- Add player to group
• oxidegrantperm: <permission name> -- Grant permission to player
• oxiderevokegroup: <permission name> -- Remove player from group
• oxiderevokeperm: <group name> -- Revoke permission to player
• rp: <amount> -- Add points to players profile (Request: ServerRewards)
• zlvl-wc: <amount> -- How much add Woodcutting level per vote (Request: ZLevels)
• zlvl-m: <amount> -- How much add Mining level per vote (Request: ZLevels)
• zlvl-s: <amount> -- How much add Skinning level per vote (Request: ZLevels)
• zlvl-c: <amount> -- How much add Crafting level per vote (Request: ZLevels)
• zlvl-*: <amount> -- How much add ALL level per vote (Request: ZLevels)

Variables​

Use the below replacement variables when you make own commands.

• {playername} -- player's display name
• {playerid} -- player's Steam ID
• {value} -- the reward list
• {value2}** the reward list split with - character; example: addgroup: GroupName-30d`

Permissions​

This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>. To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.

• easyvote.use -- Allows player to use the available chat commands

Chat Commands​

• /vote -- Show vote link(s)
• /claim -- Claim vote reward(s)
• /rewardlist -- Display what reward(s) can get

Configuration​

The settings and options can be configured in the EasyVote file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.

Localization​

The default messages are in the EasyVote file under the lang/en directory. To add support for another language, create a new language folder (e.g. de for German) if not already created, copy the default language file to the new folder and then customize the messages.

For Developers​

API Calls​

Hooks​

FAQ​

How to install EasyVote​

Drag and drop (when server is running or not) EasyVote.cs to plugins folder. Locate you self to config folder. Open EasyVote.json file.

Let me walk throw all lines from top to down...

"Commands": These are the variables what you can use when making rewards. All these are just console commands, what server will run in server console. (Format. "anyName": "console command") (Example. "imcommand": "say hello_in_chat")

"Discord": Config settings for DiscordMessages plugin. It will send embed to your channel when someone vote. Example:

"Rewards": Here you can modify rewards what player will got when they vote your server(s). More about this section right below.

"Servers": Here you add your vote site ID and APIKEY (aka. secret key) "ServerName1" can be changed anything what you liked (like "RustVoided x2" or "RustVoided Vanilla") More information, how to found ID and KEY below.

"Settings": Basic true/false settings for EasyVote.

"VoteSitesAPI": This is the section for more advanced server owners. You don not need to modify anything in this area.

First I recommend to add vote site (servers). Add your server to Rust-Server.net, Rust-Server.info, or BestServers.com, or all.

You can find the id from the last part of the voting site's URL for your server.in Rust-Server.info id is right here <- in this case, is 123In Rust-Servers.net, id is right here <- in this case, is 123In BestServers.com, id is right here <- in this case, is 123

Key is secret key what you should not share any one. Key is hided in vote site dashboard. Login your account and navigate to modify your server, somewhere there should be your apikey, key, secret token, etc.

Note that you can add all your servers in this config and let player vote all your server. It also let players claim reward in any server. Here is example how it could look after you finished to found your ID and KEY.
After that trouble, feel free test that everything is working. Run reload command in server console: oxide.reload EasyVote. If you found out that you do not get any reward after voting server or /vote chat command not showing any server what you just added. Then open logs (oxide/logs/EasyVote) and there you can see what cause the error. If everythings work just fine. Feel free start modify settings, rewards and other how you liked it. Remember take backups :)

What is Closest reward feature?​

Here is an example configuration:
Plugin will always give the last/closest reward based of their votes.

"@" means all the time reward, "first" means once time reward.

[Voted 1th] -> Vote1 reward first & @ reward
[Voted 2th] -> Vote1 reward @ reward
[Voted 3th] -> Vote1 reward @ reward
[Voted 4th] -> Vote1 reward @ reward
[Voted 5th] -> Vote5 reward @ reward
[Voted 6th] -> Vote5 reward @ reward

If "Vote rewards cumulative" is enabled from config. Player will got all past reward(s), like so..

[Voted 1th] -> Vote1 reward first & @ reward
[Voted 2th] -> Vote1 reward @ reward
[Voted 3th] -> Vote1 reward @ reward
[Voted 4th] -> Vote1 reward @ reward
[Voted 5th] -> Vote1 & Vote5 reward @ reward
[Voted 6th] -> Vote1 & Vote5 reward @ reward

How can I make a new command for my rewards?​

All "Commands" are just console commands. Make new line under last line in "Commands". Also remember add , char in above line example
Now you can add "hello" in rewards, like this:
Save all and oxide.reload EasyVote

Changes​

• Color tags updated to Hex Code.
• Removal of Beancan API as votes are no longer approved.
• Inclusion of Pavel Neelers' API for rust-servers.info
• Updated to api requirements for DiscordMessages
• Inclusion of Luz1fers' API For BestServers.com