cloudmaker97 / FS25-Discord-Bot

A simple discord bot for the LS25 / FS25 / Farming Simulator 25 (with docker support) for server status updates in discord embeds. 🚜
https://dennis-heinri.ch/
MIT License
5 stars 1 forks source link
discord discord-bot docker farming-simulator farming-simulator-25 fs25 ls25

Farming Simulator 25 - Discord Bot

This bot periodically updates a Discord channel with stats from a Farming Simulator 25 server. It posts the server name, password, time, and player count. Written in Node.js, it uses the discord.js library to interact with Discord and fetches server stats via the XML feed (accessible through the server's web interface). The update interval is configurable.

Screenshots

Discord embed in english ![discord_en.png](misc%2Fimages%2Fdiscord_en.png)
Discord embed in german ![discord_de.png](misc%2Fimages%2Fdiscord_de.png)
Terminal output (NodeJS) ![bot_terminal.png](misc%2Fimages%2Fbot_terminal.png)

Requirements


Installation Guide

Step 1: Create a Discord Bot

  1. Open the Discord Developer Portal.
  2. Click on New Application and give your application a name.
  3. Navigate to the Bot section in the left menu and click on Add Bot.
  4. Copy the bot token by clicking Copy (you'll need this later).
  5. Go to the OAuth2 > URL Generator section in the left menu.
  6. Under "Scopes," select bot, and under "Bot Permissions," select Administrator.
  7. Copy the generated URL to invite the bot to your Discord server.
    • The URL should look like this: https://discord.com/oauth2/authorize?client_id=CLIENT_ID&scope=bot&permissions=8

Step 2: Configure the Bot

  1. Clone the repository to your server
  2. Locate the configuration files:
    • Use either
      • config.example-de.json (for German)
      • config.example-en.json (for English)
    • Rename the chosen file to config.json.
  3. Open config.json and fill in the required fields:
    • Refer to SETTINGS.md for detailed descriptions of each field.
    • Fields marked with (*) are important to check; other fields can be left empty for default values.

Running the Bot

Option 1: Run Inside a Docker Container (Recommended)

  1. Navigate to the root directory of the cloned repository.
  2. Build and start the container:
    docker-compose up -d --build
  3. The bot should now be running and posting server stats to the specified Discord channel.

Option 2: Run Without Docker (Using Node.js)

  1. Navigate to the root directory of the cloned repository.
  2. Install dependencies:
    npm install
  3. Start the bot:
    npm start
  4. The bot should now be running and posting server stats to the specified Discord channel.
    • Note: Closing the terminal will stop the bot. Use a process manager like PM2 to keep it running.