84 lines
2.1 KiB
Markdown
84 lines
2.1 KiB
Markdown
# Install
|
|
|
|
1. Build the mod; see `BUILD.md`.
|
|
2. Copy the built folder into the SCUM server Win64 directory:
|
|
|
|
```text
|
|
<ServerInstall>\SCUM\Binaries\Win64\ue4ss\Mods\scum_simple_rcon\
|
|
```
|
|
|
|
Expected layout:
|
|
|
|
```text
|
|
Win64/
|
|
dwmapi.dll
|
|
SCUMServer.exe
|
|
ue4ss/
|
|
UE4SS.dll
|
|
UE4SS-settings.ini
|
|
Mods/
|
|
mods.txt
|
|
scum_simple_rcon/
|
|
enabled.txt
|
|
config.ini
|
|
dlls/
|
|
main.dll
|
|
```
|
|
|
|
3. Edit `config.ini`:
|
|
|
|
```ini
|
|
[rcon]
|
|
bind_address = 127.0.0.1
|
|
port = 27015
|
|
password = use-a-real-password
|
|
```
|
|
|
|
4. Enable the mod in `ue4ss/Mods/mods.txt`:
|
|
|
|
```text
|
|
scum_simple_rcon : 1
|
|
```
|
|
|
|
5. Start the server and check `ue4ss/UE4SS.log` for:
|
|
|
|
```text
|
|
[scum_simple_rcon] rcon: listening on 127.0.0.1:27015
|
|
```
|
|
|
|
6. Test locally:
|
|
|
|
```bat
|
|
mcrcon -H 127.0.0.1 -P 27015 -p use-a-real-password rcon.status
|
|
mcrcon -H 127.0.0.1 -P 27015 -p use-a-real-password rcon.admins
|
|
mcrcon -H 127.0.0.1 -P 27015 -p use-a-real-password rcon.dispatch
|
|
mcrcon -H 127.0.0.1 -P 27015 -p use-a-real-password rcon.chat
|
|
```
|
|
|
|
Security note: keep `bind_address = 127.0.0.1` unless you are putting this behind a firewall/VPN. Source RCON is not encrypted.
|
|
|
|
Before sending an `AdminCommand` (for example `SetTime`, `SpawnItem`, or an
|
|
admin-targeted `SendNotification`), make sure the server has:
|
|
|
|
```text
|
|
<ServerInstall>\SCUM\Saved\Config\WindowsServer\AdminUsers.ini
|
|
```
|
|
|
|
with at least one 17-digit SteamID64. This mod intentionally does not fall back to the first online player.
|
|
|
|
Ordinary `SendChat` is different: it only needs an authenticated RCON client
|
|
and a real online recipient. It does not need `AdminUsers.ini`, does not create
|
|
a controller/channel, and refuses a targeted send when that SteamID is not
|
|
currently connected.
|
|
|
|
For the no-player test, wait until the SCUM world has loaded, leave the server
|
|
empty, then run `rcon.dispatch` followed by a harmless command such as:
|
|
|
|
```bat
|
|
mcrcon -H 127.0.0.1 -P 27015 -p use-a-real-password SetTime 12
|
|
```
|
|
|
|
`rcon.dispatch` must report `synthetic=ready`. If the native executor signature
|
|
is not found, do not force an address: the SCUM build changed and the mod needs
|
|
an updated, tested signature.
|