Silence_QOL_Fixes

Silence QOL Fixes - Server Admin Guide
  Arma Reforger Addon

WHAT THIS MOD DOES
A collection of server-side quality-of-life improvements covering
GM tools, player progression, safe zones, and AI/vehicle cleanup.

  1. Persistent XP & Custom Ranks
     Players accumulate XP across sessions. Rank progression
     extends beyond vanilla Major up to three staff tiers:

       Veteran  - earned after ~1 full day of hard grinding above Major
       Senior   - long-term dedicated players
       Staff    - effectively GM-granted; months of play to reach naturally

     All XP and rank data is saved server-side in:
       <ServerProfile>\PersistentXP.json

  2. Season-Based XP Wipe (file method)
     To wipe all player XP and start a fresh season:
       a) On the server machine, open:
            <ServerProfile>\PersistentXP_Season.txt
       b) Change the number inside (e.g. 1 to 2).
       c) Restart the server.

     The file is created automatically on first run with "1" inside.
     Accidental restarts do NOT trigger a wipe - only a deliberate
     file edit does.

  3. In-Game XP Wipe (GM method)
     GMs can wipe all XP directly from the GM context menu:
       a) Open the GM context menu (no entity selected).
       b) Click "Arm XP Wipe"  - this arms a 30-second window.
       c) Click "Confirm Wipe All XP" within 30 seconds to execute.

     This also zeroes the live XP of all currently connected players
     immediately, without requiring a server restart or reconnect.
     After a GM wipe, PersistentXP_Season.txt is updated automatically
     so the next restart does not trigger an unintended second wipe.

  4. GM Context Actions
     Additional GM tools available from the context menu:

       Copy Entity (Slots 1/2/3)   - copy a selected entity to one
                                     of three clipboard slots
       Paste Entity (Slots 1/2/3)  - paste a copied entity
       Cycle Paste Orientation     - rotate paste orientation
       Toggle Protected            - toggle entity protection
       Hide/Show Unit              - toggle unit visibility
       Refresh Visibility          - fix AI that have gone invisible
                                     after a soft crash
       Promote / Demote Player     - adjust player rank and XP
       Arm XP Wipe                 - arms the in-game wipe (see above)
       Confirm Wipe All XP         - executes the wipe (requires arm)

  5. Safe Zone
     Configurable safe zone logic. Players inside the defined area
     are protected from damage. Adjust the zone position and radius
     in ARGC_SafeZone.c or via Workbench config.

  6. Vehicle Cleanup
     Abandoned or destroyed vehicles are automatically cleaned up
     after a configurable timeout to keep server performance stable.
     AI drivers are detected and excluded from premature cleanup.

  7. Stats HUD
     A persistent heads-up display showing player combat stats
     (kills, vehicle kills, deaths, XP, rank) visible to the player
     at all times.

     KEYBINDS (bind in Controls > Custom)
       PXP_ToggleStatsHUD   - show / hide the HUD panel
       PXP_HUD_MoveLeft     - nudge panel left
       PXP_HUD_MoveRight    - nudge panel right
       PXP_HUD_MoveUp       - nudge panel up
       PXP_HUD_MoveDown     - nudge panel down
       PXP_HUD_MoveReset    - snap panel back to default position

     PANEL CONTENTS
       Kills      - infantry kills this session
       Veh Kills  - vehicle / aircraft kills this session
       Deaths     - deaths this session
       XP         - current total XP
       Rank       - current rank name (Private through Staff)

     PERSISTENCE
       Panel position is saved automatically between sessions.
       XP and rank data is server-side and persists across restarts.

  8. Stinger AI Fix
     Patches AI behaviour for Stinger (MANPADS) operators to prevent
     common targeting and engagement issues.

     STANDALONE MODE
       By default Stinger AI requires an AIGroup and a behaviour tree
       to aim the soldier's head at targets before firing. The new
       Standalone Mode attribute (checkbox on ARGC_StingerAIComponent)
       removes this requirement, allowing GM-spawned Stinger soldiers
       that are not part of any group to still scan a full 360° sphere
       and engage aircraft.

  9. WCS Armaments Integration
     WCS_Armaments (629B2BA37EFFD577) is a declared dependency and is
     used by ARGC_StingerAI.c for seeker component lookups at runtime.

     NOTE: The broader AI anti-air guidance system (auto-seeker manager
     and per-prefab Deko fire controller) was under development but is
     not currently active. AIControlComponent cannot be modded from
     EnforceScript, and the per-prefab Deko seeker injection did not
     produce reliable guidance behaviour in testing. Both approaches
     are disabled pending a viable hook in a future Reforger update.