SHO GTR2 Agent Tools
Description
SHO GTR2 Agent Tools is a set of tools developed by AI agents for AI agents to automate testing, driving, troubleshooting, and more. You are in the driver's seat by simply prompting the agent any way you like. The sky is the limit.
Download
Discussion
Help support my work
You can help support my work or just show your appreciation by donating to paypal@shovas.ca, tipping on ko-fi.com, or by sending BTC Bitcoin to bc1q8nwwnwp9zljndlcaw4jcmj0yfyqe69fa5k54dm, LTC Litecoin to ltc1qljlmg5673q6j0s5cmxk4ggyn0x5d4npaw25vah, DOGE Dogecoin to DSMwwdHqJ3LMxPe1HiGgNKsWBY2jPi2RwW, or XRP Ripple to rGUoiGSjhsM14sPyePao1eqvjD6sXa1uLL. Thank you!
Latest Release
See README Release Notes section for older versions)
26111402 (2016-11-14)
- No admin user or admin privs required
- Agents can setup GTR2 from a cold, pristine, never-run Steam GTR2 download (you need your own Steam GTR2) including configuring everything in GTR2Config.exe and launching the game autonomously
- Agents can autonomously navigate the UI
- Agents can start race sessions and start autonomous driving which is script driven, not AI-driven, so it's zero-cost concerning AI usage
- Autonomous Driving is done by keyboard inputs, vJoy-powered controller inputs, or vJoy-powered wheel inputs
- Agents can intelligently troubleshoot and dynamically investigate crashes or anything you describe via a prompt
- Agents will notice crashes and then check trace files and/or crash dump files
- Agents understand file contents, structure, and meaning to a very impressive degree
- Agents can use development and debugging tools (via included python local environment) to analyze even binary files in order to figure things out
Getting Started
- #Download
- Extract zip in your Documents folder
- Copy pristine never-run Steam GTR2 downloaded folder into the Documents folder
- This is a recommendation, because it ensures full read/write access between the tools folder and the game folder which is required, but the folders could be anywhere and you will configure this in the tools setup script later
- Start an agent session and add both folders so it knows about them and has full access
- Run any exploratory prompts you want
- Recommend initialization:
/init <GTR2-AGENT-TOOLS-FOLDER-NAME> is a copy of a folder of agent tools for the video game GTR2 (Steam version). <GTR2-AGENT-GAME-FOLDER-NAME> is a copy of Steam GTR2 in a pristine state (downloaded but never run). Your tasks are to (1) init on each folder, (2) explore the folders and bring yourself up-to-date on what's there, what they provide, what tools are available, and what is possible in each folder; (3) Your next tasks are to get GTR2 started to the main menu and exit.
- Install Dependencies
- Your agent will probably notify you about htis
- See DEPENDENCIES.md for what to install eg. git, vjoy. Some things can be installed by a non-admin account while some others require an admin account.
Want to help?
- Fork GTR2 Agent Tools GitHub Repo and start making changes (GitHub Repo Coming Soon)
- Submit a pull request for anything you think should be merged into SHO GTR2 Agent Tools
Getting Started With AI Agents
New to AI or AI Agents? It's both easier and more powerful than you may think.
Start here:
- This tool was the result of my first two weeks with AI Agents
- I started with Claude Code and then tried out ChatGPT Codex, OpenCode, and Ollama local models
- If you're comfortable with chatbots then you'll be fine
- Signup for an account with Claude or ChatGPT or OpenCode
- Download their desktop apps
- Install and start their apps
- You'll be shown a typical chatbot-like prompt
- Add a folder to your chat session (Usually just below the prompt)
- Now start asking the agent to do things in that folder
- If you you add a folder like GTR2 to your chat session, you can start getting the agent to do interesting things
- Experiment and have fun
Tips
Claude Code Does Not Need Admin Privileges To Install
- tl;dr Install Claude Code as you normally would but when the dialog to enter your Admin password is displayed, cancel out of it, and the Claude Code installer will tell you it can continue as a regular user
- There is no loss of important functionality that I'm aware of
- I assume other agents, like ChatGPT Codex or OpenCode, work in a similar way
Experiment with what the agent can do with GTR2 and its files and folders
- Ask the agent to create a tools folder git repo and a game folder git repo and to import everything in
- This enables you to safely rollback anything done by prompts that you don't like just by prompting again
- Ask the agent what it knows about GTR2 and what it's present abilities are
- Ask the agent to run a test sweep of the UI
- Ask the agent to go to a random track with a random car and start driving
- Ask the agent to investigate a problem that you know about and can describe
- Ask the agent to fix something
- Ask the agent to improve something
- Ask the agent to add a new feature
- Ask the agent to make a change to the menus: The agent understands GTR2's menu files and can edit them like modders can
The agent might not be able to do everything (yet) but I think you'll be impressed what it can already accomplish.
Use the Agent and Tools as a Knowledge Base
- Got a question about GTR2? Ask the agent. In the process of training the agent on GTR2, it discovers and remembers a lot about the game that doesn't make it into highlights or feature lists.
- For example, while training cars to leave the garage, it had to work out where the garage geometry was by unpacking GTR files, analyzing TRK files, and combining that with waypoints in the AIW files. There's many questions you could ask around driving cars, managing garages and pitlanes, walls, how cars are placed in the garage, pitlane entries and exits, and pitlane merging with race lines, etc. The possibilities are endless.
- The agent can probably help you with an answer but if not then it will probably suggest an invitation you can approve it to do to test out cases until it finds out the answer.
Questions
Is Steam GTR2 required? Will Disc GTR2 Work?
- SHO GTR2 Agent Tools is tested against Steam GTR2
- - But agents are so good I am sure in a few prompts it will have Disc GTR2 running for you
Troubleshooting
Missing DLL Error Dialogs
- Steam GTR2 requires at least the Microsoft DirectX End-User Runtimes (June 2010) and Visual studio 2010 (VC++ 10.0) SP1 x86
- See GTR2 Windows XP/Vista/7/10/11+ Compatibility for more details
Freezes or Hitches or Stalled White Screens
- Set PCI-E Power Management to Off in Windows power plan settings
- Set Power Plan to Prefer Maximum Performance in the NVIDIA Control Panel
What does SHO stand for?
SHO is the first three letters of my username (Shovas) but also happens to be an acronym used by Ford, which stands for "Super High Output", so I feel is an appropriately fun acronym for a sim racing mod :)
Credits
Thank you to The Iron Wolf, T-Shirt, MJQT, and others for assistance, input, reference, help, encouragement, and inspiration in the making of this mod!
License
See License.txt for full details.
SHO GTR2 Agent Tools © 2026 by Shovas is licensed under Creative Commons Attribution-NonCommercial 4.0 International. This license requires that users give credit to the creator. It allows reusers to distribute, remix, adapt, and build upon the material in any medium or format, for noncommercial purposes only.
View the full license here: http://creativecommons.org/licenses/by-nc/4.0/
You don't have to ask permission for legitimate uses. You just have to give credit.
I think this provides clarity and is a nice compromise that maintains modding freedom while protecting the people that made them from losing credit to their work and against people who would cut out authors from profit from copying it.
Contact
You can reach me, Shovas, on Simwiki Discord, Simwiki Forums, Race Department, European Endurance Center (EEC), F1 Classic, Trackaholics, Sim Racing Mirror Zone, eSport-Racing.de, Festbierbude.de, Koelschbierbude.de, or Altbierbude.de, my personal wiki Shovas.ca, or my personal blog Selah.ca.