Courseplay: Scaricami

Selezione e invio a distanza dei mezzi di scarico
- Aggiunto un raggio di ricerca esteso fino a 4000 metri per un invio fluido dei mezzi di scarico su mappe di grandi dimensioni (4x e 16x).
- Introdotto un sistema intelligente di valutazione dei candidati, che dà priorità ai trattori già operativi sul campo in questione.
- Inserita la ponderazione del livello di riempimento del rimorchio nella selezione del trattore, privilegiando i carri vuoti o parzialmente carichi rispetto a quelli quasi pieni.
- Aggiunto il supporto per l'invio di mezzi di scarico che si trovano in stato di attesa (`WAITING_FOR_SOMETHING_TO_DO` e `IDLE`).

Rilevamento delle mietitrici e filtraggio dei rimorchi
- Implementata una verifica rigorosa dell'oggetto mietitrice (`isHarvesterObject`) per evitare assegnazioni basate su falsi positivi.
- Risolti errori di identificazione tra rimorchi e carri a coclea: carri per cereali, rimorchi per insilato e botti per liquami non vengono più scambiati per mietitrici.
- Mantenuto il supporto specifico per le vere mietitrici trainate (per colture a radice o foraggio) dotate di organi di taglio e tubi di scarico.
- Aggiunta la convalida della gerarchia tra veicolo portante e attrezzatura modulare per configurazioni complesse.

Andane curve e tracciamento dinamico del percorso
- Aumentata la tolleranza dell'angolo di allineamento fino a 60 gradi per evitare l'interruzione del servizio di scarico durante curve strette o in presenza di bordi del campo curvi.
- Estesa la tolleranza per lo scostamento laterale fino a 6 metri, garantendo un affiancamento fluido anche su terreni irregolari.
- Aggiunta una verifica di prossimità (< 30 m) nella fase di avvicinamento prima di passare alla modalità di scarico attivo.
- Migliorato il puntamento dinamico "look-ahead" basato sulla direzione in tempo reale e sulla traiettoria curva della mietitrice.

Gestione del tubo di scarico e del ciclo di vita del mezzo di scarico
- Ottimizzata la logica di annullamento dell'incarico in base alla chiusura del tubo: i trattori in transito verso il campo non vengono più cancellati prima di raggiungere la macchina.
- Configurato l'annullamento dell'incarico in modo che avvenga solo dopo l'effettivo scarico o quando il tubo viene richiuso dopo essere stato aperto per l'operazione.
- Introdotto il rilascio automatico del mezzo di scarico quando il giocatore scende da una trincia (forage harvester) per più di 20 secondi.
- Garantito il ripristino corretto dello stato alla partenza del trattore per evitare blocchi dell'assegnazione dovuti a dati obsoleti.

Gestione delle manovre di svolta per le trince
- Corretta la firma dell'argomento per la funzione `startChopperTurn` di Courseplay, prevenendo errori nella chiamata del metodo. - Rimosse le routine di sterzata a ciclo aperto per eliminare movimenti irregolari delle ruote e vibrazioni del trattore durante le svolte.
- Ripristinata una procedura di attesa pulita a fine passata: i trattori si arrestano esattamente sul posto al termine della fila, lasciando alla mietitrice pieno spazio di manovra per la svolta.
- Ottimizzati la sincronizzazione della velocità e il mantenimento dinamico della distanza di sicurezza posteriore una volta che la mietitrice entra nella nuova fila.

Stabilità e prevenzione crash del motore
- Aggiunta una routine di pulizia ricorsiva per rimuovere dalle tabelle di tracciamento attive i veicoli eliminati, venduti o resettati.
- Aggiunti controlli sull'esistenza dell'entità e sulla validità del nodo (`isValidNode`, `entityExists`) prima di qualsiasi calcolo spaziale.
- Inseriti i controlli anti-collisione all'interno di chiamate protette (`pcall`) per eliminare errori di divisione per zero e crash dovuti a riferimenti nulli.
- Aggiunti controlli di sicurezza per le associazioni dei comandi di input nei casi in cui le tabelle del veicolo o del chiamante non siano inizializzate.

- Attesa sulla capezzagna e sgombero dello spazio: i trattori di scarico si fermano ordinatamente sul posto alla fine dell’andana durante le manovre di svolta della mietitrebbia, lasciando il 100% della capezzagna completamente libero affinché la mietitrebbia possa manovrare senza collisioni o intralci.
- Rilevamento approfondito delle svolte basato su più fattori: rileva dinamicamente le svolte in capezzagna in base a diversi parametri fisici: stato sollevato della testata/pick-up (getIsLowered), flusso attivo del raccolto attraverso gli slot di alimentazione (loadingDelaySlots, isChopperFilling, isDischarging), angolo massimo di sterzata, velocità d’imbardata e retromarcia.
- Completamento istantaneo della svolta e inseguimento fluido: nel momento in cui il giocatore abbassa la testata sulla nuova fila o centra lo sterzo, lo stato di svolta termina istantaneamente, senza alcun ritardo. Il trattore di scarico si ricongiunge dolcemente alla mietitrebbia alla velocità di svolta, senza bloccarsi o rimanere incastrato con direzioni opposte.
- Selezione del lato di andane e file: durante la raccolta delle andane con i pick-up, i trattori di scarico mantengono intelligentemente il lato di approccio o rispettano l’offset manuale di Courseplay (+X a sinistra, -X a destra).
- Protezioni di sicurezza per le svolte della trincia Courseplay: intercetta gli stati interni di svolta della trincia di Courseplay (startChopperTurn, handleChopper180Turn, handleChopperHeadlandTurn) per garantire che i trattori di scarico non rimangano mai intrappolati alla ricerca di waypoint inesistenti del lavoro nei campi dell’IA (corso temporaneo --/--).
- Protezione contro un bug del motore GIANTS: integra una patch del motore che impedisce la ripetizione di errori LUA nella console (AIVehicleUtil.lua:337: attempt to index nil with 'getAttachedImplements') quando i trattori di scarico trainano rimorchi o attrezzi privi di ganci posteriori (ad es. Krampe SB 30/60).
- Distanza di sicurezza dietro la trincia: i trattori di scarico mantengono una distanza di sicurezza di 5 m dietro la cabina della trincia, direttamente sotto il tubo di scarico.

- Distanza laterale dinamica: il percorso dello scaricatore si adatta ora dinamicamente alla larghezza di qualsiasi testata/cutter collegato (dalle piccole testate da 4 m fino agli enormi cutter da 15,2 m e oltre), garantendo una distanza di sicurezza dalle testate larghe e mantenendo al contempo il rimorchio perfettamente centrato sotto il tubo di scarico.
- Correzione delle inversioni a fine campo: gli scaricatori seguono esclusivamente un percorso dietro la mietitrebbia, eliminando qualsiasi rischio di passare davanti alla testata durante le svolte.
- Richiamo manuale istantaneo (Maiusc destro + U): ridispatcha gli scaricatori già assegnati verso la posizione aggiornata della tua macchina dopo le inversioni ai bordi del campo.
- Distanza realistica nell’avvicinamento posteriore: durante l’avvicinamento, i trattori scaricatori mantengono una confortevole distanza di sicurezza di 5–7 m dietro il paraurti posteriore della mietitrebbia, invece di procedere incollati.
- Regolazione del sistema di collisione: risolti gli arresti causati da false collisioni con la mietitrebbia del giocatore e con le testate larghe.
- Compatibilità con l’offset di Courseplay: piena integrazione con l’impostazione di gioco di Courseplay «Combine offset X/Z» per regolazioni manuali precise.

- Supporto completo per NEXAT e Modular Carrier (modulo NexCo): Aggiunta la compatibilità completa con i portattrezzi a carreggiata larga dotati di tubi di scarico sul lato destro. Corretti i calcoli dell'offset del tubo, in modo che il rimorchio si allinei direttamente sotto il bocchettone senza rimanere indietro.
- Anticollisione e avvicinamento parallelo fluido: Eliminati gli sterzate brusche verso la mietitrebbia. I veicoli di scarico ora si avvicinano in modo fluido e rigorosamente parallelo alla macchina (angolo di convergenza massimo di 4°), mantenendo una distanza di sicurezza garantita da cingoli, ruote e cabina.
- Allineamento preciso da fermo: Quando una mietitrebbia si arresta con il serbatoio pieno, il veicolo di scarico si posiziona con precisione sotto il bocchettone e si arresta completamente, senza avanzare lentamente né deviare verso la mietitrebbia.
- Correzioni di bug e miglioramenti: Risolto l'errore Lua «attempt to call missing method getAIDirectionNode» sui veicoli privi della specializzazione IA. Unificata l'architettura dei nodi di riferimento per un inseguimento stabile al 100% su mietitrebbie standard, trincia-raccoglitrici e attrezzi collegati.