# AD Smart Pickup (FS25_ADSmartPickup)

Tillæg til **AutoDrive** i Farming Simulator 25. Du fortæller, hvad der skal køres hvorhen, og moden
styrer dine AutoDrive-traktorer tur for tur. Markarbejdet kører med Courseplay på marken.
Alt sættes op i menuen **Smart Pickup** i ESC-menuen.

*English summary below.*

## Hvad moden gør

- **Forsyning:** holder stalde og fabrikker fyldt. Hver tur henter den vare, målet mangler mest, fra
  den bedste silo på kortet.
- **Udkørsel:** tømmer fabrikker, stalde, siloer og palleskure. Varerne køres til lager eller sælges, når
  prisen er tæt på årets top, uden at sælge det, gården selv skal bruge.
- **Flows:** en navngivet opskrift med bygninger, varer, regler og traktorer. Flows sættes op i en guide og
  startes eller stoppes samlet fra en farvet liste.
- **Flow-vogne og maskinpulje:** en traktor uden vogn kan selv hente sin vogn ved en Connect-markør og
  sætte den på plads igen. Frakoblede redskaber og ledige traktorer bruges som en fælles pulje.
- **Markarbejde:** slåning, høst, klargøring, såning og pleje på alle marker. AutoDrive kører på vejen,
  og Courseplay arbejder på marken.
- **Marksiloer:** varer i marksiloer køres automatisk hjem til gårdens lagre.
- **Lagerfaner:** beholdning, værdi og forbrug pr. vare og bygning. Listen "Kræver handling" opretter
  det flow, der løser problemet.
- **Stop alt og parkér:** stopper alt, folder redskaberne sammen og parkerer maskinerne. Pausen gemmes
  med savegamet.

## Download og installation

1. Hent `FS25_ADSmartPickup.zip` under [Releases](https://git.powerdata.dk/masterdraco/fs25-adsmartpickup/releases).
2. Læg zip-filen (ikke udpakket) i `Documents/My Games/FarmingSimulator2025/mods/`.
3. Aktivér moden sammen med AutoDrive, når du vælger savegame. Menuen **Smart Pickup** ligger i
   ESC-menuen lige over Indstillinger.

## Krav

- **FS25_AutoDrive** (påkrævet) og et AutoDrive-vejnet mellem bygningerne.
- **Courseplay** anbefales. Det er nødvendigt for markarbejdet.
- **Universal Autoload** anbefales på vogne, der skal køre paller.

## Dokumentation

- Brugermanual: [dansk](docs/BRUGERMANUAL.md) · [English](docs/USER_MANUAL.md)
- Ændringer pr. version: [CHANGELOG.md](CHANGELOG.md)

## Feedback

Fejl og idéer: opret et issue her i repoet. Vedlæg gerne `log.txt` fra
`Documents/My Games/FarmingSimulator2025/`, eller i det mindste linjerne der starter med `ADSmartPickup`.

## Udvikling

- Mod-koden ligger i `FS25_ADSmartPickup/`, og testene ligger i `tests/` (ren Lua, kører uden spillet).
- Kør testene:

  ```sh
  for t in tests/test_*.lua; do luajit $t >/dev/null 2>&1 || echo FAIL $t; done
  ```

- Byg zip: `cd FS25_ADSmartPickup && zip -qr ../FS25_ADSmartPickup.zip .`

---

## English summary

**AD Smart Pickup** is an add-on for **AutoDrive** in Farming Simulator 25. You tell it what goes where,
and it drives your AutoDrive tractors trip by trip. Field work runs with Courseplay on the field. Everything
is set up in the **Smart Pickup** menu in the ESC menu.

**Features**

- **Supply:** keeps barns and factories filled. Each trip fetches the good the target lacks most, from
  the best silo on the map.
- **Outbound:** empties factories, barns, silos and pallet sheds. Goods are stored or sold near the
  yearly top price, and the mod never sells what the farm needs itself.
- **Flows:** a named recipe of buildings, goods, rules and tractors. You set flows up in a guide and
  start or stop them from a colour-coded list.
- **Flow trailers and machine pool:** a tractor without a trailer can fetch its trailer at a Connect
  marker and park it again. Detached implements and free tractors form a shared pool.
- **Field work:** mowing, harvesting, preparation, sowing and crop care on every field. AutoDrive
  drives the roads and Courseplay works the field.
- **Field silos:** goods in field silos are brought home to the farm's storages automatically.
- **Storage tabs:** stock, value and consumption per good and building. The "Needs attention" list
  creates the flow that fixes the problem.
- **Stop all and park:** stops everything, folds implements and parks the machines. The pause is saved
  with the savegame.

**Install:** download `FS25_ADSmartPickup.zip` from
[Releases](https://git.powerdata.dk/masterdraco/fs25-adsmartpickup/releases). Put the zip, not unpacked,
in `Documents/My Games/FarmingSimulator2025/mods/`.

**Requirements:** AutoDrive is required. Courseplay is needed for field work, and Universal Autoload is
needed for pallets.

**Docs:** [User manual](docs/USER_MANUAL.md) · [Danish manual](docs/BRUGERMANUAL.md) ·
[Changelog](CHANGELOG.md)

**Feedback:** open an issue in this repository. Attach `log.txt`, or at least the lines starting with
`ADSmartPickup`.