Release classic 4.2.1 hotfix for FS 1.21 copyFile log spam.

Stamp classic mod zips as 3.4.0.7 without changing the RF working-tree modDesc, and refresh plain-English update notes for GitHub/itch.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: WizardlyPayload

FS25_FarmDashboard_App/package.json

@@ -1,13 +1,13 @@
 {
   "name": "fs25-farm-dashboard",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "license": "SEE LICENSE IN LICENSE",
   "description": "Real-time Farm Management Dashboard for FS25",
   "author": "JoshWalki / Wizardlypayload & WizardlyPayload",
   "main": "main.js",
   "scripts": {
     "test": "jest",
-    "test:mjs": "node --test tests/baleInventory.test.mjs tests/rules-engine-roll-weed.test.mjs tests/vehicleAds.breakdown.test.mjs tests/fieldGrassMown.test.mjs tests/vehicleStoreImage.test.mjs tests/vehicleFarmScope.test.mjs tests/storageEconomy.test.mjs tests/navbarConnectionBadge.test.mjs tests/livestock.fmtAge.test.mjs",
+    "test:mjs": "node --test tests/*.test.mjs",
     "test:all": "npm test && npm run test:mjs",
     "parity": "node ../tools/app/parity.js",
     "export-fields-csv": "node ../tools/app/export-fields-to-csv.mjs",
@@ -17,11 +17,15 @@
     "clean:build-out:search": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File ../tools/app/remove-build-output-folders.ps1 -StopWindowsSearch",
     "start": "electron .",
     "start:dev": "node ../tools/app/start-dev-electron.mjs",
+    "start:dev:sync": "node ../tools/app/start-dev-electron.mjs --sync-config",
+    "start:new-ui": "node ../tools/app/start-dev-electron.mjs --sync-config",
     "pack": "node ../tools/app/run-electron-builder.mjs pack",
+    "pack:rf": "node ../tools/app/run-electron-builder.mjs pack --rf",
     "pack:in-repo": "electron-builder --dir",
     "pack:fresh": "node ../tools/app/electron-builder-fresh-output.mjs pack",
     "pack:alt": "electron-builder --dir --config.directories.output=electron-pack-out-alt",
     "dist": "node ../tools/app/run-electron-builder.mjs dist",
+    "dist:rf": "node ../tools/app/run-electron-builder.mjs dist --rf",
     "dist:in-repo": "electron-builder --win",
     "dist:fresh": "node ../tools/app/electron-builder-fresh-output.mjs dist",
     "dist:alt": "electron-builder --win --config.directories.output=electron-pack-out-alt",
@@ -34,7 +38,10 @@
     "i18n:sync": "node web/locales/sync-keys-from-en.mjs",
     "i18n:refresh": "node web/locales/sync-keys-from-en.mjs && node web/locales/mt-fill.mjs && node web/locales/build-translations.mjs && node web/locales/verify-i18n.mjs",
     "i18n:ads": "node ../tools/app/extract-ads-i18n.mjs",
-    "verify:electron-pack": "node ../tools/app/verify-electron-pack-files.mjs"
+    "verify:electron-pack": "node ../tools/app/verify-electron-pack-files.mjs",
+    "copy:ui-v2": "node ../tools/app/copy-ui-v2.mjs",
+    "prepack": "node ../tools/app/copy-ui-v2.mjs",
+    "predist": "node ../tools/app/copy-ui-v2.mjs"
   },
   "build": {
     "appId": "com.farmdashboard.app",
@@ -68,6 +75,7 @@
       "setup.html",
       "icon.ico",
       "web/**/*",
+      "ui-v2/**/*",
       "node_modules/**/*"
     ],
     "extraResources": [

FS25_FarmDashboard_Mod/src/FarmDashboardDataCollector.lua

@@ -308,7 +308,7 @@ end
 --   * getFiles requires 3 args: getFiles(directory, patternString, recursiveBool).
 --     (Passing bool as arg2 yields "Expected: String. Actual: Bool".)
 --   * io.open is often sandboxed to mode "w" only — avoid "r"/"rb" (use readFile if present).
---   * copyFile requires 3 args on FS25 — try bool then numeric overloads best-effort.
+--   * copyFile(src, dst, forceOverwrite: Bool) — Bool only; never Number 1/0.
 --   * `os` may be nil — os.rename unavailable; use copy/delete or direct write.
 -- =====================================================================================
 
@@ -432,15 +432,16 @@ local COROUTINE_INCREMENTAL_COLLECTORS = {
     production = true,
 }
 
+--- copyFile(src, dst, forceOverwrite: Bool). Never pass Number 1/0 — engine type-checks
+--- arg3 as Bool even inside pcall, and wrong-type trials flood the script log every cycle.
 local function _copyFileFs25BestEffort(src, dst)
     if type(copyFile) ~= "function" or type(src) ~= "string" or type(dst) ~= "string" then
         return false
     end
+    -- forceOverwrite true first; false only if dest already exists and true did not stick.
     local trials = {
         function() copyFile(src, dst, true) end,
         function() copyFile(src, dst, false) end,
-        function() copyFile(src, dst, 1) end,
-        function() copyFile(src, dst, 0) end,
     }
     for _, fn in ipairs(trials) do
         local ok = pcall(fn)
@@ -523,6 +524,15 @@ function FarmDashboardDataCollector:_exportMapOverviewForDashboard()
             return
         end
     end
+
+    -- Latch failure so we never retry every export cycle (log spam / hitch). Optional asset.
+    self._mapOverviewExportDone = true
+    if type(Logging) == "table" and type(Logging.warning) == "function" then
+        Logging.warning(string.format(
+            "[FarmDash] map overview export failed once for %s (fleet map may lack overview.dds); not retrying",
+            tostring(key)
+        ))
+    end
 end
 
 --- Cap for read/write fallback when rename/copy fail (atomic write recovery only). Bounds hitch vs huge tmp→final copies.

README.md

@@ -10,10 +10,10 @@ Real-time farm management dashboard for **Farming Simulator 25** — a Windows d
 
 | Download from Releases | Version |
 |------------------------|---------|
-| **`FS25-Farm-Dashboard-Setup-4.2.0.exe`** | Windows app |
+| **`FS25-Farm-Dashboard-Setup-4.2.1.exe`** | Windows app |
 | **`FS25_FarmDashboard.zip`** | FS25 mod |
 
-**Current stable line:** App **4.2.0** · Mod **3.4.0.6**
+**Current stable line (classic):** App **4.2.1** · Mod **3.4.0.7** — hotfix for Farming Simulator 1.21 copyFile log spam (see [release notes](docs/GITHUB_RELEASE_v4.2.1.md)).
 
 Install **mod first**, load your save once, then install the app. See **[docs/INSTALL.md](docs/INSTALL.md)** (detailed) or the quick steps below.
 
@@ -28,9 +28,9 @@ Open the dashboard at **[http://localhost:8766](http://localhost:8766)** after s
 | | |
 | --- | --- |
 | **Home** | **Fields** |
-| ![Farm Management Dashboard landing](docs/screenshots/fd-shell-020-landing.png) | ![Fields section with summary and cards](docs/screenshots/fd-section-fields-010-summary.png) |
+| ![Farm Management Dashboard landing](docs/doc-screenshots/fd-shell-020-landing.png) | ![Fields section with summary and cards](docs/doc-screenshots/fd-section-fields-010-summary.png) |
 | **Livestock** | **Productions** |
-| ![Livestock summary and animals table](docs/screenshots/fd-section-livestock-010-summary.png) | ![Productions storage and chains](docs/screenshots/fd-section-productions-010-list.png) |
+| ![Livestock summary and animals table](docs/doc-screenshots/fd-section-livestock-010-summary.png) | ![Productions storage and chains](docs/doc-screenshots/fd-section-productions-010-list.png) |
 
 More UI shots and install screenshots: **[docs/USER_MANUAL.md](docs/USER_MANUAL.md)** · capture checklist: **[docs/SCREENSHOTS.md](docs/SCREENSHOTS.md)**
 
@@ -39,7 +39,7 @@ More UI shots and install screenshots: **[docs/USER_MANUAL.md](docs/USER_MANUAL.
 ## Quick install
 
 1. **Mod** — Put **`FS25_FarmDashboard.zip`** in `Documents\My Games\FarmingSimulator2025\mods\`, enable on your save, **load the save once**.
-2. **App** — Run **`FS25-Farm-Dashboard-Setup-4.2.0.exe`** from [Releases](https://github.com/WizardlyPayload/FarmHub/releases).
+2. **App** — Run **`FS25-Farm-Dashboard-Setup-4.2.1.exe`** from [Releases](https://github.com/WizardlyPayload/FarmHub/releases).
 3. **Configure** — **Settings → Servers & saves** (local path or FTP for dedicated servers).
 
 **Full guide:** [docs/USER_MANUAL.md](docs/USER_MANUAL.md) · **Install (detailed):** [docs/INSTALL.md](docs/INSTALL.md) · [GitHub Wiki](https://github.com/WizardlyPayload/FarmHub/wiki)
@@ -54,30 +54,31 @@ This repository (**[FarmHub](https://github.com/WizardlyPayload/FarmHub)**) is *
 |---------|------------|
 | **[JoshWalki / FarmDashboard](https://github.com/JoshWalki/FarmDashboard)** | Original FS25 mod + web dashboard (**Josh Walki**) |
 | **[WizardlyPayload / FS25-Farm-Dashboard](https://github.com/WizardlyPayload/FS25-Farm-Dashboard/releases)** | Public **2.0.0** release — Electron desktop fork of Josh’s work |
-| **[WizardlyPayload / FarmHub](https://github.com/WizardlyPayload/FarmHub/releases)** *(this repo)* | **4.2.0** line — fleet map, storage, FTP/multi-server, rules engine, auto-update |
+| **[WizardlyPayload / FarmHub](https://github.com/WizardlyPayload/FarmHub/releases)** *(this repo)* | **4.2.1** classic line — fleet map, storage, FTP/multi-server, rules engine, auto-update |
 
 **Coming from 2.0.0 or Josh’s repo?** See **[docs/UPGRADE_FROM_FS25-Farm-Dashboard.md](docs/UPGRADE_FROM_FS25-Farm-Dashboard.md)** for what changed.
 
 **Authors:** **[JoshWalki](https://github.com/JoshWalki)** (Josh) — original concept & FS25 mod · **WizardlyPayload** — Electron app, maintenance, releases · [docs/AUTHORS.md](docs/AUTHORS.md)
 
 ---
 
-## What you get in 4.2.0
+## What you get in 4.2.1
 
 - **Live dashboard** — livestock, pastures, vehicles, fields, economy, productions, weather (port **8766**).
 - **Fleet map** — live vehicle pins on the save's PDA overview map.
 - **Storage** — silo stock with **moisture & grade**, correct names for mod-map and base-map commodities (incl. **Pig Food** and other sparse fill types); bale categories.
 - **Fleet scope** — dealership showroom demos no longer clutter player farms on dedicated multiplayer saves.
 - **Livestock** — base-game cow pens, food-duration hints, urgent pasture alerts.
 - **Productions** — map-owned factories on base maps; two-column layout.
-- **Accurate equipment pictures** — authoritative store-icon matching (app **4.2.0** + mod **3.4.0.6**).
+- **Accurate equipment pictures** — authoritative store-icon matching (app **4.2.1** + mod **3.4.0.7**).
+- **FS 1.21 copyFile hotfix** — stops repeated map-overview copy errors in the game log after the 1.21 update.
 - **Local + FTP** — single-player / LAN host on disk, or dedicated server over FTP.
 - **Offline field rules** — suggested next steps from merged game data (no cloud service).
 - **Optional integrations** — Precision Farming, Advanced Damage System, Moisture System, Red Tape, Realistic Livestock RM, Vehicle Years; Courseplay and Used Equipment Yards tested alongside — [full mod list](docs/GITHUB_RELEASE_v4.2.0.md#third-party-mods).
 - **27 languages**, themes, unified Settings.
 - **Auto-update** (Windows app) and **mod version badge** when the in-game mod is behind.
 
-**Release notes:** [docs/GITHUB_RELEASE_v4.2.0.md](docs/GITHUB_RELEASE_v4.2.0.md) · **History:** [docs/CHANGELOG.md](docs/CHANGELOG.md)
+**Release notes:** [docs/GITHUB_RELEASE_v4.2.1.md](docs/GITHUB_RELEASE_v4.2.1.md) · **History:** [docs/CHANGELOG.md](docs/CHANGELOG.md)
 
 ---
 

docs/CHANGELOG.md

@@ -1,19 +1,45 @@
-# Farm Dashboard — Changelog
+# Farm Dashboard — Changelog
 
-All notable changes to this project are recorded here. For GitHub release blurbs, see [GITHUB_RELEASE_v4.2.0.md](./GITHUB_RELEASE_v4.2.0.md) (current) · [GITHUB_RELEASE_v4.1.5.md](./GITHUB_RELEASE_v4.1.5.md) · [GITHUB_RELEASE_v4.1.0.md](./GITHUB_RELEASE_v4.1.0.md). For **network exposure and trust assumptions**, see [SECURITY.md](./SECURITY.md).
+All notable changes to this project are recorded here. For GitHub release blurbs, see [GITHUB_RELEASE_v4.2.1.md](./GITHUB_RELEASE_v4.2.1.md) (current classic) · [GITHUB_RELEASE_v4.2.0.md](./GITHUB_RELEASE_v4.2.0.md) · [GITHUB_RELEASE_v4.1.5.md](./GITHUB_RELEASE_v4.1.5.md). For **network exposure and trust assumptions**, see [SECURITY.md](./SECURITY.md). Classic vs RF product lines: [COMPATIBILITY.md](./COMPATIBILITY.md).
 
 ---
 
 ## Versioning
 
 | Artifact | Where it lives | Format |
 |----------|----------------|--------|
-| **Desktop app** | `FS25_FarmDashboard_App/package.json` | Semver (e.g. `4.2.0`) |
-| **FS25 mod** | `FS25_FarmDashboard_Mod/modDesc.xml` and `FarmDashboard.VERSION` in Lua | Giants style (e.g. `3.4.0.6`) |
+| **Desktop app** | `FS25_FarmDashboard_App/package.json` | Semver (e.g. `4.2.1`) |
+| **FS25 mod (classic public zip)** | Stamped at pack time via `npm run package:mod:classic` → **3.4.0.7** | Giants style |
+| **FS25 mod (RF / local tree)** | `FS25_FarmDashboard_Mod/modDesc.xml` + `FarmDashboard.VERSION` | e.g. `5.0.0.1` RF edition |
 | **Source headers** | First line of many `.js` / `.lua` files | Often `v2.0.0` historically; bump only when you intentionally resync headers |
 
 ---
 
+
+## 4.2.1 — FS 1.21 copyFile hotfix + join-as-client (classic patch)
+
+**App:** `4.2.1` (`package.json`) · **Classic mod zip:** `3.4.0.7` · app requires **3.1.0.0+** via `modVersionPolicy.js`.
+
+Public classic patch on the 4.2 / 3.4 line. Classic UI remains default (`useNewUi` false). This does **not** replace Realistic Farming edition 5.x (`latest-rf.yml`).
+
+### Fixed (headline)
+- **Farming Simulator 1.21 `copyFile` log spam** — After FS 1.21, the mod could flood the game log with repeated copyFile type errors while trying to save a map overview image. The copy now uses the correct yes/no (Bool) flag the engine expects, and a failed overview export is latched so it does not retry every cycle. Noisy logs / map-overview hiccup only — the game itself is not broken.
+
+### Added
+- **Dedicated join-as-client export mirror** — authority streams `data.json` to an opted-in MP client (`FarmDashboardExportEvent` / allowExportMirror); client writes local `modSettings\FS25_FarmDashboard\<slot>\data.json` for **Local** watch. **FTP remains Advanced** for empty / headless dedicated.
+- **Setup join-as-client UX** — legacy Setup guides mirror / receive-server-export for dedicated without FTP.
+
+### Fixed
+- **Track A** merge and related test hardening for the 4.2.1 release line.
+
+### Changed
+- Classic public mod zip `3.4.0.6` → `3.4.0.7` (copyFile fix + export mirror + settings). Packaged with `package:mod:classic` so the RF working-tree modDesc can stay on the 5.x line.
+- App `4.2.0` → `4.2.1`. NEW APP packaging stays **opt-in** only.
+
+### Docs
+- Install / user manual / wiki / itch copy for update steps from 4.2 / 3.4.0.6; join-as-client notes; see also [RELEASE_NOTE_JOIN_AS_CLIENT.md](./_internal/RELEASE_NOTE_JOIN_AS_CLIENT.md).
+
+---
 ## 4.2.0 — Public release (storage, livestock, productions, notifications)
 
 **App:** `4.2.0` (`package.json`) · **Mod:** `3.4.0.6` (`modDesc.xml` + `FarmDashboard.VERSION`; app requires **3.1.0.0+** via `modVersionPolicy.js`).