p install KarlOfDuty/SCPDiscord and restart your server.
Download SCPDiscord, either a release or dev build.
Place the plugin library and dependencies directory in the ~/.config/SCP Secret Laboratory/PluginAPI/plugins/<port> directory:
plugins/
<port>/
dependencies/
Google.Protobuf.dll
Newtonsoft.Json.dll
System.Memory.dll
SCPDiscord.dll
The plugin config is automatically created for you the first time you run the plugin. The path is printed in the server console on startup so you know for sure where it is.
Click here to view default config
Remember to set the bot port to something different from the scpsl server port, or everything will break.
Remember this port as you will need to put it in the bot config too.
Note: Keeping the bot and plugin on different devices is not supported but is possible, you will have to deal with the issues this may result in yourself if you choose to do so. Simply change the bot ip in the plugin config to correspond with the other device.
Set up your bot in the discord control panel according to the guide here.
Download SCPDiscord, either a release or dev build.
There are two versions available, a self-contained version which can run on its own and a smaller version which requires you to install dotnet-8.0 on the system first.
Pick the one you want and extract it somewhere where your user has permission to read and write.
Run the bot using:
# Linux:
./SCPDiscordBot
# Windows
./SCPDiscordBot.exeThis should now have generated the default config in your working directory.
If you want to run several bots you can just enter the config you want to use for each instance as a command parameter:
./SCPDiscordBot --config config1.yml
./SCPDiscordBot --config config2.ymlIf you are unable to run the bot make sure the file has correct permissions.
Click here to view default config
The different options are described in the config. Get Discord IDs by turning on developer mode in Discord and right clicking on a server, role or user.
Restart the bot to apply the changes.
Make sure to restrict who is allowed to use the bot's commands in your Discord server settings:
If your server uses Steam you should turn off the /syncip command and if not you should turn off the /syncid command.
You can set more specific permissions for /server and /ra in the bot config.
If you have several servers it is recommended that you limit command permissions for each bot to the channel they post in. This way your mods will not have to think about which bot they are executing the command on, they will automatically get the correct one from the channel they are typing in. (This does not work for the server owner as they will always have permission to use all commands everywhere)
If you have followed all the steps you should now have a working Discord bot, otherwise contact me in Discord.
SECURITY WARNING:
The bot has no authorization of incoming connections, this means you cannot allow the plugin's port through your firewall or anyone will be able to send fake messages to it.
If you really need to run the SCP:SL server on one system and the bot on another connected over the internet you can try this (if your system uses ufw):
sudo ufw allow from 111.111.111.111 to any port 8888This allows only the IP 111.111.111.111 to connect to the bot on port 8888 as long as your default setting is to deny all (which it is by default).
SECURITY WARNING:
If you ever reveal the bot token to anyone or post it somewhere where it can be read from the internet you need to reset it immediately. It gives others full access to the bot's Discord account so they can use it to do whatever they want with your Discord server, including deleting it.
It is also highly recommended to make sure the bot only has the necessary Discord permissions and no more in order to limit the damage if you accidentally post your bot token somewhere.