#### Repository
https://github.com/Rishi556/Votefun

#### Introduction
Votefun is a discord upvote bot similar to that in PAL.NET, and recently in the SteemMonsters discord channel as well but open source and customizable to easily allow anyone to add it to their server and let the members use it. Once the bot is in the server, a member can simply type in the the upvote command, which is a prefix(defined by the administrator of the bot on the server) and upvote, then providing the post link to a post either on busy.org or steemit.com, example : `$upvote https://busy.org/@rishi556/votefun-a-simple-yet-powerful-discord-upvoting-bot`. Our 1.0.0 release happened on September 22,2018 and with that, I wanted to introduce the project out to everyone.

#### Post Body
Votefun was originally designed to be in one discord server only, and give votes to the posts of members of that server only, but upon seeing the potential to help communities grow, Votefun decided to go open source and allow everyone to add a bot of that nature to their server. 

<center><img src="https://ipfs.busy.org/ipfs/QmbguCoC1ghXXwqtVmfahSdzKKfKG6ZZ5FVq8eb5FkWDKk">
<sub>From the <a href="https://discord.gg/8KS5A7x">kiwibot discord server</a>. We can see that the bot left a vote on the post.</sub></center>

<center><img src="https://ipfs.busy.org/ipfs/QmW5dWXaBtF51KqeeudAJJqLebcP3Y4xsAkyNiaiTpLGNF">
<sub>Sometimes the bot doesn't upvote a post because the post doesn't meet the qualifications. This was in the <a href="https://discord.gg/9DWQc8v">cryptowithincin discord server</a>.</sub></center>

Votefun is now designed with customizability in mind. An easy to use config file means that even those without extensive programming knowledge will be able to edit it to their heart's content. A few of the items that the bot owner can customize currently are: 
- the comment left under voted posts
- the prefix used in the discord server
- the ability to whitelist users to give them better rewards, whitelisting is done on a steem username basis
- the name of the role in discord that has the ability to add to and remove from the bot's whitelist
- the minimum and maximum age of a post that will be voted for whitelisted users
- the minimum and maximum age of posts that will be voted for non-whitelisted users
- the minimum voting power of the account in order to cast a vote
- the ability to send bids to @drotto on posts for whitelisted users
- the amount to send to @drotto if sending bids to it is enabled
- the ability to send an extra message to send on the discord server when the vote is successfully cast(or attempted to).
- vote timer(a steem account can only get a vote every 24 hours)
- customizing properties right from discord(functions only a few a few properties)
- vote % for whitelisted and non whitelisted users
<br>

<center><img src="https://ipfs.busy.org/ipfs/QmdrpACTSdD3SC5Udwxk1uJ8gMdrGBwfyBxFN1QFTDqv3s">
<sub>The bot sends bids to @drotto in this format.</sub></center>



##### Roadmap
A project can't be anything without goals, and here our our current goal is to release V2.0 By December 31st 2018. V2.0 will have to goal of:
- Changing to codebase to be more readable for those who want to be able to edit it, while doing this, I'll also be converting steemjs to dsteem
- Refactored out the code  to help with readability and making it easier for those who run the bot on their server to change the settings of the bot without having to mess with the config file on their server or the messy nature of discord
- A simple mobile app, that help bot owners view information about their bot easily and edit anything that they need to. 
- Weekly posting of stats of the bot. This was attempted in the alpha version, but because of errors, it wasn't incorporated on V1.0. 
- More customizable bid to bots. Right now we only have support for @drotto right off the gate, but I hope to make it easier to add more bots to send bids to as well as customizable bid to each bot.
- Better error messages. Error messages just say error right now, better error messages will enable users to know why their post wan't able to get voted.
- Blacklist tag. If a user uses a certain tag on a post, the post won't get voted.
- Required tag. A user must have a certain tag for their post to get voted.
- Don't require users to use a site that follow @user/permlink format. Currently users need to use links that follow the above mentioned format, but with a V2.0, support for more sites(link format) will be enabled.
- Finally blacklisting is also planned to be added onto votefun. We will use blacklists that are already out there like the @buildawhile blacklist and a few others, and our own, as well as a  blacklist just for the bot. This will be done through the global blacklist api created by @themarkymark(his post about it can be found<a href="https://busy.org/@themarkymark/steem-global-blacklist-api-released-for-testing"> here</a>. Bot owners will be able to configure which blacklists they want to enable. Blacklists will supersede whitelists so if a user is blacklisted, even if they are in the bot's whitelist, they won't receive a vote. If you are a bot owner and want to change this around, you will be able to do so by altering the code a bit. 

The bot is already running on a few servers and has worked fantastically there so far.

#### Resources
Kiwibot discord server where you can try the bot out: https://discord.gg/8KS5A7x.
Cryptowithincin discord server where you can try the bot out: https://discord.gg/9DWQc8v.
Version 1.0.0 on github: https://github.com/Rishi556/Votefun/tree/V1.0.0. At the time of writing, its the most stable version.