This is a Python script that lets you easily run your server from the command line without ever touching server.cfg. I personally use it all the time - it's very convenient if you constantly change server settings, e.g. during testing.
Use pip to install a stable version from the Python Package Index:
sudo pip install samp-server-cli
or only for the current user:
pip install --user samp-server-cli
This will create a shell script in your ~/.local/bin
or /usr/local/bin
directory on Linux and a .exe file in C:\PythonXY\Scripts
on Windows.
Alternatively, you can install samp-server-cli by running the accompanying setup script:
python setup.py install
Finally, you can just download this repository and run samp-server-cli out of the box using one of the wrapper scripts shipped with the source code.
One thing you may need to do after installing samp-server-cli is to set
the SAMP_SERVER_ROOT
environment variable to the absolute path to your
server's root directory (where samp03svr or samp-server.exe sits). This
is only needed if you install samp-server-cli in some non-default location.
By default, server executables are searched in:
- The current working directory
- The directory in which samp-server-cli is located
- The value of the
SAM_SERVER_ROOT
variable
You can also specify the exact command to be run instead using --coomand
,
in which case the script will not attempt to find the server executable.
Running a gamemode with default settings:
samp-server-cli -g grandlarc
Running a publicly accessible server with maxplayers 10 and RCON password "test":
samp-server-cli -g grandlarc -q -R test -M 10
Using filterscripts:
samp-server-cli -g grandlarc -f fsdebug -f gl_actions -f gl_realtime
Using plugins:
samp-server-cli -g grandlarc -d crashdetect -d streamer
Adding non-standard server.cfg options:
samp-server-cli -g grandlarc -d profiler -x some_option its_value
Using existing server.cfg file:
samp-server-cli --no-config
Reading command line arguments from a file:
samp-server-cli @filename
To see the complete list of command line options run samp-server-cli -h
.