docs(marker): kapitel 10 Markarbejde i manualerne (da/en); version 1.21.0.0

FS25_ADSmartPickup/modDesc.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8" standalone="no"?>
 <modDesc descVersion="107">
     <author>masterdraco</author>
-    <version>1.20.0.0</version>
+    <version>1.21.0.0</version>
     <title>
         <en>AD Smart Pickup</en>
     </title>

docs/BRUGERMANUAL.md

@@ -1,6 +1,6 @@
 # AD Smart Pickup — brugermanual
 
-Version 1.20.0 · Farming Simulator 25 · tillæg til AutoDrive
+Version 1.21.0 · Farming Simulator 25 · tillæg til AutoDrive
 
 *English version: [USER_MANUAL.md](USER_MANUAL.md)*
 
@@ -28,9 +28,10 @@ Moden kan to ting:
 7. [Traktorer og vogne](#7-traktorer-og-vogne)
 8. [Start, stop og gemning](#8-start-stop-og-gemning)
 9. [Lagerfanerne: beholdning og statistik](#9-lagerfanerne-beholdning-og-statistik)
-10. [Opskrifter](#10-opskrifter)
+10. [Markarbejde: græs, kløver og lucerne](#10-markarbejde-græs-kløver-og-lucerne)
-11. [Fejlfinding](#11-fejlfinding)
+11. [Opskrifter](#11-opskrifter)
-12. [Ordliste](#12-ordliste)
+12. [Fejlfinding](#12-fejlfinding)
+13. [Ordliste](#13-ordliste)
 
 ---
 
@@ -120,12 +121,13 @@ som er 25 m som standard. Står siloerne tættere, kan nabosiloen få læsset. S
 
 ## 4. Menuen Smart Pickup
 
-Tryk **ESC** og vælg fanen **Smart Pickup**. Fanen har seks underfaner:
+Tryk **ESC** og vælg fanen **Smart Pickup**. Fanen har syv underfaner:
 
 | Fane | Indhold |
 |---|---|
 | **Overblik** | Tabel over alle flows og Wait-puljerne |
 | **Flows** | Redigering af det valgte flow |
+| **Marker** | Markarbejde på græs-, kløver- og lucernemarker (kapitel 10) |
 | **Fabrikker** | Beholdning og statistik for gårdens fabrikker |
 | **Siloer** | Beholdning og statistik for gårdens siloer |
 | **Stalde** | Beholdning og statistik for gårdens stalde |
@@ -521,7 +523,79 @@ Varer, der ikke bruges på gården, har en streg under **Rækker til**. Varer ud
 
 ---
 
-## 10. Opskrifter
+## 10. Markarbejde: græs, kløver og lucerne
+
+Fanen **Marker** sender selv maskinerne ud til gårdens slåafgrøder (græs, kløver og lucerne).
+AutoDrive kører på vejen, Courseplay arbejder på marken, og Smart Pickup bestemmer hvilken mark,
+hvilket trin og hvilken maskine. Kræver **Courseplay** ud over AutoDrive.
+
+| Plan | Trin |
+|---|---|
+| **Ensilage** | Slås → Samles op → silo |
+| **Hø** | Slås → Vendes → (Rives) → Samles op → silo |
+
+### Opsætning
+
+1. **En markør pr. mark.** Lav en AutoDrive-markør ved markkanten med navnet `F` + marknummeret,
+   fx `F109` for mark 109. Maskinerne kører dertil ad vejen, før Courseplay tager over. Markøren
+   må højst ligge 400 m fra marken. Mangler den, står marken med `!` og sendes ikke ud.
+2. **Faste sæt.** Redskabet skal sidde på traktoren (eller være selvkørende). Moden kobler aldrig
+   redskaber på.
+3. **Markflåde.** Nederst på fanen står alle køretøjer med slåmaskine, vender, river eller læssevogn
+   med rolle og aktuel arbejdsbredde. Sæt flueben ved dem, moden må sende ud. Køretøjer i et flow,
+   og køretøjer du selv sidder i, bliver aldrig brugt.
+4. **Parkering.** Sæt en AutoDrive-parkeringsplads på hvert sæt. Når et sæt er færdigt på marken,
+   kører det dertil. Uden parkering bliver det stående ved marken.
+
+### Bredde
+
+- Courseplay kan højst køre **50 m** bredt. Et sæt over 50 m sendes ikke ud (`!! over 50 m` i
+  markflåden).
+- Moden husker, hvor bredt marken blev **slået**. Vender, river og læssevogn skal være **mindst lige
+  så brede**, så hver bane dækker det, slåmaskinen lagde. Med Unrealistic Pack: sæt slåmaskinen og
+  læssevognene til samme bredde, fx 40,8 m.
+
+### En mark
+
+Klik på en mark i tabellen for at vælge den. Under tabellen står:
+
+| Valg | Betydning |
+|---|---|
+| **Plan** | Ensilage eller Hø |
+| **Kørsel** | *Manuel*: marken venter på **Start nu**. *Auto*: marken starter selv, når den er klar |
+| **Riv** | Kun ved hø: riv høet sammen før opsamling. Standard fra, fordi brede læssevogne samler spredt hø |
+| **Tving lager** | Vælg siloer. Uden valg bruges nærmeste silo med plads, der tager varen |
+
+En mark er **klar**, når mindst 90 % af den står i høstvinduet. Status viser andelen, fx `Venter 72 %`.
+**Start nu** virker fra 50 %. **Stop mark** stopper maskinerne på marken, og marken står klar igen.
+
+**Marksilo:** en silo højst 150 m fra marken er et mellemlager med korte ture. Moden viser
+`! Marksilo … tømmes ikke hjem`, hvis intet *Ud fra bygning*-flow har den som kilde. Lav et sådant
+flow for at få ensilagen hjem på gården.
+
+### Status og grunde
+
+| Status | Betyder |
+|---|---|
+| **Venter / Klar** | Marken vokser / er klar (Manuel venter på Start nu) |
+| **Slås, Vendes, Rives, Samles op** | Trinnet er i gang |
+| **Færdig** | Alle trin er færdige. Marken bliver *Klar* igen, når den er vokset |
+| `venter på ledig slåmaskine` | Alle sæt med rollen er optaget |
+| `læssevogn for smal: 20 m < slåbredde 40,8 m` | Sæt læssevognens bredde op |
+| `Courseplay kunne ikke lave kursus` | Nyt forsøg efter 5 minutter |
+
+Loglinjerne i `log.txt` begynder med `ADSmartPickup: F109 …`.
+
+### Første test
+
+1. Sæt én græsmark til **Manuel** og **Ensilage**, med `F`-markør og én slåmaskine og én
+   læssevogn med flueben.
+2. Tryk **Start nu**. Slåmaskinen kører til markøren, Courseplay slår marken, og sættet kører hjem.
+3. Læssevognen kører ud. Når den er fuld, tømmer AutoDrive den i siloen og kører tilbage, og
+   Courseplay fortsætter. Marken står **Færdig**.
+4. Prøv derefter **Hø** og til sidst **Auto**.
+
+## 11. Opskrifter
 
 ### Hold en kostald fodret
 
@@ -555,7 +629,7 @@ Tankvognen venter ved Wait, til prisen er høj. Løber tanken fuld før, kører
 
 ---
 
-## 11. Fejlfinding
+## 12. Fejlfinding
 
 Moden skriver alle beslutninger i `log.txt` med forstavelsen `ADSmartPickup:`. Loggen ligger i
 `Documents/My Games/FarmingSimulator2025/`.
@@ -584,7 +658,7 @@ ADSmartPickup: 'Fastrac' genoptager ventning ved Cow Wait efter genindlæsning
 
 ---
 
-## 12. Ordliste
+## 13. Ordliste
 
 | Ord | Betydning |
 |---|---|

docs/USER_MANUAL.md

@@ -1,6 +1,6 @@
 # AD Smart Pickup — user manual
 
-Version 1.20.0 · Farming Simulator 25 · add-on for AutoDrive
+Version 1.21.0 · Farming Simulator 25 · add-on for AutoDrive
 
 *Dansk version: [BRUGERMANUAL.md](BRUGERMANUAL.md)*
 
@@ -28,9 +28,10 @@ The mod does two things:
 7. [Tractors and trailers](#7-tractors-and-trailers)
 8. [Start, stop and saving](#8-start-stop-and-saving)
 9. [The storage tabs: inventory and statistics](#9-the-storage-tabs-inventory-and-statistics)
-10. [Recipes](#10-recipes)
+10. [Field work: grass, clover and alfalfa](#10-field-work-grass-clover-and-alfalfa)
-11. [Troubleshooting](#11-troubleshooting)
+11. [Recipes](#11-recipes)
-12. [Glossary](#12-glossary)
+12. [Troubleshooting](#12-troubleshooting)
+13. [Glossary](#13-glossary)
 
 ---
 
@@ -122,12 +123,13 @@ storage target with a neighbouring trigger.
 
 ## 4. The Smart Pickup menu
 
-Press **ESC** and open the **Smart Pickup** tab. It has six sub-tabs:
+Press **ESC** and open the **Smart Pickup** tab. It has seven sub-tabs:
 
 | Tab | Contents |
 |---|---|
 | **Overview** | A table of all flows and the Wait pools |
 | **Flows** | Editing of the selected flow |
+| **Fields** | Field work on grass, clover and alfalfa fields (chapter 10) |
 | **Factories** | Inventory and statistics for the farm's factories |
 | **Silos** | Inventory and statistics for the farm's silos |
 | **Barns** | Inventory and statistics for the farm's barns |
@@ -527,7 +529,81 @@ selling point*.
 
 ---
 
-## 10. Recipes
+## 10. Field work: grass, clover and alfalfa
+
+The **Fields** tab sends machines out to the farm's mowable crops (grass, clover and alfalfa) by
+itself. AutoDrive drives on the road, Courseplay works the field, and Smart Pickup decides which field,
+which step and which machine. Requires **Courseplay** in addition to AutoDrive.
+
+| Plan | Steps |
+|---|---|
+| **Silage** | Mow → Collect → silo |
+| **Hay** | Mow → Ted → (Rake) → Collect → silo |
+
+### Setup
+
+1. **One marker per field.** Create an AutoDrive marker at the field edge named `F` + the field number,
+   such as `F109` for field 109. Machines drive there on the road before Courseplay takes over. The
+   marker must be within 400 m of the field. Without it, the field shows `!` and nothing is sent.
+2. **Fixed rigs.** The implement must be attached to the tractor (or be self-propelled). The mod never
+   attaches implements.
+3. **Field fleet.** At the bottom of the tab are all vehicles with a mower, tedder, rake or loading
+   wagon, with role and current working width. Tick the ones the mod may send out. Vehicles in a flow,
+   and vehicles you are driving, are never used.
+4. **Parking.** Set an AutoDrive parking spot on each rig. When a rig is done on the field, it drives
+   there. Without parking it stays at the field.
+
+### Width
+
+- Courseplay can work at most **50 m** wide. A rig over 50 m is not sent out (`!! over 50 m` in the
+  fleet).
+- The mod remembers how wide the field was **mowed**. Tedder, rake and loading wagon must be **at least
+  as wide**, so every lane covers what the mower laid down. With Unrealistic Pack: set the mower and the
+  loading wagons to the same width, such as 40.8 m.
+
+### A field
+
+Click a field in the table to select it. Below the table:
+
+| Option | Meaning |
+|---|---|
+| **Plan** | Silage or Hay |
+| **Mode** | *Manual*: the field waits for **Start now**. *Auto*: the field starts by itself when ready |
+| **Rake** | Hay only: rake before collecting. Off by default, because wide loading wagons collect spread hay |
+| **Force storage** | Pick silos. Without a choice the nearest silo with room that takes the goods is used |
+
+A field is **ready** when at least 90 % of it is in the harvest window. The status shows the share,
+such as `Waiting 72 %`. **Start now** works from 50 %. **Stop field** stops the machines on the field,
+and the field is ready again.
+
+**Field silo:** a silo within 150 m of the field is an intermediate store with short trips. The mod
+shows `! Field silo … is not emptied home` if no *Out of building* flow has it as a source. Create such
+a flow to bring the silage home.
+
+### Status and reasons
+
+| Status | Meaning |
+|---|---|
+| **Waiting / Ready** | The field is growing / ready (Manual waits for Start now) |
+| **Mowing, Tedding, Raking, Collecting** | The step is running |
+| **Done** | All steps are done. The field becomes *Ready* again once it has grown |
+| `waiting for a free mower` | All rigs with the role are busy |
+| `loading wagon too narrow: 20 m < mowing width 40.8 m` | Increase the loading wagon's width |
+| `Courseplay could not create a course` | Retried after 5 minutes |
+
+Log lines in `log.txt` start with `ADSmartPickup: F109 …`.
+
+### First test
+
+1. Set one grass field to **Manual** and **Silage**, with an `F` marker and one mower and one loading
+   wagon ticked.
+2. Press **Start now**. The mower drives to the marker, Courseplay mows the field, and the rig drives
+   home.
+3. The loading wagon goes out. When it is full, AutoDrive empties it in the silo and drives back, and
+   Courseplay continues. The field shows **Done**.
+4. Then try **Hay**, and finally **Auto**.
+
+## 11. Recipes
 
 ### Keep a cow barn fed
 
@@ -561,7 +637,7 @@ The tanker waits at Wait until the price is high. If the tank fills up first, th
 
 ---
 
-## 11. Troubleshooting
+## 12. Troubleshooting
 
 The mod writes every decision to `log.txt` with the prefix `ADSmartPickup:`. The log is in
 `Documents/My Games/FarmingSimulator2025/`.
@@ -593,7 +669,7 @@ after the savegame was loaded.
 
 ---
 
-## 12. Glossary
+## 13. Glossary
 
 | Term | Meaning |
 |---|---|