Installation
Game Server
Get5 can run on any official CS:GO Dedicated Server on both Windows and Linux, but setting up a server is outside the scope of this documentation. It is assumed that you have already done this and have a good grasp on how to manage your server.
Online-only
You cannot use Get5 for completely-offline events. Internet access is required on both the server and clients in order for Get5 to perform most of its basic functions, such as locking players based on their Steam ID.
Your server must have a valid Game Server Token and must not
run with sv_lan 1
.
SourceMod & MetaMod
You must have SourceMod installed on your server. Please note that Get5 requires ** SourceMod version 1.10** or higher. SourceMod requires MetaMod, so you must install both plugins. You can get the latest versions here:
Download MetaMod Download SourceMod
OS is important
Remember to select the correct OS type (Windows/Linux/Mac) for both plugins. This should be the OS of the server.
Get5
Latest version
The latest version of Get5 can be found here. Older releases can be found in the Releases section of the repository on GitHub.
Test and development
If you would like to test new features, or be on the "bleeding edge", you can also download any of the releases found at the link above that are marked in the title with Nightly or as Pre-release. Please note that these versions are meant for testers and developers and should not be deployed to production servers unless you have a good reason to do so or can live with the potential consequences.
Info
Get5 itself is OS-agnostic, meaning the same file works on any OS.
SteamWorks (Recommended)
SteamWorks is not required for Get5 to work on your game server, but it is required if you wish to load match configurations remotely, send events to a remote URL, check for updates or upload demos or backups to a web server.
Tip
Similarly to SourceMod and MetaMod, SteamWorks is OS-specific. Remember to select the right version for your server.
Installation
Once you have downloaded the zip file(s), extract it/them into your csgo/
directory in your game server. Once MetaMod,
SourceMod and Get5 (and optionally SteamWorks) have all been installed, the csgo
folder on your server
should look like this. Not all files and folders are included in this example, as it would become way too long, so this
is just to indicate what the correct structure looks like.
Updating Get5 from an earlier version
If you already have Get5 installed and wish to upgrade to a newer version, simply copying the entire get5.zip
folder structure will override your configuration files, so when updating, you should only add get5.smx
(and
optionally get5_mysqlstats.smx
or get5_apistats.smx
) to addons/sourcemod/plugins
and merge the entire
translations
folder with addons/sourcemod/translations
. In updated versions we might add or remove translation
strings, and Get5 will error if it cannot find the strings it expects in these folders. The folder only contains
Get5's translations, so it won't override translations for any other plugins.
Avoid installing the basebans.smx
plugin
The basebans.smx
plugin conflicts with Get5's map selection system, as it also uses
the !ban
command. You should disable this plugin either by moving it to the disabled
folder
or by simply deleting the file from the plugins
folder. You can remove all
the default SourceMod plugins, as they are not required for
Get5 to function. If you do not remove the basebans.smx
plugin, Get5 will unload it automatically.
Server folder structure
addons:
- metamod.vdf
- metamod_x64.vdf
metamod: # (8)
sourcemod:
bin: # (9)
configs:
- admin_groups.cfg
- admin_level.cfg
- core.cfg
- admin_simple.ini # (18)
- ...
get5:
- example_match.cfg # (12)
- example_match.json # (10)
- scrim_template.cfg # (11)
geoip:
sql-init-scripts:
logs: # (1)
plugins: # (17)
- admin-flatfile.smx
- adminhelp.smx
- adminmenu.smx
- antiflood.smx
- basebans.smx # (26)
- basechat.smx
- basecommands.smx
- basecomm.smx
- basetriggers.smx
- basevotes.smx
- clientprefs.smx
- funcommands.smx
- funvotes.smx
- get5.smx # (2)
disabled: # (15)
- admin-sql-prefetch.smx
- admin-sql-threaded.smx
- get5_apistats.smx # (4)
- get5_mysqlstats.smx # (3)
- mapchooser.smx
- nominations.smx
- randomcycle.smx
- rockthevote.smx
- sql-admin-manager.smx
translations: # (5)
- adminhelp.phrases.txt
- adminmenu.phrases.txt
- get5.phrases.txt
- ...
da: # (6)
- adminhelp.phrases.txt
- adminmenu.phrases.txt
- get5.phrases.txt
- ...
data: # (14)
scripting: # (7)
- adminhelp.sp
- adminmenu.sp
- swag.sp # (21)
- get5.sp
- get5_apistats.sp
- get5_mysqlstats.sp
- spcomp
- spcomp64 # (22)
- ...
get5:
- backups.sp
- chatcommands.sp
- ...
include: # (20)
- admin.inc
- get5.inc
- SteamWorks.inc
- ...
extensions: # (13)
- bintools.ext.so
- sdkhooks.ext.2.csgo.so
- SteamWorks.ext.so # (19)
- ...
gamedata: # (16)
cfg:
sourcemod: # (24)
- sm_warmode_off.cfg
- sm_warmode_on.cfg
- sourcemod.cfg
get5: # (23)
- warmup.cfg
- live.cfg
- knife.cfg
bin: # (25)
expressions:
maps:
materials:
models:
panorama:
resource:
scenes:
scripts:
...
- SourceMod error logs can be found in here. This directory is empty by default.
- This is the core Get5 plugin.
- This is the MySQL extension for collecting stats. If you want to use this extension, please see the guide.
- This is proof-of-concept integration called get5 web panel that can be used to manage matches. This is not supported and is probably very buggy. You should not use it.
- This folder contains all the language files and translations for all the plugins.
- Each language has its own folder with translation files. If you remove a language folder, Get5 will simply fall back to English for the missing language.
- This is the source code for the plugins. These cannot be executed by the server, as they must be compiled first, so you cannot simply edit these to change plugin behavior.
- Don't change anything in here. There are no editable files in the
metamod
folder. It's here because SourceMod depends on it. - SourceMod binaries.
- This a JSON-example of a match configuration. You should use this as a template for your own
match configuration. All JSON match configurations must end with
.json
. - The server's default scrim match configuration. This is loaded when using the
get5_scrim
command. - Match configurations can be created in both JSON and
SourceMod's KeyValue format. We recommend JSON for
all new users, but Get5 will continue to support reading
.cfg
files as well. - Various SourceMod extension files.
- The
data
folder is empty by default. - These plugins are disabled. If you want to enable them, you must move them up one folder (to the
plugins
folder). - Various SourceMod game data.
- All plugins enabled on your server should be in this folder and end with
.smx
. SourceMod contains all the plugins listed on here by default. - Allows you to configure admin permissions on your server.
- If you installed SteamWorks, you will have this extension in here.
- Various includes (such as SteamWorks) other plugins depend on for compilation.
swag.sp
is a part of SteamWorks.- The
spcomp
files are used to compile.sp
files. - Contains the phase configuration files for Get5.
- The default SourceMod config file and Warmode (included with SourceMod) configs. You can ignore these files.
- The rest of these folders are already in your
csgo
directory. The
basebans.smx
plugin conflicts with Get5's map selection system and should not be installed. Remove this file or move it to thedisabled
folder.
So far, so good...
If you've made it this far, you should have Get5 available on your server. If you type sm plugins refresh
in your
server console - or if you restart your server - you should see Get5 (and all the other SourceMod defaults) in the
list if you type in sm plugins list
. If this doesn't work, go back and make sure you've followed all the steps to
a tee.
Adding administrators
Server administrators can be set in the admin_simple.ini
file inside addons/sourcemod/configs
. Get5 considers
anyone with the changemap
access level an administrator. For instructions on how to add admins, please see
the SourceMod guide. Administrative privileges are required
to execute admin commands such as the !get5
menu
command, get5_loadmatch
, get5_endmatch
,
get5_loadbackup
and so on.