Courseplay: Unload Me V1.1.5.0

Courseplay: Unload Me enables Courseplay unloader tractors to automatically track, match speed, and unload combines driven manually by the player while they are moving.

Features

• Unload player-driven combines on the move without hiring Courseplay AI for the combine.
• The unloader automatically matches combine speed and aligns the 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 will not 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 the tank reaches 80% capacity.

Requires Courseplay for FS25.

YOU NEED: CoursePlay

Issues / Bug Tracker: https://github.com/exekx/FS25_CourseplayPlayerUnload/issues

Changelog

• V1.1.5.0
  Unloader Selection and Long-Range Dispatch
  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_DO and IDLE).

  Harvester Detection and Trailer Filtering
  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.

  Curved Swaths and Dynamic Path Tracking
  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.

  Pipe Controls and Unloader Lifecycle
  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.

  Forage Harvester Turn Handling
  Fixed hook argument signature for Courseplay’s startChopperTurn preventing 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.

  Stability and Engine Crash Guards
  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.

• 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.