modDesc.xml

<?xml version="1.0" encoding="utf-8"?>
<modDesc descVersion="110">
    <author>SimGamerJen</author>
    <version>2.1.0.0</version>
    <title>
        <en>Helper Profiles</en>
        <de>Helferprofile</de>
        <fr>Profils d'aides</fr>
    </title>
    <description>
        <en><![CDATA[
Helper Profiles is a single-player helper-management mod for Farming Simulator 25.

Version 2.1.0.0 expands the permanent helper identity pool from A-J to A-T and adds per-save roster availability management. Workers can be placed ON or OFF roster without deleting their appearance bindings, HelperPayroll roles, overrides, or ledger identity.

Main features:
- Autosizing helper overlay with selected, next, available, active, appearance, and optional HelperPayroll role information.
- Configurable prefer-selected and first-free hiring modes.
- Permanent A-T helper identities with stable helper01-helper20 canonical IDs.
- Per-save ON/OFF roster state stored under modSettings/FS25_HelperProfiles/saves/savegameX/roster.xml.
- OFF-roster workers are excluded from cycling, overlay selection, next-worker calculations, and hiring.
- A two-tab Helper Management screen for AvatarSwitcher appearance bindings and roster availability.
- Active-worker and at-least-one-worker safeguards.
- Optional AvatarSwitcher integration for save-specific worker appearances.
- Optional read-only HelperPayroll role display.

Known incompatibility:
Do not use HelperProfiles with Hired Helper Tool. When an incompatible external helper-roster owner is detected, HelperProfiles disables itself for the current session to prevent competing roster ownership.

Default controls:
; cycles workers.
SHIFT + ; toggles HelperProfiles hiring mode.
RCTRL + ; opens Helper Management.
RALT + ; toggles the overlay.
]]></en>
        <de><![CDATA[
Helferprofile ist ein Helfer-Verwaltungsmod für den Einzelspielermodus von Farming Simulator 25.

Version 2.1.0.0 erweitert den dauerhaften Helferpool von A-J auf A-T und fügt eine spielstandsbezogene Helferlistenverwaltung hinzu. Helfer können in die Liste aufgenommen oder daraus entfernt werden, ohne Erscheinungsbindungen, HelperPayroll-Rollen, Überschreibungen oder Ledger-Identitäten zu löschen.

Hauptfunktionen:
- Automatisch skalierendes Helfer-Overlay mit Auswahl-, Nächster-, Verfügbar-, Aktiv-, Erscheinungs- und optionalen HelperPayroll-Rolleninformationen.
- Einstellungsmodi Ausgewählten bevorzugen und Ersten freien verwenden.
- Dauerhafte A-T-Helferidentitäten mit stabilen kanonischen IDs helper01-helper20.
- Spielstandsbezogener EIN/AUS-Listenstatus unter modSettings/FS25_HelperProfiles/saves/savegameX/roster.xml.
- Helfer außerhalb der Liste werden beim Wechseln, in Overlay-Berechnungen und beim Einstellen ausgeschlossen.
- Zweireitige Helferverwaltung für AvatarSwitcher-Erscheinungsbindungen und Listenverfügbarkeit.
- Schutz aktiver Helfer und Sicherstellung, dass mindestens ein Helfer in der Liste bleibt.
- Optionale AvatarSwitcher-Integration für spielstandsbezogene Erscheinungsbilder.
- Optionale schreibgeschützte Anzeige von HelperPayroll-Rollen.

Bekannte Inkompatibilität:
HelperProfiles darf nicht zusammen mit Hired Helper Tool verwendet werden. Wird ein inkompatibler externer Besitzer der Helferliste erkannt, deaktiviert sich HelperProfiles für die aktuelle Sitzung.

Standardsteuerung:
; wechselt zwischen Helfern.
SHIFT + ; schaltet den Einstellungsmodus um.
RCTRL + ; öffnet die Helferverwaltung.
RALT + ; schaltet das Overlay ein oder aus.
]]></de>
        <fr><![CDATA[
Profils d'aides est un mod de gestion des aides pour le mode solo de Farming Simulator 25.

La version 2.1.0.0 étend le groupe permanent d'aides de A-J à A-T et ajoute une gestion de liste par sauvegarde. Une aide peut être placée dans ou hors de la liste sans supprimer son apparence, son rôle HelperPayroll, ses réglages ni son identité de registre.

Fonctions principales :
- Superposition redimensionnable affichant la sélection, la prochaine aide, l'état disponible ou actif, l'apparence et le rôle HelperPayroll facultatif.
- Modes d'embauche Préférer la sélection et Première aide libre.
- Identités permanentes A-T avec IDs canoniques stables helper01-helper20.
- État de liste ACTIF/INACTIF par sauvegarde dans modSettings/FS25_HelperProfiles/saves/savegameX/roster.xml.
- Les aides hors liste sont exclues du défilement, de la superposition, du calcul de la prochaine aide et de l'embauche.
- Écran de gestion à deux onglets pour les apparences AvatarSwitcher et la disponibilité de la liste.
- Protection des aides actives et obligation de conserver au moins une aide dans la liste.
- Intégration AvatarSwitcher facultative pour les apparences par sauvegarde.
- Affichage facultatif et en lecture seule des rôles HelperPayroll.

Incompatibilité connue :
N'utilisez pas HelperProfiles avec Hired Helper Tool. Lorsqu'un propriétaire externe incompatible de la liste est détecté, HelperProfiles se désactive pour la session en cours.

Commandes par défaut :
; parcourt les aides.
SHIFT + ; change le mode d'embauche.
RCTRL + ; ouvre la gestion des aides.
RALT + ; active ou désactive la superposition.
]]></fr>
    </description>

    <changelog>
        <en><![CDATA[
Version 2.1.0.0:
- Expanded the managed helper identity pool from A-J to A-T.
- Added stable helper01-helper20 canonical identities while retaining existing A-J compatibility.
- Added per-save ON/OFF roster availability management.
- Added the two-tab Helper Management interface for Appearances and Helper Roster.
- OFF-roster workers are excluded from cycling, overlay selection, next-worker calculations, and hiring.
- Added active-worker and at-least-one-worker roster safeguards.
- Added guarded Disable Others and Enable All bulk actions.
- Preserved AvatarSwitcher bindings, HelperPayroll roles, compensation overrides, and ledger identities when workers are disabled and re-enabled.
- Kept HelperPayroll roles visible when the operational roster is filtered.
- Added automatic A-J/K-T overlay paging.
- Made active appearance bindings read-only.
- Added Hired Helper Tool and external-roster incompatibility protection.
- Improved startup and roster filtering performance to prevent the earlier FPS regression.
- Added hpRoster and hpRosterManage diagnostics and management commands.

Version 2.0.27.3:
- Fixed duplicate shortcut prompts in the Profiles screen button bar.
- Added distinct ESC, X, C, A, and Enter actions for Close, Bind, Clear, Clear All, and Save.

Version 2.0.27.2:
- Added a live HelperPayroll ROLE column to the main HelperProfiles overlay.
- Compacted repeated worker names so the role column fits cleanly.

Version 2.0.26.0:
- Reworked the helper overlay into a clean, autosizing table.
- Added measured columns, compact status information, and row highlighting.
- Set multiplayer support to false.
]]></en>
        <de><![CDATA[
Version 2.1.0.0:
- Der verwaltete Helferpool wurde von A-J auf A-T erweitert.
- Stabile kanonische Identitäten helper01-helper20 wurden ergänzt; vorhandene A-J-Zuordnungen bleiben kompatibel.
- Eine spielstandsbezogene EIN/AUS-Verwaltung der Helferliste wurde hinzugefügt.
- Die zweireitige Helferverwaltung für Erscheinungsbilder und Helferliste wurde hinzugefügt.
- Helfer außerhalb der Liste werden beim Wechseln, in Overlay-Berechnungen und beim Einstellen ausgeschlossen.
- Schutzregeln für aktive Helfer und mindestens einen verbleibenden Helfer wurden ergänzt.
- Geschützte Massenaktionen Andere deaktivieren und Alle aktivieren wurden hinzugefügt.
- AvatarSwitcher-Bindungen, HelperPayroll-Rollen, Vergütungsüberschreibungen und Ledger-Identitäten bleiben beim Deaktivieren erhalten.
- HelperPayroll-Rollen bleiben bei gefilterter Helferliste sichtbar.
- Automatische Overlay-Seiten A-J/K-T wurden hinzugefügt.
- Aktive Erscheinungsbindungen sind schreibgeschützt.
- Schutz vor Hired Helper Tool und externen Helferlisten wurde ergänzt.
- Start- und Filterleistung wurden verbessert, um den früheren FPS-Einbruch zu verhindern.
- Die Befehle hpRoster und hpRosterManage wurden ergänzt.

Version 2.0.27.3:
- Doppelte Tastenkürzel in der Schaltflächenleiste wurden behoben.
- Separate Aktionen für ESC, X, C, A und Enter wurden hinzugefügt.

Version 2.0.27.2:
- Eine Live-Spalte ROLLE für HelperPayroll wurde dem Haupt-Overlay hinzugefügt.

Version 2.0.26.0:
- Das Helfer-Overlay wurde zu einer automatisch skalierenden Tabelle überarbeitet.
- Die Mehrspielerunterstützung wurde auf false gesetzt.
]]></de>
        <fr><![CDATA[
Version 2.1.0.0 :
- Le groupe d'aides géré a été étendu de A-J à A-T.
- Des identités canoniques stables helper01-helper20 ont été ajoutées tout en conservant la compatibilité A-J.
- Une gestion ACTIF/INACTIF de la liste par sauvegarde a été ajoutée.
- L'écran de gestion à deux onglets Apparences et Liste des aides a été ajouté.
- Les aides hors liste sont exclues du défilement, de la superposition, du calcul de la prochaine aide et de l'embauche.
- Des protections pour les aides actives et la dernière aide disponible ont été ajoutées.
- Les actions groupées Désactiver les autres et Tout activer sont protégées.
- Les apparences AvatarSwitcher, rôles HelperPayroll, réglages de rémunération et identités de registre sont conservés.
- Les rôles HelperPayroll restent visibles lorsque la liste opérationnelle est filtrée.
- La pagination automatique A-J/K-T de la superposition a été ajoutée.
- Les liaisons d'apparence des aides actives sont en lecture seule.
- Une protection contre Hired Helper Tool et les listes externes a été ajoutée.
- Les performances de démarrage et de filtrage ont été améliorées afin d'éviter l'ancienne chute de FPS.
- Les commandes hpRoster et hpRosterManage ont été ajoutées.

Version 2.0.27.3 :
- Les raccourcis en double de la barre de boutons ont été corrigés.
- Des actions distinctes ESC, X, C, A et Entrée ont été ajoutées.

Version 2.0.27.2 :
- Une colonne RÔLE HelperPayroll en direct a été ajoutée à la superposition.

Version 2.0.26.0 :
- La superposition a été transformée en tableau redimensionnable.
- La prise en charge du multijoueur a été définie sur false.
]]></fr>
    </changelog>

    <l10n filenamePrefix="l10n/l10n"/>
    <iconFilename>icon_helperProfiles.dds</iconFilename>

    <actions>
        <action name="OPEN_HELPER_MENU" category="SYSTEM"/>
        <action name="HP_TOGGLE_OVERLAY" category="MISC"/>
        <action name="HP_TOGGLE_MODE" category="MISC"/>
        <action name="HP_OPEN_APPEARANCE_MENU" category="MISC"/>
        <action name="HP_CLEAR_ALL_BINDINGS" category="MENU" axisType="HALF"/>
    </actions>

    <inputBinding>
        <actionBinding action="OPEN_HELPER_MENU">
            <binding device="KB_MOUSE_DEFAULT" input="KEY_semicolon"/>
        </actionBinding>
        <actionBinding action="HP_TOGGLE_MODE">
            <binding device="KB_MOUSE_DEFAULT" input="KEY_lshift KEY_semicolon"/>
            <binding device="KB_MOUSE_DEFAULT" input="KEY_rshift KEY_semicolon"/>
        </actionBinding>
        <actionBinding action="HP_OPEN_APPEARANCE_MENU">
            <binding device="KB_MOUSE_DEFAULT" input="KEY_rctrl KEY_semicolon"/>
        </actionBinding>
        <actionBinding action="HP_TOGGLE_OVERLAY">
            <binding device="KB_MOUSE_DEFAULT" input="KEY_ralt KEY_semicolon"/>
        </actionBinding>
        <actionBinding action="HP_CLEAR_ALL_BINDINGS">
            <binding device="KB_MOUSE_DEFAULT" input="KEY_a"/>
        </actionBinding>
    </inputBinding>

    <multiplayer supported="false"/>

    <extraSourceFiles>
        <sourceFile filename="scripts/HP_SlotRegistry.lua"/>
        <sourceFile filename="scripts/HP_Compatibility.lua"/>
        <sourceFile filename="scripts/HP_Config.lua"/>
        <sourceFile filename="scripts/HP_UI.lua"/>
        <sourceFile filename="scripts/HP_Debug.lua"/>
        <sourceFile filename="scripts/HP_ASBridge.lua"/>
        <sourceFile filename="scripts/HP_WorkerAppearance.lua"/>
        <sourceFile filename="scripts/HP_AppearanceMenu.lua"/>
        <sourceFile filename="scripts/gui/HP_AppearanceBindingsScreen.lua"/>
        <sourceFile filename="scripts/HelperProfiles.lua"/>
        <sourceFile filename="scripts/HP_RosterExpansion.lua"/>
        <sourceFile filename="scripts/HP_IntegrationAPI.lua"/>
        <sourceFile filename="scripts/RegisterPlayerActionEvents.lua"/>
    </extraSourceFiles>
</modDesc>