Prerequisites
Before we get started, let’s make sure you meet these following requirements:
Web
A working MySQL/MariaDB database
PHP Version >= 5.6 (and PHP Version < 7.4 for SB++ 1.6.3 release)
GMP extension (for A2S queries)
Game
Sourcemod >= 1.7
Metamod: Source
If you’re using Cloudflare, Rocket Loader must be disabled otherwise SourceBans++ will become unresponsive.
Uploading
Download the latest release from the release page
Upload everything that’s within
web
folder to either the root of your web server or a folder that you wish to allocateUpload everything that’s within
game
to the game mod directory (tf
,cs
,dod
, etc)
Write Permission (Make sure the files is under the web server user)
config.php
file is writable (Linux:sudo chmod 644 config.php
)/demos
folder is writable (Linux:sudo chmod -R 644 demos
)/themes_c
folder is writable (Linux:sudo chmod -R 774 themes_c
)/images/games
folder is writable (Linux:sudo chmod -R 644 /images/games
)/images/maps
folder is writable (Linux:sudo chmod -R 644 /images/maps
)
Web Installation
For demonstration purposes, I am going to be using example.com for the rest of the example, you will need to replace it with your own, and it may vary depending if you placed it
within a directory other than the root directory (Ex: example.com/sb/
)
Navigate to your Sourcebans++ installer (example.com/install
) to begin installation
Read over the license agreement, check
I have read, and accept the license
and clickOk
when you are done readingFill out the information
Server Hostname - Database host, use
localhost
if it’s on the same machine, otherwise use the IP or any resolvable recordsServer Port - Database port, by default it runs on
3306
, you will need to change it if the port is differenceUsername - Database username, the user to sign in with
Password - Database password, the password for the corresponding user
Database - Database to use, you should create a database if have not already
Table Prefix - The prefix you want the SourceBans++ tables to use, useful if there are name collisions, otherwise, leave it at default
Steam API Key - Your Steam API key, which can be obtained here
SourceBans URL - Your SourceBans site with protocol included! (Ex:
https://example.com
), the http:// or https:// is requiredSourceBans EMail - The email address to send password reset and/or ban submissions from, leave empty if you don’t have one to use and don’t plan to use it
System check, look over everything and make sure everything is green before continuing
Table creation, click
Ok
when a success notification pops upFill out the information for your personal account, and hit
Ok
when done (Note: Steam ID is your SteamID2 ID)
Plugin Setup
Navigate to your addons/sourcemod/configs/
directory and edit databases.cfg file
Append and edit the following
"sourcebans"
{
"driver" "default"
"host" "EDITME_DATABASE_HOST_EDITME"
"database" "EDITME_DATABASE_EDITME"
"user" "EDITME_USERNAME_EDITME"
"pass" "EDITME_PASSWORD_EDITME"
"port" "3306" // EDIT IF NEEDED
}
Note: Whilst the webpanel will do its best to generate the above section for you, you should not rely on this being correct. Especially if your webserver (and database server) is on a different host to your game server. Also keep in mind that if your game server has to connect remotely, you may need to allow this with your database configuration. If you have problems here you would usually need to seek help from your webhost, not the SB++ support team.
Save this file and upload the changes as required.
You next need to add the server in the web portal and take note of the ServerID from the SB++ Web Panel. Then navigate to your addons/sourcemod/configs/sourcebans/
directory and edit sourcebans.cfg and update the “ServerID” parameter near the bottom of the file. Refer to the Adding Server docs page for more info.
Final Note
Please take a look at our other docs if you are having difficulty installing