fs25-adsmartpickup/README.md

FS25_ADSmartPickup

AutoDrive-tillæg til Farming Simulator 25 med to funktioner oven på Pickup&Deliver:

1. Vare-bevidst mappe-rotation (én vare valgt)

Når pålæsningsmål roteres i en AD-mappe, køres der direkte til den silo i mappen, der har den valgte vare — mindst fyldte først (mælk/gylle: fyldeste først) — i stedet for at prøve markørerne én efter én.

2. Behovsstyret forsyning (flere varer valgt)

Én traktor holder alle input i en produktion fyldt — fx hø, græs, ensilage og sukkerroer til en TMR-blander — i stedet for én traktor pr. vare.

1. Aflæsningsmål = produktionens markør.
2. Multi-vælg ingredienserne i AutoDrives vare-dropdown.
3. Start Pickup&Deliver. Loop-tælleren virker som normalt (N læs → parkér, 0 = uendeligt).

Pr. tur læses målets lager; den ingrediens der mangler mest (relativt til kapacitet) hentes fra en silo hvor som helst på kortet (eget lager før nabo-lån, mindst fyldte først). Ingredienser uden plads i målet (< 1000 l fri) eller uden kilde springes over. Mens AD kører viser HUD'en kun turens vare (AutoDrive ville ellers selv rotere vare ved triggeren); når AD stopper, gendannes hele listen. Slå fra ved at vælge en anden enkelt vare.

"Mest brug for" defineres i ADSupplyPlanner.scoreNeed (adSupplyPlanner.lua).

Fabriksstyret (v1.6): målet er et produktionspunkt

Er aflæsningsmålet en fabrik (produktionspunkt), erstattes ingredienslisten af inputs fra fabrikkens ønskede produktioner — slår du fx TMR til i en AIO-fabrik, begynder traktoren at hente ensilage/hø/halm/roer/mineralfoder af sig selv; slår du den fra, holder den op. Dit multi-valg er kun tændknappen (og det gendannes ved stop). Listen genudledes hver tur, begrænset til det vognen kan bære.

• Ønsket produktion = tændt, ELLER slukket af kortet med status "mangler input" (Dakotas ExtendedProductionPoint slår produktioner fra automatisk, når de løber tør — dem skal vi netop fodre). Manuelt slukket = ikke ønsket.
• Prioritet = tid til tom: lager / (Σ amount × cyclesPerMinute) over ønskede produktioner — den vare der løber tør først hentes først, uanset relativ fyldning. Loggen viser forbrug og minutter.
• Fabrik uden ønskede produktioner, eller inputs vognen ikke kan bære → dit multi-valg som hidtil.

Kilder: en fabriks inputs stjæles aldrig (v1.6.1)

En fabriks læssestation udleverer også dens inputs (halm i en TMR-fabrik). Sådan en vare hentes aldrig derfra — kun fabrikkens outputs og rigtige siloer er kilder. Gælder både mappe-logik og behovsstyring. Varer der både er input og output (kæde) må hentes.

Stalde som mål (v1.6.1)

Kostald m.fl. svarer selv for niveau/kapacitet (getHusbandryFillLevel/Capacity), så halm+TMR til en stald rangeres korrekt, selv om staldens aflæsningsstation kun "kender" foder.

Wait-punkter: rest-læs ved fuld stald (v1.7)

AutoDrive holder ellers en traktor med rest-læs stille ved aflæsningspunktet, til den er tømt — og spærrer for de næste i køen. Med Wait-punkter:

1. Læg markører i en mappe med ordet Wait i navnet (fx mappen Cow Wait) — så mange du har plads til; de er en fælles pulje for alle traktorer. Markørernes egne navne er ligegyldige, så dine mark-ventepladser ("F91 Wait" i mark-mapperne) rører den ikke.
2. Kan målet ikke tage mere af vognens vare, kører traktoren til det nærmeste ledige Wait-punkt (modden holder styr på reservationer) og venter dér.
3. Når målet igen har plads til hele resten, kører den tilbage og læsser af. Derefter normal tur.

Kun den aktuelle aflæsningsopgaves destination ændres — mål, rotation og loop-tæller røres ikke. Ventende traktorer ser rotationen som slået fra, så AutoDrive ikke kører videre fra Wait-punktet. Ingen ledige Wait-punkter → AutoDrive venter ved målet som i dag (én advarsel i loggen). Seks markører må gerne hedde det samme (fx Cow Wait); loggen viser markørnummeret.

Læs der passer, foretrækkes (v1.7): ved valg af næste tur går varer, hvor et fuldt læs kan komme af i målet, forud; passer intet fuldt læs, tages den mest trængende alligevel (og Wait-punktet bruges).

Opsætning med flere stalde: én traktor (eller flere) pr. stald med Rotér mål: kun pålæsning. Brug IKKE "pålæsning og aflæsning": AutoDrive vælger næste pålæsning FØR den roterer aflæsningsmålet, så behovet ville blive regnet for den forkerte stald. Pålæsningsmarkøren må ikke være fast på en fabrik ("kun aflæsning") — så kalder AutoDrive aldrig modden, og alt valgt læsses dér.

Fælles

• Wrapper ADMultipleTargetsManager.getNextPickup (via den globale FS25_AutoDrive-tabel); rører ikke AutoDrive-zip'en.
• Siloens eget lager rangeres før nabo-lån (udvidelses-siloer deler lager inden for storageRadius).
• Intet fund, intet behov eller fejl i et spil-API → AutoDrives originale rotation. Valg logges som ADSmartPickup: i log.txt.
• Kræver i AutoDrive: "Brug mapper" + "Rotér mål: pålæsning" på køretøjet.
• Markør ↔ silo (v1.3): markøren er dér hvor trækkerens næse stopper; vognen holder et vogntog bagved. Markørens silo er derfor nærmeste trigger bag næsen set i ankomstretningen (forrige waypoint), højst 2 m foran. I tætte rækker (15 m mellem siloerne) er nabosiloens trigger ellers nærmere end markørens egen. Ingen trigger bag næsen/ukendt retning → nærmeste trigger som før.
• Kildestrategi (v1.5): lagervarer hentes fra den mindst fyldte silo først (rester ryddes, siloer frigives). Varer hvis tanke løber fulde — mælk, gylle, digestat — hentes fra den fyldeste kilde først, så produktionen ikke går i stå. Listen er ADSupplyPlanner.FULLEST_FIRST_FILL_TYPES (adSupplyPlanner.lua); tilføj fx MANURE = true hvis møddinger også skal tømmes fyldest-først. Loggen viser den brugte strategi. En trigger foran næsen tæller aldrig som markørens egen (v1.5).
• Spor-regel (v1.4): triggeren skal ligge i trækkerens spor (højst 6 m til siden). En tank med aflæsningsbane på den ene side og pålæsningsbane på den anden giver ellers to markører til samme tank, og "Dropof"-markøren kunne vinde. Kendes retningen, men ligger intet i sporet (kurve ind til markøren), accepteres kun en trigger inden for 12 m.
• Kun fremme ved markøren (v1.4): rotationen skjules først når målet er nået — undervejs ruller vognen gennem nabosiloers triggere, og dér skal AutoDrive køre videre ved tom trigger.
• Sikkerhedsventil (v1.4): 30 s ved markøren uden at vognen fyldes → grebet slippes (advarsel i log), og AutoDrive kører videre som med almindelig rotation.
• Står og læsser (v1.2): med rotation + mapper afslutter AutoDrive normalt pålæsningen i det øjeblik markøren nås (læsning skal være startet på vej ind, ellers kører den tom videre). Når moden har valgt siloen, ser AutoDrive under LoadAtDestinationTask.update rotationen som slået fra for netop det køretøj, så den holder ved markøren og læsser som uden rotation. Løber kilden tør, slippes grebet og turen fortsætter med det der er i vognen.

Begrænsninger: AD læsser fuld vogn — er der mindre plads i målet end ét læs, venter traktoren ved aflæsning. Målet skal være en placeable med aflæsningstrigger (ikke en blandevogn).

Test: luajit tests/test_adSupplyPlanner.lua && luajit tests/test_adSmartPickup.lua Byg: cd FS25_ADSmartPickup && zip -qr ../FS25_ADSmartPickup.zip . Design/plan: docs/superpowers/