This is the installation guide for the LiteBans web interface.
- An existing website hosted on an existing domain
- A MySQL database (which must allow remote SQL, if used remotely)
- PHP 5.3+ with
pdo_mysqlmodule installed and enabled
- PHP 7+
- MariaDB as database server (not Oracle MySQL)
The web interface cannot be directly hosted on Enjin, see FAQ.
If you're using a web host's database, contact them to find out whether their database accepts remote connections. Most web hosts do not provide this for free plans.
- Download the latest version of the web interface from here.
- Extract the files onto your web server (web server root or public_html).
- The directory "litebans-php-master" will contain all extracted files, rename the folder to "bans".
- Use your browser to open the location on your website where the files were extracted to. If your website is "example.com", visit "example.com/bans/index.php".
- Follow the instructions that are given to you by the web interface.
If you're using XAMPP, find the "htdocs" folder in your XAMPP installation directory (e.g.
C:\xampp\htdocs\) and extract the files there.
XenForo linking guide: Click here
The look of the web interface is based on the Bootstrap theme. You can find Bootstrap 4 themes at https://bootswatch.com/.
From there you can download a
bootstrap.min.css file and replace the existing one located in the installation folder at
Currently the web interface uses Bootstrap 4. Previous versions of litebans-php used Bootstrap 3. These Bootstrap versions are not forward-compatible nor reverse-compatible, so don't use old themes or everything will break.
Custom changes (e.g. background color / background image modifications) can be applied using CSS. (
Existing translations: Spanish, Chinese, Russian, German, Japanese, Dutch, Italian. Click here for a full list of locales.
For translating the web interface, see the README.
If you want to customize the English messages, you can edit lang/en_US.utf8.php.
Please note: This refers to enabling SSL for the MySQL database, not the web interface itself. (HTTPS is already supported as long as your web server provides it)
Note: "When running a PHP version before 7.1.16, or PHP 7.2 before 7.2.4, set MySQL 8 Server's default password plugin to mysql_native_password or else you will see errors similar to The server requested authentication method unknown to the client [caching_sha2_password] even when caching_sha2_password is not used."
To enable SSL, find this section in settings.php:
$options = array( PDO::ATTR_TIMEOUT => 5, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false, PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8", );
Change it to:
$options = array( PDO::ATTR_TIMEOUT => 5, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false, PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8", PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => false, PDO::MYSQL_ATTR_SSL_KEY => '/etc/mysql/client-key.pem', PDO::MYSQL_ATTR_SSL_CERT => '/etc/mysql/client-cert.pem', PDO::MYSQL_ATTR_SSL_CA => '/etc/mysql/cacert.pem', );
Ensure that all of the paths are correct (client key, client certificate, and CA) as they might differ on your system.
Use the paths for the client key/certificate rather than the server key/certificate as these are two separate things.
If you get redirected to the wrong page when trying to access bans (e.g. Multicraft admin panel instead of the web interface):
- Set up different subdomains for each web installation you have, instead of putting everything on the same domain/subdomain.
- Also set up different virtual-hosts for everything that should be installed separately, if needed. Each web package should get its own directory to prevent conflicts.
If you get an error "404 Not Found" / "The requested URL was not found on this server":
- Check that you've extracted it to the correct directory (if the "public_html" folder exists, extract to that folder)
- Check that the directory belongs to the correct user (e.g.
If you are unable to connect to
localhost but are certain that there is a database server running on the local machine:
- Try setting the host to
localhost. This switches the connection method to TCP. (
localhostuses local UNIX socket)
If bans don't show up:
- Try /litebans:ban - if this works and /ban doesn't, then another plugin is overriding the command. See Command Aliases
- Log into the database and see if the tables contain the relevant data.
If skins/avatars are not showing correctly:
- Change the
avatar_sourcein settings.php. Three example sources are indicated above the option.