TerraLine GPS v0.9.11.0 - PATCHPUNK BETA (PC)
Farming Simulator 25 | Developer: PatchPunk
Contact: patchpunk@mail.de

ABOUT TERRALINE GPS
Free A/B guidance and automatic steering assistance for straight,
parallel GPS lanes in Farming Simulator 25 on PC.

FEATURES AND DEVELOPMENT STATUS (2026-10-19)
- Improved Singleplayer GPS activation and initial lane acquisition,
  checking the vehicle position and heading before enabling steering.
- Predictive singleplayer lane capture from the yellow work-width boundary,
  successfully tested at 15, 20 and up to approximately 29.4 km/h.
- Native FS25 GPS engage/disengage sounds through vehicle-provided samples;
  both sounds confirmed audible in-game.
- Fine rotation of existing A/B courses around the current tractor center
  in 0.1-degree increments, with accelerating repeat when held.
- After placing A, a WHITE DASHED 25 m forward heading preview appears;
  it is automatically replaced by the normal red/green center guide and
  yellow work-width edges when point B is placed.
- Guidance lines extend 40 m forward and 40 m backward.
- Restored cockpit visibility of the GPS guidance lines.
- Colored 3D guidance bands with adjustable height and width.
- Updated in-game controls/help on menu page 4.

FEATURES
- Place A and B separately, with at least 20 m between the points.
- Straight, parallel lanes with GPS steering assistance.
- Shift the current course laterally; fine-tune its angle.
- Name, save, load and delete farm-specific GPS courses.
- Configure implement work width and GPS-line visuals.
- GPS status indicator next to the native GIANTS speedometer.
- Optional TerraLine equipment for supported vehicles: +EUR 10,000
  in the regular shop; workshop retrofit/change support.

DEFAULT CONTROLS (rebindable in FS25)
Alt+T            Toggle TerraLine main power
Alt+B            Set A, then set B
Alt+X            Tap: toggle GPS steering; hold ~3 s: rename closest lane as
                 lane 1 locally (additional function)
Alt+M            Open/close TerraLine menu
Right Alt+W      Toggle fine angle mode while stopped
Alt+J / Alt+N    +/- 0.1 degrees around the tractor center in angle mode;
                 hold to accelerate
Alt+R            Existing 90-degree rotation
Alt+Page Up/Down Shift the guidance course laterally

HOW TO USE
1. Switch TerraLine on (Alt+T), then set A (Alt+B).
2. Follow the dashed white 25 m forward preview and travel at least
   20 m from A. Press Alt+B again to set B.
3. The white preview vanishes; red center and yellow boundary lines
   appear. Center line turns green when steering is enabled.
4. While stopped, toggle angle mode (Right Alt+W), adjust with J/N,
   and activate steering with Alt+X once properly aligned.

DISPLAY
- Red/green center and yellow left/right work-width edges.
- 40 m ahead and 40 m behind once A/B is complete.
- Height 0.10–4.00 m (0.25 m steps), thickness 0.00–0.30 m
  (0.05 m steps), with line-appearance shortcuts/presets.
- Near-cab exclusion prevents lines cutting through the cab.
- Display preferences are stored in the savegame.

BETA LIMITATIONS
- Steering disengages above 30 km/h; no added speed tolerance.
- Predictive lane capture is available in singleplayer up to 30 km/h;
  normal safety limits for heading, offset and manual steering remain.
  Successful tests were logged up to approx. 29.4 km/h. Exactly 30.0 km/h,
  engaging directly at 30 km/h and other vehicles are not fully verified.
- Rotate the course only when stopped (maximum 2 km/h).
- Manual steering or unsafe deviation can disengage GPS.
- Straight A/B courses only; contour courses are not supported.
- A previous dedicated-server test with one client was reported as
  successful. Concurrent two-player and player-hosted multiplayer,
  and the new changes in multiplayer, are NOT confirmed.
- Developer diagnostics are off by default.
- Not an official GIANTS product. No paid downloads.

INSTALLATION
1. Back up your savegame.
2. Remove older TerraLine GPS ZIPs and extracted folders.
3. Copy FS25_TerraLineGPS_Beta.zip into the FS25 mods folder without
   extracting it.
4. Use matching TerraLine versions on servers and all clients.

SUPPORT
patchpunk@mail.de
Include game version, mod version, reproduction steps and log.txt.
This is the v0.9.11.0 FBM release candidate based on the tested
0.9.10.0 code, not yet published. A final in-game regression test
of the repackaged ZIP remains outstanding before publication.


ADDITIONAL FEATURE: LANE DISPLAY RENUMBERING (since 15 Oct 2026)
Short Alt+X: toggle GPS steering (on key release).
Hold Alt+X ~3 seconds: label the currently nearest lane as LANE 1.
A/B geometry, saved courses and safety checks remain unchanged.
Steering still selects the geometrically nearest parallel lane, subject to safety checks.
Display numbering is local/session-only, and not persisted.
A separate complete functional test has not yet been documented.
