GM Perceived Faction Override

A simple gameplay utility mod focused on undercover, infiltration and disguise gameplay for Arma Reforger.

Originally made for the FCAT community, it allows Game Masters to override how AI perceives players and vehicles, enabling better stealth, checkpoint, sabotage, reconnaissance and undercover missions.

==================================================
WHY THIS MOD EXISTS
==================================================

Many PMC, civilian and custom clothing items are tied to the US faction, causing vanilla AI to treat disguised players as US even when they look different.

This mod lets GMs manually control how AI perceives players and vehicles.

==================================================
MAIN FEATURES
==================================================

• Override player and vehicle perceived faction  
• Vehicle perceived faction without changing real faction  
• Pilot Override (vehicle follows driver’s perceived faction)  
• AI suspicion and disguise detection  
• Warning state before full exposure  
• Vehicle infiltration support  
• Mixed vehicle occupants fallback to NO_FACTION  
• Fully configurable detection settings

==================================================
DETECTION BEHAVIORS (GM Configurable)
==================================================

AI detects disguised players based on behavior:

• Raising weapon near observers (default 25 m)  
• Equipped weapon too close (default 10 m)  
• Staying unarmed near enemies based on **perceived faction override** (CIV: 5 m | other factions: 10 m)  
• Suspicion buildup over time + warning phase before full break  
• When one player is exposed, nearby disguised players can also be revealed (default 5 m)

All radii, suspicion gain/decay, warning timers and other values are adjustable via GM editor sliders.

==================================================
IMPORTANT NOTES
==================================================

• Equip all faction-related gear (clothing, vests, helmets, gloves, balaclavas, etc.) **before** the GM applies the perceived faction override.  
• Avoid changing these items during the mission, as some pieces can affect AI perception.

==================================================
RECOMMENDED SETTINGS
==================================================

Scenario Properties:  
• Player Perceived Faction Setting = MIXED

CRX Global Experimentation:  
• Global Perceived Faction Changes Affects AI = YES

==================================================
WIP / USAGE DISCLAIMER
==================================================

This mod is still Work In Progress and was mainly built for our own community gameplay needs.

You are free to copy, modify, reupload, adapt, use parts of it or integrate into other mods/missions.

I genuinely do not care. Do whatever you want with it, as long as:
- It is used for Arma Reforger
- It fully respects Bohemia Interactive’s Arma Public License (APL)

I take no responsibility for compatibility issues, broken scenarios or anything else that may happen while using or modifying it.

==================================================
SPECIAL THANKS
==================================================

Special thanks to @ATiM for the CRX AI mod. It improves AI behavior massively and works great together with this mod.

Big thanks to @CptMuricah  for the ideas and suggestions, and to @EASYMONEY  for all the help with scripting.

==================================================
ABOUT FCAT
==================================================

FCAT is a Brazilian PVE-focused MILSIM community.

If you speak Portuguese and enjoy PVE MILSIM gameplay, you are welcome to join us:

https://discord.gg/MJqNkJYnAP