[REL] rF2 Chat/Automation Tool

yottu

Registered
rF2 Chat/Automation Tool
## Introduction

The `rF2 Chat/Automation Tool` is a multifunctional desktop application designed to provide powerful support for operating rFactor 2 Dedicated Servers.
It offers features such as chat message automation, flexible grid editing based on result files, and real-time server status monitoring to streamline the workflow for race administrators.
1768565522962.png


## Download
rF2 Chat/Automation Tool v1.01.0

##New in v1.01.0
Support for individual management of multiple server instances (multi-server) has been added.
In addition to chat messages, server operations (such as Restart Weekend) can now be automated.

## Features
* **Multi-Server Support:** Select and connect to specific rFactor 2 Dedicated Server processes from multiple running instances.
* **Server Information Display:** Displays the connected server name, PID, and Shared Memory status.
* Displays the current session type and elapsed time.
* **Server Operations:** Remote control of the server via `Restart Weekend` and `Next Session` buttons.
* Manual chat message sending (up to 58 characters).
* 5 template message buttons (for inserting preset text).
* 15 customizable shortcut message buttons.
* Event-driven / Time-elapsed / Time-based automated message sending.
* **Automation of Server Operations:** Can execute commands like `Restart Weekend` as automated messages, not just chat text.
* Management of multiple automated message profiles (up to 30 messages per profile).
* GUI-based editing of various settings (messages, profiles).
* Add, Copy, and Delete profiles.
* Grid editing functions: Manual / Top N Reverse / Class-based sorting.
* Load result XML files and edit the starting grid via GUI.
* Auto Edit: Top N Reverse, Class-based Sort.
* Manual Edit: Freely swap driver positions.
* Outputs the edited grid as `SetGrid.ini` and automatically sends the apply command.
* Internal operation log display.

## Important Notes

* The rFactor 2 Dedicated Server must be running to use this application.
* This application assumes the process name of the rFactor 2 Dedicated Server is `rFactor2 Dedicated.exe`.
* If there are unsaved changes when you close the application, a confirmation dialog will appear. You can choose to discard the changes and exit, or cancel to continue editing.

## Installation and Startup

1. **Prepare the Plugin:** Add `rFactor2SharedMemoryMapPlugin64.dll` to the plugins used by your rFactor 2 Dedicated Server.
(Download from: rF2 Shared Memory Tools for Developers)
* Plugin location: `[Installation Folder]\rFactor 2\Bin64\Plugins`
2. **Configure the Plugin:** Modify `CustomPluginVariables.JSON` to enable `rFactor2SharedMemoryMapPlugin64.dll`.
* `CustomPluginVariables.JSON` location: `[Installation Folder]\rFactor 2\UserData\player`
* Set `"Enabled": 1` for `"rFactor2SharedMemoryMapPlugin64.dll"` (other values may vary).
3. **Launch the Application:** With the rFactor 2 Dedicated Server running, launch `rF2 ChatAutomation Tool.exe`.

## Acknowledgements
This application was created using the following excellent software. My sincere thanks to the authors.
* rFactor 2 Shared Memory Tools for Developers (Author: The Iron Wolf / TheIronWolfModding):
Uses the plugin that mirrors rFactor 2's internal state to shared memory.
* pyRfactor2SharedMemory (Author: Tony Whitley):
Uses the Python library for accessing rFactor 2's shared memory.

## Release History
* 23/11/2025 - v1.00.0: Initial Release
* 16/01/2026 - v1.01.0: Multi-server support, Server operation features, UI refresh, Bug fixes
 

Attachments

  • rF2_ChatAutomation_Tool.png
    rF2_ChatAutomation_Tool.png
    44.4 KB · Views: 634
  • rF2_ChatAutomation_Tool_GridTab.png
    rF2_ChatAutomation_Tool_GridTab.png
    46.2 KB · Views: 193
  • rF2_ChatAutomation_Tool_MainTab.png
    rF2_ChatAutomation_Tool_MainTab.png
    40.3 KB · Views: 186
  • rF2_ChatAutomation_Tool_MessageEditTab.png
    rF2_ChatAutomation_Tool_MessageEditTab.png
    44.6 KB · Views: 191
  • rF2_ChatAutomation_Tool_MultInstance.png
    rF2_ChatAutomation_Tool_MultInstance.png
    1.2 MB · Views: 98
Last edited:
Hi, nice work. I also have multiple dedicated server instances, and for convenience, I renamed the files "rfactor2 Dedicated.exe." Is it possible to indicate the name of the server I'm using?
 
**New in v1.1:**
Support for individual management of multiple server instances (multi-server) has been added. In addition to chat messages, server operations (such as Restart Weekend) can now be automated.
 

Attachments

  • rF2_ChatAutomation_Tool_MultInstance.png
    rF2_ChatAutomation_Tool_MultInstance.png
    1.2 MB · Views: 103
Good evening,Thank you for this fabulous software that I use on my server with the default settingsI would like to put personalized messages, but how can I have a “Welcome” message each time a player connects?
 
 
Hi Yottu,

Amazing tool, thank you for putting this together! We've been doing some testing but can't seem to get the shortcut messages to trigger an action on the server. For example, if I press 'Next Session' or 'Restart Weekend' - I can see the message is sent to the server, but the server doesn't react to the message.

Is there anything I need to do, to ensure the server reacts to the shortcut messages?

PS. Setting grid works well, and the newer 'server command' buttons work well, just server commands via shortcut messages doesn't seem to work.
 
Hi Yottu,

Amazing tool, thank you for putting this together! We've been doing some testing but can't seem to get the shortcut messages to trigger an action on the server. For example, if I press 'Next Session' or 'Restart Weekend' - I can see the message is sent to the server, but the server doesn't react to the message.

Is there anything I need to do, to ensure the server reacts to the shortcut messages?

PS. Setting grid works well, and the newer 'server command' buttons work well, just server commands via shortcut messages doesn't seem to work.
Hi,

Thank you for using the tool and for the great feedback!

To help me understand the issue better, could you clarify what exact text you entered in the Shortcut Message field?

Here is how the tool currently handles commands:

1. Shortcut Messages vs. Dedicated Server Commands
- Shortcut Messages are designed to send text directly into the Dedicated Server's in-game chat box.
- Server Command buttons (on the dedicated command section) directly trigger the Windows buttons on the Dedicated Server window (via Win32 button click).

2. If you are trying to run in-game chat commands:
- rFactor 2 requires server chat commands to start with a slash `/`.
- For example, instead of typing `Next Session`, the message text needs to be `/callvote nextsession` or `/callvote restartweekend` (as defined in the official rF2 multiplayer server commands).
- If the slash is missing, the server treats it as plain chat and won't react.

3. If you were trying to trigger the Dedicated Server GUI button via shortcut:
- Currently, shortcut buttons only send text to the chat input and do not trigger the Dedicated Server's GUI buttons.
- If you'd like to trigger GUI buttons like 'Next Session' directly via custom shortcuts (for example, using a `cmd:Next Session` syntax), let me know—I can look into adding that feature in a future update!

Could you check if using `/callvote nextsession` in the shortcut message works for you, or let me know your exact setup?

Thanks!
Yottu
 
Hi yottu, I'm getting the same sort of responses as Chris M, check out the attached screenshot and I'll try to explain what I did and what happens (server wise). Clicking the Red box enters the /admin rfactor password in the servers chat box, no confirmation either on server or me (I joined the server as a player) if this was successful or not(and who if any, was granted the admin status).
Clicking the Green box resulted in the correct behaviour, ie moved to next session.
Clicking the Blue boxes put the commands into the server chat box but no actions ensued. I changed the restart session button title to restart warmup to match /restartwarmup command it was sending.
I didn't test the FCY button.


rf2automation.jpg
 
Hi yottu, I'm getting the same sort of responses as Chris M, check out the attached screenshot and I'll try to explain what I did and what happens (server wise). Clicking the Red box enters the /admin rfactor password in the servers chat box, no confirmation either on server or me (I joined the server as a player) if this was successful or not(and who if any, was granted the admin status).
Clicking the Green box resulted in the correct behaviour, ie moved to next session.
Clicking the Blue boxes put the commands into the server chat box but no actions ensued. I changed the restart session button title to restart warmup to match /restartwarmup command it was sending.
I didn't test the FCY button.


View attachment 57593
Hi, thanks for the screenshot! I can see admin status is set properly.

The reason the `/callvote` shortcuts didn't trigger the session is because /callvote is literally a vote command—it requires connected players to approve it with `/vote yes` before anything happens. Without players' permission/votes, the server simply ignores it.

That's why the Green button (Server Command) worked, as it directly clicks the server GUI button without needing votes.
 
Hi, thanks for the screenshot! I can see admin status is set properly.
Who for? I was the only one on the server and did not get any "Goanna is now admin" message, in fact when I logged in to admin role via ingame chat I got the message and had the asterisk beside my name (indicating I'm an admin), if i was made admin via the tool, then when I logged in via ingame chat it would have removed me as admin, so I don't think the admin login shortcut button does anything ( I've changed mine now anyways to something else).
I'm currently playing around to see if I can get one of those shortcut buttons to invoke something like cmd:restartwarmup but not having much luck with it.
 
Who for? I was the only one on the server and did not get any "Goanna is now admin" message, in fact when I logged in to admin role via ingame chat I got the message and had the asterisk beside my name (indicating I'm an admin), if i was made admin via the tool, then when I logged in via ingame chat it would have removed me as admin, so I don't think the admin login shortcut button does anything ( I've changed mine now anyways to something else).
I'm currently playing around to see if I can get one of those shortcut buttons to invoke something like cmd:restartwarmup but not having much luck with it.
As mentioned in the manual, the shortcut buttons are simply fully customizable slots for any chat messages you'd like to send. The default entries were just temporary examples/placeholders, so you are meant to overwrite them with whatever text or commands suit your needs.

Also, shortcut buttons only send text to the chat box—they don't trigger server GUI buttons (unlike the dedicated Server Command buttons), so `cmd:` syntax doesn't apply there.
 
Back
Top