SourceMod Addon Manager 2 (SMAM2)
SMAM2 is a package manager built specifically for SourceMod.
This was heavily inspired by Phil25's SMAM. I thought the idea was great so I went ahead and rewrote it, improving on a few features and giving it some new features entirely.
There is currently not yet a "database" of plugins/extensions. For now, every addon is listed in the GitHub repo in a .json file. If you want to add your project/plugin/extension, just file a pull request.
Features
Multiple Server Management
SMAM2 can support managing multiple servers. This is useful for scalable server hosts with multiple servers on a single machine. Addons can be installed to each server all at once, or servers can be explicitly selected for individual installations.
Example:
[[email protected] ~]$ smam add /home/tf2/tf -ntf2
Successfully created server 1 (tf2) with path "/home/tf2/tf".
[[email protected] ~]$ smam add /home/csgo/csgo
Successfully created server 2 () with path "/home/csgo/csgo".
[[email protected] ~]$ smam add /home/l4d/l4d2 -nl4d
Successfully created server 2 (l4d) with path "/home/l4d/l4d2".
[[email protected] ~]$ smam install sourcemod1-11 metamod1-12
Successfully installed addon sourcemod1-11 to server 1 (tf2).
Successfully installed addon sourcemod1-11 to server 2 ().
Successfully installed addon sourcemod1-11 to server 3 (l4d).
Successfully installed addon metamod1-12 to server 1 (tf2).
Successfully installed addon metamod1-12 to server 2 ().
Successfully installed addon metamod1-12 to server 3 (l4d).
[[email protected] ~]$ smam install tf2items -stf2
Successfully installed addon tf2items to server 1 (tf2).
[[email protected] ~]$ smam install steamworks -s2,3
Successfully installed addon steamworks to server 2 ().
Successfully installed addon steamworks to server 3 (l4d).
[[email protected] ~]$ smam install dhooks -s1-2
Successfully installed addon dhooks to server 1 (tf2).
Successfully installed addon dhooks to server 2 ().
[[email protected] ~]$ smam remove steamworks -sl4d
Successfully removed addon steamworks from server 3 (l4d).
Scaled Server Deployment
SMAM2 can install several addons at once, including SourceMod and MetaMod. With a little elbow grease, you can create a script to automatically create and deploy a server with its own specified plugins.
Plugins also can have registered dependencies. VSH2 requires TF2Items, so it is automatically added to the installation queue.
pluginlist.txt
metamod1-12
sourcemod1-11
vsh2
install.sh
./build.sh
smam add /home/tf2hale/tf2hale/tf -n tf2hale
smam install -F pluginlist.txt
Configuration
Setting up addons in the main database is easily configurable. Each subkey in the .json file can differentiate between Windows, Linux, and Mac (Darwin) configurations.
Config can exclude files, prepend to file paths to configure installation directories, and include required and optionally required dependencies.
Each server installation data is set up in the user's home data directory, ~/.local/share/smam/ for Unix and C:\Users\
for Windows.
Installation
SMAM2 is OS independent and uses pip to install.
SMAM2 also requires the appdirs package i.e. pip3 install appdirs.
Windows
After running steamcmd to install server files...
C:\Users\johnm> git clone https://github.com/Scags/SMAM2.git
C:\Users\johnm> cd SMAM2
C:\Users\johnm\SMAM2> pip install . # OR you can execute 'py setup.py install'
C:\Users\johnm\SMAM2> smam add C:\path\to\game\dir -n my_server_name # This is the game directory that holds the 'addons' folder (e.g. tf/csgo/l4d2/css)
You're done. You should be able to setup and configure your server(s) from here on.
Unix
After running steamcmd to install server files...
[[email protected] ~]$ git clone https://github.com/Scags/SMAM2.git
[[email protected] ~]$ cd SMAM2
You have 2 options from here.
If you run a single server or you have a single user running multiple servers, you would use:
[[email protected] ~/SMAM2]$ pip3 install .
You may also need to add the local bin dir to PATH. This installs SMAM so that you won't need to escalate to manage a server, but if you are running servers under different users, SMAM will be confused if you try to run it under a different user than the one you installed with.
Otherwise, if you are running multiple servers on the same machine under different users, you may want to install to the /usr/bin directory as sudo. This would mean using:
[[email protected] ~/SMAM2]$ sudo python3 setup.py install
From then on, you would have to run smam as root, but you would be able to harness SMAM's ability configure multiple servers at once.
Commands
Adding a server:
[[email protected] ~]$ smam add -h
usage: smam add [-h] [-n NAME]
add a server to SMAM
optional arguments:
-h, --help show this help message and exit
-n NAME, --name NAME name of the server being added
[[email protected] ~]$ smam add path/to/serverdir
Dropping a server:
This does not remove any files
[[email protected] ~]$ smam drop -h
usage: smam drop [-h]
drop server(s) from SMAM
optional arguments:
-h, --help show this help message and exit
[[email protected] ~]$ smam drop 1
[[email protected] ~]$ smam drop tf2hale
[[email protected] ~]$ smam drop all
Installing an addon:
[[email protected] ~]$ smam install -h
usage: smam [-h] [-s SERVERS] [-n] [-u] [-f] [-o] [-F FILE]
install a plugin/extension
optional arguments:
-h, --help show this help message and exit
-s SERVERS, --servers SERVERS
server(s) to install to
-n, --noconfig ignore config files from installation
-u, --upgrade update addon to the latest version
-f, --force force installation regardless of preexisting files
-o, --optional install addon's optional packages
-F FILE, --file FILE read addons from a file
[[email protected] ~]$ smam install tf2items
[[email protected] ~]$ smam install -s 1 steamworks
[[email protected] ~]$ smam install vsh2 -o
[[email protected] ~]$ smam install sourcemod1-11 -nf -s 1-4
[[email protected] ~]$ smam install -Fmyplugins.txt 1,4
Removing an addon:
[[email protected] ~]$ smam remove -h
usage: smam [-h] [-s SERVERS] [-k]
remove a plugin/extension
optional arguments:
-h, --help show this help message and exit
-s SERVERS, --servers SERVERS
server(s) to remove from
-k, --keep do not remove addon files
[[email protected] ~]$ smam remove left4downtown -k
[[email protected] ~]$ smam remove steamtools steamworks
[[email protected] ~]$ smam remove all
List servers and their addons:
[[email protected] ~]$ smam list -h
usage: smam [-h] [-a]
list server(s) and their addons
optional arguments:
-h, --help show this help message and exit
-a, --all list content paths
[[email protected] ~]$ smam list -a
Search for an addon:
[[email protected] ~]$ smam search -h
usage: smam [-h]
search for an addon
optional arguments:
-h, --help show this help message and exit
[[email protected] ~]$ smam search tf2
[[email protected] ~]$ smam search sourcemod
List info for an addon:
[[email protected] ~]$ smam info -h
usage: smam [-h]
list information for an addon
optional arguments:
-h, --help show this help message and exit
[[email protected] ~]$ smam info tf2items
TODO
- Allow complete server deletion.
- Allow local addon database configurations
- Improve argparse's command structure
9 Jul 8, 2021
25 Aug 28, 2022
18 Nov 24, 2021
36 Oct 30, 2022
84 Jun 4, 2022
8 Oct 6, 2022
4 Oct 21, 2022
17 Oct 21, 2022
2 Nov 4, 2021
45 Dec 01, 2022
254 Jan 05, 2023
1 Nov 24, 2021
147 Dec 15, 2022
319 Aug 15, 2022
2 May 12, 2022
52 Nov 20, 2022
1 Nov 28, 2021
1 Jan 21, 2022
173 Nov 10, 2022
6 Oct 07, 2022
33 Jan 03, 2023
84 Dec 26, 2022
0 Dec 08, 2021
39 Jan 01, 2023
2 Jan 18, 2022
45 Dec 12, 2022
2 Feb 10, 2022
45 Dec 26, 2022
258 Jan 06, 2023