README

                  .___                 .___
______   ____   __| _/_________  ___ __| _/
\____ \_/ __ \ / __ |\_  __ \  \/  // __ | 
|  |_> >  ___// /_/ | |  | \/>    </ /_/ | 
|   __/ \___  >____ | |__|  /__/\_ \____ | 
|__|        \/     \/             \/    \/ 


----A VPN blocker for BigBrotherBot----- 
-> REQUIRE IPy

1-Introduction
Vpn blocker developed by pedrxd for bigbrotherbot focused on urbanterror
will help you to administrate the servers kicking all players trying 
to access using a vpn or proxy. Most of this users are cheats ragers etc...
If some player need join using a vpn or proxy, you can allow it with a simple command.

2-Installation
You need have installed and configurated bigbrotherbot with a mysql database.
  2.1 Install IPY 'pip install ipy'
  2.2 Merge extplugins folder with the same folder of bigbrotherbot
  2.3 Past conf file to 'explugins/conf/'
  2.4 Add the table inside sql folder to the b3 database
  2.5 Go to the webpage [iphub.info](https://iphub.info/) and get free or paid token, then go to [proxycheck.io](https://proxycheck.io/) and get free or paid token. (You don't need any token for [xdefcon.com](https://www.xdefcon.com/) or [ip-api.com](https://ip-api.com/))
  2.6 On the config file 'vpnblocker.ini' copy your **proxycheck** and **iphub.info** and **zwambrodb** tokens.
  2.7 Add the plugin to the b3.xml with config file: '<plugin name="vpnblocker" config="@b3/extplugins/conf/vpnblocker.ini"/>'
  2.8 Start b3 :D

3-Commands
All comands that include this plugins are listed bellow:
  - allowvpn/av <player/ip>   //Add a player to the whitelist
  - denyvpn/dv  <player/ip>   //Remove a player on whitelist

If you add a ip the nextplayer connected with that ip will be allowed to connect using vpn or proxy.
If you deny a ip only IP's not assinged to a player will be removed


CONTACT: reporturt@gmail.com