Courseplay: Unload Me enables Courseplay unloader tractors to automatically track, match speed, and unload combines driven manually by the player on the go.
Requires Courseplay for FS25. GitHub: https://github.com/exekx/FS25_CourseplayPlayerUnload
Issues / Bug Tracker: https://github.com/exekx/FS25_CourseplayPlayerUnload/issues
Required mods: CoursePlay
Features
- Unload player-driven combines on the move without hiring Courseplay AI for the combine.
- Unloader automatically matches combine speed and aligns trailer under the pipe.
- Unfolding the combine pipe automatically summons the nearest idle Courseplay tractor.
- Folding the pipe acts as a dismiss command: the tractor safely steers away and departs.
- Starting to drive after calling while stopped won’t strand the tractor; it chases and catches up.
- Right Shift + U: manually summon the nearest unloader on demand.
- Right Shift + I: toggle advance auto-call when tank reaches 80% capacity.
Changelog
- V1.1.4.0
- Headland Turn Waiting & Space Clearance: Unloader tractors cleanly stop in place at the end of the swath during combine turn maneuvers, leaving 100% of the headland completely free for the harvester to maneuver without collisions or crowding.
- Deep Multi-Factor Turn Detection: Dynamically detects headland turns across several physical parameters: cutter/pickup lifted status (getIsLowered), active crop flow through feeding slots (loadingDelaySlots, isChopperFilling, isDischarging), steering lock, yaw rate, and reversing.
- Instant Turn Completion & Seamless Follow: The moment the player lowers the header onto the new row or centers steering, the turn state ends instantly with zero delay. The unloader smoothly rejoins the combine at turn speed without freezing or deadlocking on opposite headings.
- Swath & Windrow Side Selection: When picking up swaths with pickups, unloaders intelligently maintain the side of approach or respect manual Courseplay offset (+X left, -X right).
- Courseplay Chopper Turn Safety Guards: Intercepts Courseplay’s internal chopper turn states (startChopperTurn, handleChopper180Turn, handleChopperHeadlandTurn) to ensure unloaders never get trapped looking for non-existent AI fieldwork waypoints (temporary course –/–).
- GIANTS Engine Bug Safety Guard: Integrated an engine patch preventing repeating LUA console error spam (
AIVehicleUtil.lua:337: attempt to index nil with 'getAttachedImplements') whenever unloaders tow trailers or implements lacking rear hitches (e.g. Krampe SB 30/60). - Forage Harvester (Chopper) Safe Standoff: Unloaders maintain a safe 5m rearward standoff distance behind the chopper cab directly under the discharge spout.
- V1.1.2.0
- Dynamic Lateral Clearance: Unloader path now dynamically adapts to any attached cutter/header width (from small 4m headers up to huge 15.2m+ cutters), ensuring safe distance from wide headers while centering the trailer directly under the discharge spout.
- Headland Turnaround Fix: Unloaders route exclusively behind the combine, eliminating any risk of driving out in front of the header during turns.
- Instant Manual Re-Call (Right Shift + U): Re-dispatches already assigned unloaders to your machine’s updated position after field-edge turns.
- Realistic Rear Approach Distance: Unloader tractors maintain a comfortable 5-7m safety gap behind the combine’s rear bumper during approach instead of tailgating.
- Collision System Tuning: Fixed false collision stops against the player combine and wide headers.
- Courseplay Offset Compatibility: Full integration with Courseplay’s in-game “Combine offset X/Z” setting for fine manual adjustments.
- V1.1.1.0
- Full NEXAT & Modular Carrier Support (NexCo module): Added full compatibility for wide-span carriers with right-side discharge pipes. Fixed pipe offset calculations so the trailer aligns directly under the spout without lagging behind.
- Anti-Collision & Smooth Parallel Approach: Eliminated sharp steering turns into the harvester. Unloaders now approach smoothly and strictly parallel to the machine (maximum 4° convergence angle) with guaranteed safety clearance from tracks, wheels, and the cab.
- Accurate Standstill Alignment: When a combine stops with a full tank, the unloader pulls up precisely under the spout and comes to a full stop without creeping or drifting into the combine.
- Bug Fixes & Improvements: Fixed the Lua error “attempt to call missing method getAIDirectionNode” on vehicles lacking AI specialization. Unified reference node architecture for 100% stable tracking on standard combines, forage harvesters, and attached implements.
