Documentation
Setup & commands
Everything you need to connect a Farming Simulator 25 dedicated server to your Discord, plus a reference for all 44 commands.
Step by step
Setting up
- Invite Farmalytics
Add the bot to your Discord.
You will need Manage Server on the Discord you are adding it
to. The invite asks for six permissions and no more:
- View Channels and Send Messages so it can post at all.
- Embed Links and Attach Files because every report is an embed, and the field map is a PNG.
- Read Message History so it can find and edit its own status panel instead of posting a new one each time.
- Use External Emojis for the crop and status icons, which live in the Farmalytics support server.
- Mention Everyone only so YouTube announcements can
ping
@everyoneif you choose that as the ping role. The bot pings nothing unless you configure it to.
- Install FSConnect on your game server Farmalytics works without it, but most reports need the data it exports. See the download page.
- Find your stats-feed URL
Farming Simulator dedicated servers publish a small status
page. In your game server's web manager, copy the
dedicated server stats XML link. It contains a
code=value, and anyone holding that link can read your server's status, so treat it like a password. - Run
/setup-serverin Discord Paste that stats URL, plus the FTP host, username and password for the same game server. Farmalytics finds the mod's data folder itself, and your FTP password is encrypted before it is stored. - Choose your Discord channels
/manage-serversets where the status panel and notifications are posted./set-alerts-channeland/set-bot-channelmove farm alerts and bot notices into channels of their own, if you would rather keep them apart. - Optional: claim a live map address
/map-setuppublishes a live map of your farm atfarmalytics.co/map/your-name, which you can share with anyone.
Why does it need FTP as well as the stats URL? The stats
feed only says who is online and which map is loaded. Everything
else — fields, herds, finances, contracts, vehicle positions
— comes from files FSConnect writes onto your game
server's own disk, and FTP is how Farmalytics reads them.
Reference
Commands
Most reports cover the game server linked to the Discord channel you run them in. Commands marked admin-only need the Manage Server permission in Discord.
Setting up
/manage-serverView, edit, or delete your Farming Simulator server configurations.
/set-alerts-channelSet (or clear) the channel where farm change-alerts are posted — separate from notifications & chat.
/set-bot-channelSet (or clear) the channel for Farmalytics bot notices — releases, mod updates, admin messages.
/setup-serverAdd a Farming Simulator server to this Discord.
Your server
/animal-warningsLivestock welfare report — feed, health, births, breeding and aging warnings.
/farm-membersWho belongs to each farm, their role and when they last played.
/field-adviceWhat to do next on each field — offline crop-management advice and reasoning.
/network-overviewEvery server you run, side by side — status, fields, storage and money.
/price-historyPrice across the year for a crop — when to sell and when to hold.
/server-animalsAnimal husbandry overview — health, productivity and feed levels.
/server-bunkersBunker silo fill, compaction and fermentation status.
/server-contract-statsContract completion history — totals and player breakdown per farm.
/server-contractsActive contracts — title, reward, location and deadline per farm.
/server-dealerUsed machinery for sale — price, condition and days left.
/server-economyMarket prices — best sell locations and top crop values.
/server-farmsEvery farm — balance, land worked, fuel used and lifetime stats.
/server-fieldsField status — crops, growth progress, harvest-ready and suggested actions.
/server-financeFarm finances — balance, loan, vehicle values and net worth.
/server-fleetVehicle fleet — wear, hours worked, value and what needs repair.
/server-mapMap of your fields, colour-coded by what each one needs.
/server-productionsProduction chains — running status, throughput and input/output storage.
/server-storageWhat's in your silos and productions — farm-wide totals.
/server-vehiclesVehicle fleet — fuel, damage and engine status for all farms.
/server-weatherCurrent in-game weather, temperature and 3-day forecast.
/server-workersLive Courseplay drivers — job, progress and time remaining.
/server-yieldsHarvest totals per field and crop, with yield per hectare.
Players
/chat-historyView in-game chat history for a player on this server (admin only).
/linkLink your Discord account to your in-game name.
/player-leaderboardShows the playtime leaderboard for all players.
/player-statsLook up a player's total playtime and session history.
/rosterEveryone who plays, whether they're linked, and when they last played.
/unlinkRemove your in-game name link.
/unlink-userClear someone else's in-game name link.
/whoisLook up who a Discord member is in game, or vice versa.
Live map
/map-infoShow this server's live-map address.
/map-removeRelease this server's live-map address.
/map-setupClaim this server's public live-map address.
YouTube
/youtube addWatch a YouTube channel and announce its new uploads.
/youtube listShow which YouTube channels are being watched.
/youtube removeStop announcing uploads from a YouTube channel.
/youtube testPreview what an upload announcement will look like.
Subscription
/manage-systemsOwner only — manage guild subscription tiers.
/view-subscriptionView this server's current Farmalytics subscription plan and limits.
Help
/bug-reportSubmit a bug report to the Farmalytics development team.
Limits
What each plan includes
| Plan | Price | Game servers | YouTube | Checked every |
|---|---|---|---|---|
| Free | Free | 1 | 1 | 120s |
| Plus | £12/year | 5 | 5 | 60s |
| Pro | £25/year | 10 | 15 | 45s |
| Network | £50/year | 25 | 1000 | 30s |
"Checked every" is how often Farmalytics asks your Farming Simulator server what is happening, so it sets how quickly a player joining or leaving, or the server going down, appears in Discord. A change you can see always repaints the status panel straight away, on every plan.