A bot that monitors a Farming Simulator 22 Dedicated Server and posts status information in a Discord channel.
It will show information such as the server's status, the number of players online and players who have joined or left the game. It can also purge its own messages to keep the channel tidy.
This bot works with a single Farming Simulator 22 Dedicated Server and will post updates like this as the status changes:
FS22 [BOT] Today at 10:00
:tractor: The server is back online!
:tractor: The server FS22 has been updated: Farming Simulator 22 (1.12.0.0), Map: Elmcreek, DLCs: 2, Mods: 20
:joystick: The server has 1 new mod:
:star2: Anti-AFK 1.0.1.0 by DJ WoodZ (d6f656fdd79f073fd9557d8acf847946)
FS22 [BOT] Today at 10:30
:farmer: 1 of 4 players online: Player 1 (1 January 2023 10:30).
:arrow_right: Player 1 just joined the server.
FS22 [BOT] Today at 10:40
:farmer: 2 of 4 players online: Player 1 and Player 2 (1 January 2023 10:40).
:arrow_right: Player 2 just joined the server.
FS22 [BOT] Today at 12:45
:farmer: 1 of 4 players online: Player 2 (1 January 2023 12:45).
:arrow_left: Player 1 just left the server after playing for 2 hours and 15 minutes.
FS22 [BOT] Today at 12:50
:farmer: 0 of 4 players online (1 January 2023 12:50).
:arrow_left: Player 2 just left the server after playing for 2 hours and 10 minutes.
FS22 [BOT] Today at 13:00
:moneybag: Savegame Money: :arrow_up_small: 123,456 (+1,234).
:watch: Savegame Play Time: 11 days, 22 hours and 33 minutes.
It will also update its current activity (status) to show the Dedicated Server's current status and number of online players:
FS22 [BOT]
Playing online: 2/4
The bot is fully automatic. It does not require or respond to Discord user commands.
It retrieves the status of the server by polling the server's XML feed endpoints (/feed/dedicated-server-savegame.html and /feed/dedicated-server-stats.xml). By default it will poll once per minute.
The only permission this bot requires is the Send Messages permission, which can be found in the Discord Developer Portal under: bot -> Text Permission -> Send Messages
Copy the .env file and create an .env.local file for your environment variables. You will then need to edit the .env.local file.
.env file?It would work but you shouldn't do that. It is good practice to create and edit an .env.local file because it will be excluded from commits by the .gitignore file, whereas the .env file will not be excluded from commits.
As a minimum you will need to specify a FS22_BOT_DISCORD_TOKEN value, which you obtain via the Discord Developer Portal. You will also need to verify that the FS22_BOT_URL_CAREER_SAVEGAME and FS22_BOT_URL_SERVER_STATS values are correct.
By default the bot will post to all channels it has access to on all servers it has been added to.
You should use Discord's roles and permissions to control which channels it can post to, but you can also specify the FS22_BOT_DISCORD_SERVER_NAME and FS22_BOT_DISCORD_CHANNEL_NAME values to further ensure it only posts to your chosen Discord server and/or channel. This is recommended.
Be sure to spell the server and channel names exactly as written in Discord.
By default purging is disabled. When enabled, it will only purge its own messages and it will only purge from the specified channel on the specified server, both of which must be set using FS22_BOT_PURGE_DISCORD_CHANNEL_SERVER_NAME and FS22_BOT_PURGE_DISCORD_CHANNEL_NAME.
Be sure to spell the server and channel names exactly as written in Discord.
If you do not want the bot to purge its old messages, simply leave these values blank.
FS22_BOT_DB_PATH (Default: ./db.json) - The path to the database JSON file (the file will be created if it doesn't exist)FS22_BOT_DISABLE_CERTIFICATE_VERIFICATION (Default: false) - Whether to disable SSL certificate verification (for HTTPS XML URLs)FS22_BOT_DISABLE_UNREACHABLE_FOUND_MESSAGES (Default: false) - Whether to disable "The server is unreachable." and "The server has been found." messages.FS22_BOT_DISCORD_CHANNEL_NAME (Default: blank) - The Discord channel name to post in (leave blank for all channels the bot has access to)FS22_BOT_DISCORD_SERVER_NAME (Default: blank) - The Discord server name to post in (leave blank for all servers the bot has access to)FS22_BOT_DISCORD_TOKEN (Default: YOUR_DISCORD_TOKEN) - Your Discord bot token (from the Discord Developer Portal)FS22_BOT_FETCH_RETRIES (Default: 5) - The number of times to retry failed fetchesFS22_BOT_FETCH_RETRY_DELAY_MS (Default: 2000) - The delay between fetch retries (in milliseconds)FS22_BOT_POLL_INTERVAL_MINUTES (Default: 1) - How frequently to poll the Dedicated Server (in minutes)FS22_BOT_PURGE_DISCORD_CHANNEL_AFTER_DAYS (Default: 7) - How old messages must be before they are deleted (in days)FS22_BOT_PURGE_DISCORD_CHANNEL_AFTER_LINES (Default: blank) - The maximum number of messages to keepFS22_BOT_PURGE_DISCORD_CHANNEL_HOUR (Default: 2) - The hour of the day to perform the purge in UTC (e.g. 2 for 2am (UTC))FS22_BOT_PURGE_DISCORD_CHANNEL_NAME (Default: blank) - The Discord channel name to purge (leave blank to disable purging)FS22_BOT_PURGE_DISCORD_CHANNEL_ON_STARTUP (Default: false) - Attempt a purge when the bot first connectsFS22_BOT_PURGE_DISCORD_CHANNEL_SERVER_NAME (Default: blank) - The Discord server name with the channel to purge (leave blank to disable purging)FS22_BOT_URL_CAREER_SAVEGAME (Default: http://localhost:8080/feed/dedicated-server-savegame.html) - The dedicated-server-savegame.html?file=careerSavegame URL including code, e.g. http://localhost:8080/feed/dedicated-server-savegame.html?code=ABCD1234&file=careerSavegameFS22_BOT_URL_SERVER_STATS (Default: http://localhost:8080/feed/dedicated-server-stats.xml) - The dedicated-server-stats.xml URL including code, e.g. http://localhost:8080/feed/dedicated-server-stats.xml?code=ABCD1234You can either run this project directly on a host machine, or you can run it in a docker container. If you are going to be running it directly, the dependencies will need to be installed.
You need git and Node.js to be installed, then you must clone this repository and install the dependencies:
git clone https://github.com/DJWoodZ/FS22-Discord-Bot.git
cd FS22-Discord-Bot
npm install
cp .env .env.localYou will need edit the .env.local file. See the Environment Variables section for details.
npm start - Run the Discord bot normallynpm run update - Update the local database (useful for getting current state of server without posting status information in Discord)npm run dev - Run the Discord bot in 'development' mode (uses nodemon* to restart automatically on .js code changes)npm run pm2:start - Run the Discord bot as a daemon (uses PM2**)npm run pm2:stop - Stop the Discord bot daemon (uses PM2**)* Install nodemon globally first with npm install nodemon -g
** Install PM2 globally first (see below)
The npm run pm2:start and npm run pm2:stop scripts use a global PM2 NPM dependency.
npm install pm2@latest -gTo ensure the Discord bot service starts automatically following a system reboot:
npm run pm2:start
pm2 startup
pm2 saveSee the PM2 Process Management Quick Start for details.
To run as a service on Windows, you will need to use pm2-installer.
To ensure the Discord bot service starts automatically following a system reboot:
npm run pm2:start
pm2 saveSee the PM2 Process Management Quick Start for details.
This project comes pre-configured ready for use with Docker Compose.
The default Docker Compose configuration (compose.yaml) will use the .env.local file on the host machine.
The FS22_BOT_DB_PATH value in .env.local will be ignored by the Docker Compose configuration. The default Docker Compose configuration will create and use a database JSON file located on the host machine at: .\docker-volumes\db\db.json.
You need git, Docker and Docker Compose to be installed and then you must clone this repository:
git clone https://github.com/DJWoodZ/FS22-Discord-Bot.git
cd FS22-Discord-Bot
cp .env .env.localYou will need edit the .env.local file. See the Environment Variables section for details.
docker compose upTo run as a service, use detached mode:
docker compose up -dIf you need to force Docker Compose to build the image and recreate the container, you can use the --build and --force-recreate options:
docker compose up --build --force-recreateThis can also be used with detached mode:
docker compose up -d --build --force-recreateFor a full list of options see the docker compose up documentation.
For development only.
If you need to interact with the container, you can use this command (assuming the container is named fs22-discord-bot-server-1):
docker exec -it fs22-discord-bot-server-1 /bin/sh