2.0.19-beta

FS25_HelperProfiles v2.0.19-beta

Highlights

• Promotes the XML appearance binding interface to beta.
• Keeps the existing HelperProfiles worker selection/runtime logic intact.
• Adds basegame-style XML dialog for AvatarSwitcher appearance bindings.
• Uses Bind terminology instead of Apply.
• Updates the binding list immediately after Bind, Clear, or Clear All, before saving.
• Fixes stale display names after unbinding persisted slots.
• Standardises default keybinds:
  • ; cycles workers
  • SHIFT + ; toggles hpMode
  • RCTRL + ; opens the appearance binding interface
  • RALT + ; toggles the overlay
• Suppresses the plain semicolon cycle action while Shift, Ctrl, or Alt chords are held.
• Retains the legacy appearance HUD/menu as a fallback.

Notes

Existing FS25 input binding overrides may continue to use locally saved controls. Reset the HelperProfiles bindings in the in-game controls menu if the defaults do not appear immediately.

1.1.0.2

Includes the option to switch between PreferredSelected and FirstFree modes via the console.

1.1.0.1

Fixed spammy errors caused by trying to bind vehicle-context actions before a valid action-event table exists (or binding them over and over without clearing) in RegisterPlayerActionEvents.lua:

2025-10-09 22:32:47.523 [FS25_HelperProfiles] ❌ Failed to register OPEN_HELPER_MENU in context _vehicleActionEventId
2025-10-09 22:32:47.523 [FS25_HelperProfiles] ❌ Failed to register HP_TOGGLE_OVERLAY (vehicle)

1.1.0.0

Version: 1.1.0.0

Highlights: FS25-styled helper overlay, HUD binding, external config.xml, robust console commands, per-context keybinds, debounce to prevent double-advances.

Added: Overlay panel showing Selected (» sel) and Next (← next) helpers.

Added: modSettings/FS25_HelperProfiles/config.xml with save / load / reset.

Added: HP_TOGGLE_OVERLAY action (bindable in Controls → MISC).

Added: hpOverlay console suite (pos/anchor/width/scale/font/rowgap/maxrows/pad/opacity/bg/outline/markers/bindhud/debounce).

Improved: Debounced selection cycling to prevent double-step on ;.

Improved: Overlay can follow base HUD visibility (HideHUD support).

Fixed: Console arg parsing across different console call patterns.

1.0.0.1

Helper Profiles v1.0.0.1 — “Cycle & Hire (Safe Hook)”

TL;DR: Minimal, conflict-friendly release that lets you cycle the next AI helper (default ;) and biases hiring to your selection. No save edits, no appearance overrides.

Highlights

• New: Cycle Helper action (default: semicolon ;) works on foot and in vehicles.
• Smart hire preference: When you press H, the game prefers your selected free helper; falls back safely if busy/unavailable.
• Non-destructive hooks: Wraps HelperManager methods without replacing base data or XML.
• Clean structure: Lua moved to scripts/; modDesc.xml updated accordingly.
• Helpful toasts & logs: Small HUD toast when cycling; clear log lines for troubleshooting.

Changes

• Relocated files to scripts/:

  • scripts/HelperProfiles.lua
  • scripts/RegisterPlayerActionEvents.lua

• Updated modDesc.xml (sources + input action; default binding remains ;).

• Added dual-context action registration (player + vehicle).

Compatibility & Safety

• Designed to play nicely with other mods (runtime hooks, no save writes).
• If another mod replaces HelperManager methods outright, the last hook may win.
• No changes to wages, behaviour, or appearances.

Known Limitations (by design, for now)

• No persistent names/avatars or appearance overrides in this build.
• No in-game picker UI yet (cycling only).

Install / Update

1. Drop FS25_HelperProfiles.zip into your mods folder.
2. Enable Helper Profiles on your save.
3. Press ; to cycle, H to hire.
   (Check log.txt for [FS25_HelperProfiles] Hooked … lines.)

Verification (quick)

• Look for a toast like Helper: Alex (3/12) when pressing ;.
• In log.txt, confirm hook lines for getNextHelper, getFreeHelper, getRandomHelper, hireHelper.

---

1.0.0.0

Latest

Update README.md