A standalone add-on mod for Farming Simulator 25 and Courseplay that enables Courseplay AI unloader tractors to automatically approach, track, match speed, and unload combines and forage harvesters (choppers) driven by human players!
Repository: https://github.com/exekx/FS25_CourseplayPlayerUnload
- Added expanded search radius up to 4000 meters for seamless unloader dispatch across massive 4x and 16x maps.
- Added intelligent unloader candidate scoring prioritizing tractors already serving the active field.
- Added trailer fill level weighting in tractor selection to prefer empty or partially loaded wagons over nearly full trailers.
- Added support for dispatching unloaders in waiting states (
WAITING_FOR_SOMETHING_TO_DOandIDLE).
- Added strict harvester object verification (
isHarvesterObject) preventing false-positive assignments. - Fixed trailer and auger wagon misidentification: grain carts, silage trailers, and slurry tanks are no longer mistaken for harvesters.
- Preserved specialized support for genuine trailed root and forage harvesters with cutters and discharge pipes.
- Added carrier and modular implement hierarchy validation for complex setups.
- Relaxed alignment angle tolerance up to 60 degrees to prevent unloader dropouts on sharp turns and curved field boundaries.
- Expanded lateral offset tolerances up to 6 meters to keep unloaders tracking smoothly alongside on uneven ground.
- Added proximity verification (< 30m) in approach phase before switching into active unloading mode.
- Improved dynamic lookahead targeting along the combine's real-time heading and curved path.
- Added smart pipe-folding dismissal tracking: tractors en route across the field are no longer cancelled before reaching the machine.
- Configured dismissal to trigger only after unloading has actively taken place or when the pipe is folded after being opened for discharge.
- Added automatic unloader release when the player exits a forage harvester for longer than 20 seconds.
- Ensured clean state reset upon tractor departure to prevent stale assignment locks.
- Fixed hook argument signature for Courseplay's
startChopperTurnpreventing method call errors. - Removed open-loop steering routines to eliminate erratic wheel movements and tractor jitter during turns.
- Restored clean swath-end waiting: tractors stop straight in place at the end of the swath, giving the harvester 100% free turning room.
- Polished smooth speed matching and dynamic rearward standoff follow once the harvester enters the new row.
- Added recursive cleanup routine removing despawned, sold, or reset vehicles from active tracking tables.
- Added entity existence and valid node checks (
isValidNode,entityExists) prior to all spatial calculations. - Wrapped collision avoidance checks in protected calls (
pcall) to eliminate zero-speed division errors and nil reference crashes. - Added safety guards for input action bindings when vehicle or caller tables are uninitialized.
In standard Courseplay, combine unloader drivers only service combines that are operated by Courseplay fieldwork AI workers. When you choose to drive the combine or forage harvester yourself, Courseplay unloaders remain idle at their wait points.
Courseplay: Unload Me creates a bridge between your player-driven machine and Courseplay's unloading subsystem. Without changing how you drive or harvest, idle Courseplay tractors will automatically respond to your physical actions or key presses, pull up alongside under the pipe/spout on the fly, match your speed while you continue cutting, and depart smoothly once full or when unloading is done.
You don't need to press any hotkeys to get unloaded! Extending your discharge pipe or operating your machine serves as an intuitive physical command:
- Combines with Grain Tank: As long as your tank contains crops (> 1%), extending your discharge pipe ALWAYS automatically calls the nearest idle Courseplay unloader, regardless of your Auto-Call toggle setting.
- Forage Harvesters / Choppers (No Tank): Unfolding the pipe/spout and turning on the cutter or driving forward ALWAYS automatically calls an unloader. The unloader remains by your side continuously until its trailer is filled or you fold the pipe / turn off the machine.
- Fold / Close the Pipe:
- If the unloader is currently alongside you unloading, closing the pipe signals that you are done. The unloader immediately finishes, steers away, and departs.
- If the unloader is still on its way across the field and you fold the pipe, the call is cancelled and the tractor safely returns to its waiting position.
- What this toggle actually does: Right Shift + I ONLY controls whether an unloader is called automatically in advance when your grain tank reaches 80% capacity (before you have even opened the pipe).
- Disabled by default: This is turned OFF by default so you don't have tractors driving over until you are ready.
- Enabled: If turned ON, an unloader will set off towards you as soon as your tank reaches 80% fill, so it is already waiting alongside when you unfold the pipe.
- (Note: For forage harvesters without grain tanks, opening the pipe or activating the cutter calls the unloader directly).
- Press Right Shift + U at any moment to immediately summon the nearest available Courseplay unloader on demand, regardless of pipe position or fill level.
- Supported Trailers: Standard tipping trailers, dump trailers, silage trailers, and auger wagons with single axle, tandem, or tridem configurations.
- Turntable / Dolly Drawbar Trailers: Courseplay's internal AI unloader driver restricts turntable drawbar trailers (trailers with a steerable front axle/dolly) when backing up or maneuvering. For best results with Courseplay unloaders, use rigid/tandem trailers or auger wagons.
- Dynamic Real-Time Vector Tracking: The unloader calculates pipe geometry, combine ground speed, heading, and turning angle in real time to smoothly match your pace and keep the trailer perfectly centered under the auger.
- Natural Drive-Away Routine:
Utilizes Courseplay's collision-free pull-away maneuvers (
MOVING_BACKstate) so the tractor turns safely away from your combine when departing. - Zero Input Interference: Operates completely in the background without affecting manual combine controls, thresher toggles, cutter header height, or steering.
- Optimized & Lag-Free: Cached target resolution and low-overhead periodic scanning ensure smooth gameplay and zero FPS drops.
- Multiplayer & Dedicated Server Ready: Fully compatible with multiplayer sessions and dedicated servers.
- 27 Languages Supported: Includes full translations for all 27 languages supported by Courseplay in Farming Simulator 25.
| Keybinding | Action | Description |
|---|---|---|
| Right Shift + U | Call Unloader | Dispatches the nearest idle Courseplay unloader to your combine immediately. |
| Right Shift + I | Toggle 80% Auto-Call | Enables or disables automatic advance calling when grain tank hits 80% (Disabled by default; opening the pipe always calls an unloader regardless). |
Keybindings can be customized at any time in the in-game Controls Options menu.
- Farming Simulator 25 (Version 1.2 or higher)
- FS25_Courseplay installed and activated in your game.
- Download the latest
FS25_CourseplayPlayerUnload.zipfrom the Releases section. - Place the
.zipfile into your Farming Simulator 25 mods folder:- Windows:
Documents\My Games\FarmingSimulator2025\mods\ - Mac:
~/Library/Application Support/FarmingSimulator2025/mods/
- Windows:
- Launch the game and ensure both Courseplay and Courseplay: Unload Me are checked in the mod selection screen.
- Add-on Author:
exekx(GitHub Profile) - Add-on Repository: exekx/FS25_CourseplayPlayerUnload
- Original Courseplay: Special thanks and gratitude to the Courseplay.devTeam for creating and maintaining the Courseplay mod for Farming Simulator 25 (Courseplay GitHub Repository).
- License: Distributed under the GNU General Public License v3.0 (GPL-3.0).
If you find this add-on helpful and enjoy your harvesting workflow, consider supporting ongoing development:
