Netblocker plugin for B3

This plugin is an ip (range) blocker. Do not mistake this plugin with a firewall, because it does not provide that kind of security. If you need to secure your system you should use a proper firewall.

This plugin can be used to prevent clients from playing on your B3 enabled server. It checks the IP address against your list of blocked IP's when the client is authorized by B3. If the address is prohibited from connecting the client will be kicked consequently. But you can add trusted IP to allowedip on netblocker.ini

The plugin can handle only IPv4 type IP addresses and relies on the game/parser on providing that IP address to the plugin.

This plugin only works with source code versions of the bot, not with the windows installer version due to library issues.

Ranges

The plugin can handle IP addresses or ranges in the following formats:

• single IP address: 127.0.0.1
• IP range: 127.0.0.1-127.0.0.100
• CIDR notation: 192.168.100.0/24
• combination of the above seperated by a comma (,)

Example

netblock: 127.0.0.1, 127.0.0.1-127.0.10.225, 168.0.0.0/8, 127.0/8

whitelist Names

The plugin can handle name in the following formats:

• single name: ZOMBIE
• Multiple names: ZOMBIE, ZWAMBRO, Z@MBIE

Whitelist IP

The plugin can handle allowed IP(s) in the following formats:

• single IP address: 127.0.0.1
• IP range: 127.0.0.1-127.0.0.100
• CIDR notation: 192.168.100.0/24
• combination of the above seperated by a comma (,)

Installation

1. delete the Netblocker plugin from /b3/plugins/

2. copy the contents of the extplugins folder into your installations b3/extplugins folder.

3. add the plugin to your b3.xml config file:

    <plugin name="netblocker" config="@b3/extplugins/conf/netblocker.ini"/>
   

4. modify the netblocker.ini and add your unwanted IP's and ranges, or trusted names or IP to be connected.

5. restart the bot

---

This plugin makes use of the netblock module for python created by 'siebenmann' (https://github.com/siebenmann/python-netblock)