🌌 CYBER ARORA OS: OFFICIAL MASTER DOCUMENTATION

Version: Precision Injection XML Suite (Build 1.0) Compatibility: LSPDFR, Ultimate Backup, Policing Redefined, EUP (Emergency Uniforms Pack)

📖 TABLE OF CONTENTS

1. Introduction to Project Arora

2. System Requirements & Initialization

3. The Configuration Engine (ProjectArora.ini)

4. Quick-Action Hotkeys & The Cache System

5. The Master Fleet Hub (F5 Menu - Agencies & Duty)

6. Ultimate Backup & Policing Redefined Injection Engine

7. The Hologram Showroom & Asset Tuning

8. Outfit Configuration & EUP Wizard (F6 Menu)

9. AI Ped Linking & The Crash Shield Protector

10. Arora SafetyNet: Backups & XML Diagnostics

11. Technical Appendix: How Arora Writes XML

1. INTRODUCTION TO PROJECT ARORA

Welcome to the future of GTA V and LSPDFR modding.

Historically, modifying your LSPDFR experience meant closing the game, opening massive agency.xml or DefaultRegions.xml files in Notepad++, manually typing out <Vehicle> and <Ped> tags, guessing component IDs for clothing, and praying the game didn't suffer a fatal crash upon reloading.

Project Arora eliminates desktop XML editing entirely.

Arora OS is a fully integrated, in-game Operating System. It allows you to dynamically build, tune, and inject vehicles, undercover configurations, and police outfits directly into your configuration files using an intuitive NativeUI interface and real-time live scanning. It understands the complex formatting rules of LSPDFR, Ultimate Backup, Policing Redefined, and EUP, automatically formatting your data perfectly every single time.

2. SYSTEM REQUIREMENTS & INITIALIZATION

Supported File Structures

Project Arora is designed to target and inject into the following standard LSPDFR directory paths:

• lspdfr/data/*.xml (Specifically targets agency.xml and duty_selection.xml)

• lspdfr/data/custom/*.xml

• Plugins/*.xml (Specifically targets DefaultRegions.xml, CustomRegions.xml, and SpecialUnits.xml)

The Boot Sequence & EUP Detection

When you load into the game and go on duty, Arora executes a silent background initialization routine:

1. Deduplication Scan: Arora crawls your directories to find every active XML file. It uses a bulletproof Absolute Path HashSet algorithm (DeduplicatePaths) to ensure that if a file is referenced twice by the game, it only appears once in your menus.

2. EUP Smart-Detect: Arora scans for Plugins\EUPMenu.dll or custom EUP XML files.

   • If detected, it boots in EUP Compatibility Mode, unlocking the F6 Outfit Creation suites.

   • If missing, it boots in Standard Vanilla Mode, streamlining menus for non-EUP users.

3. Cache Loader: It loads your persistent Add-On vehicle cache (ProjectArora_Cache.txt) into memory.

3. THE CONFIGURATION ENGINE (ProjectArora.ini)

Upon its first boot, Arora safely generates a beautifully formatted, highly detailed initialization file located at Plugins/ProjectArora.ini. You can edit this file at any time to customize your experience.

INI Breakdown

Ini, TOML

;; ==============================================================================;;   PROJECT ARORA - MASTER CONFIGURATION;;   "Precision Injection XML Suite";; ==============================================================================

[Keybinds]; Open the Main Car Browser Menu (Agencies, UB, Diagnostics)MenuKey=F5

; Open the Outfit & Ped Configuration Menu (EUP, Ped Linking)OutfitMenuKey=F6

; Auto-scan the vehicle you are currently sitting inScanKey=L

; Open the Quick-Inject menu for your current vehicleInjectKey=N

; Key for random asset injection testing (Dev feature)RandomInjectKey=None

[Features]; Set to true to enable the Random Injection featureRandomInjectEnabled=false

4. QUICK-ACTION HOTKEYS & THE CACHE SYSTEM

You don't always need to dive into deep menus to save a vehicle. Arora features rapid-action hotkeys designed for active patrols.

🔍 The Asset Scanner (L Key)

Press L while sitting in any vehicle. Arora's scanner will pierce the vehicle's memory and display a live readout.

• It grabs the internal Model Name (e.g., police3).

• It cross-references an internal Real-Life Dictionary to classify the vehicle (e.g., translating police3 to Ford Police Interceptor Sedan).

🎯 The Target Lock Injector (N Key)

Press N while seated in a vehicle to open the Target Lock Router. This bypassed the main menu and instantly prepares your current vehicle for injection.

1. It automatically pre-loads your car's model name.

2. It deeply scans your live vehicle to extract current Liveries (e.g., livery="1") and Active Extras (e.g., extras="1,4,12").

3. You are presented with a list of all your Agencies, Duty files, and Backup Regions. Click one, and the vehicle is instantly injected and saved to the hard drive.

🧠 The Add-On Cache System (ProjectArora_Cache.txt)

GTA V handles DLC/Add-On vehicles differently than vanilla cars. Often, an add-on vehicle's model name will register as a raw memory hash (e.g., 0x4F12A8B).

• If you scan an unknown Add-On, Arora will intercept the injection and trigger a prompt: "Unregistered Add-on! Enter the Spawn Name (e.g. polcvpi)".

• Once you type the correct spawn name, Arora links the hash to the text and permanently writes it to ProjectArora_Cache.txt. You will never be asked for that vehicle's name again.

5. THE MASTER FLEET HUB (F5 MENU) - AGENCIES & DUTY

Pressing F5 opens the CYBER ARORA Master Configuration UI. The first two sub-menus govern your standard LSPDFR files: agency.xml and duty_selection.xml.

Dynamic Division Discovery

When you click into an agency (e.g., LSPD), Arora does not force you to type out division names. It dynamically parses the XML's <Loadouts> and generates clickable folders for every active division (e.g., Patrol Unit, SWAT, Air Support).

• Creating Divisions: If you need a new one, click [+] New Division, type a name (e.g., K9 Unit), and Arora will build the entire XML structural skeleton from scratch in the background.

The Division Control Panel

Clicking into a Division grants you God-Mode control over its AI.

1. Sync Weapon Arsenal

This is a groundbreaking quality-of-life feature.

• The Problem: Manually writing <Weapon>WEAPON_COMBATPISTOL</Weapon> in XML is tedious.

• The Arora Solution: Equip the exact loadout you want on your live player character (Pistol, Stun Gun, Carbine Rifle, Flashlight attachment). Click Sync Weapon Arsenal. Arora reads your live inventory and mathematically overwrites the division's <Weapons> XML node to perfectly match what you are holding.

2. Configure Ped Count

Controls the number of AI partners in a vehicle.

• Clicking this prompts you for a Min and Max value.

• Arora injects <NumPeds min="2" max="4" /> seamlessly into the loadout.

3. Toggle AI Flags (Interactive Checklist)

Flags are the "brains" of the LSPDFR AI. Arora provides an interactive UI checklist to toggle these behaviors on and off instantly without touching code.

• [X] RespondsAsBackup: Allows the unit to be dispatched normally.

• [ ] RespondsAsTransport: Designates the unit exclusively for Prisoner Transport.

• [ ] RespondsAsAirBackup: Designates the unit as a helicopter/aviation support.

• [X] SWAT: Overhauls AI combat logic (aggressive flanking, highly accurate, uses cover).

• [ ] IsUndercover: Modifies arrival behavior (often arrives without sirens).

• [ ] NoBlip: Removes the AI unit from the player's minimap.

6. ULTIMATE BACKUP & POLICING REDEFINED INJECTION

Ultimate Backup (UB) and Policing Redefined (PR) use highly complex, often contradictory XML structures. Arora's UBParser engine handles the translation automatically.

The Smart Tagging System

When viewing UB files, Arora automatically analyzes the XML nodes and prepends visual UI tags so you know exactly what you are modifying:

• [ZONE] - Applied to standard map regions (e.g., LosSantosCity, CustomRegion).

• [UNIT] - Applied to standard Police Special Units.

• [MEDIC] - Auto-detected if a Special Unit has role="medic".

• [FIRE] - Auto-detected if a Special Unit has role="fireman".

The Ultimate Backup Injection Process

When injecting a vehicle into Ultimate Backup, Arora triggers an intelligent wizard:

1. Role Verification: Arora checks the role of the unit. If it is a [MEDIC] or [FIRE] unit, it skips passenger prompts.

2. Pax (Passengers) Prompt: If it is a Police unit, Arora asks you for the Pax count (how many extra passengers should spawn) and the Pax Chance %.

3. Zone Targeting: If injecting into a Special Unit, Arora dynamically lists the zones inside that unit (e.g., LosSantosCity, sp_region). If the zone doesn't exist, Arora builds it on the fly.

4. Formatting (The XML Fix): UB's syntax is strictly enforced. Arora knows that Map Zones require a <VehicleSet type="LocalPatrol"> wrapper, while Special Units require a direct <Vehicles> tag. Arora opportunistically formats the XML to prevent duplicate folders and crashes.

Global Propagate (Mass Inject)

Located at the top of the UB Menu is the red [!] Global Propagate button.

• Sitting in a vehicle, you can press this button to inject your current car into EVERY SINGLE ACTIVE REGION across all your UB XML files simultaneously. It asks for Pax settings once, calculates your liveries, and updates up to 50 XML regions in less than a second.

7. THE HOLOGRAM SHOWROOM & ASSET TUNING

Managing massive fleets is difficult when you can't remember what "police4" looks like.

The Hologram Spawner

Inside any Division or Region, click » View Active Vehicles.

• Arora lists every vehicle assigned to that loadout.

• As you scroll over the names, Arora triggers the SpawnShowroomVehicle method.

• The Effect: Arora calculates your player's Forward and Right vectors, and spawns the vehicle perfectly positioned in front of you. The vehicle is given an Alpha of 175 (making it a ghostly, translucent hologram), its collisions are disabled, and it is frozen in place.

• The moment you close the menu or switch items, the hologram instantly deletes itself to keep your game world clean.

Live Spawn Rate Tuning

Under » Tune Spawn Rates, you can adjust how often a vehicle appears.

• Arora provides a native UI slider from 1% to 100%.

• As you move the slider, Arora actively overwrites the chance="X" attribute in the XML.

• Note on Rebalancing: Whenever you add or delete a vehicle, Arora automatically fires the RebalanceChances() algorithm, mathematically dividing 100% across all vehicles in the folder to ensure the math never breaks LSPDFR's dispatch logic.

8. OUTFIT CONFIGURATION & EUP WIZARD (F6 MENU)

The F6 Menu is entirely dedicated to the manipulation of Ped models and EUP (Emergency Uniforms Pack) clothing strings.

The Advanced EUP Variation Engine

Editing outfits.xml by hand is highly prone to typos. Arora turns your player character into a live editor.

A. Generating Fresh Data (The Extraction Tech)

When you ask Arora to save an outfit, it executes two native functions:

1. GenerateFreshComponents(): Scans your live character and extracts exact Drawable and Texture IDs for all 11 slots (Face, Masks, Hair, Torsos, Legs, Bags, Shoes, Accessories, Undershirts, Decals, Torsos2).

2. GenerateFreshProps(): Scans your character for Props (Hats, Glasses, Ears, Watches). If a prop isn't worn (-1), Arora intelligently leaves it out of the XML to keep the file perfectly clean.

B. The Creation Wizard

• [+] Create NEW Outfit: Guides you through naming a brand new uniform class (e.g., Outfit: LSPD Patrol | ScriptName: lspd_cop | Variation: Standard | VarScript: m_base).

• [+] Add Variation: Select an existing outfit, and append a new look to it (e.g., Adding a "Winter" variant to "LSPD Patrol").

• [+] Replace Variation: The ultimate repair tool. Arora lists every existing variation. Click one to instantly overwrite its old XML clothing data with the clothes currently on your live player character.

Smart Gender Auto-Detection: During any of these processes, Arora checks your base model hash. If you are mp_f_freemode_01, it automatically writes <Gender>female</Gender> into the XML. If male, it writes <Gender>male</Gender>.

9. AI PED LINKING & THE CRASH SHIELD PROTECTOR

Creating an EUP outfit is only half the battle. You must "Link" that outfit to a specific agency or backup region so the AI actually wears it.

The Linking Process

1. Navigate to » Agency Peds or » Ultimate Backup Regions in the F6 Menu.

2. Arora dynamically lists every division (e.g., SWAT Team, K9).

3. Click [ADD PED]. You will be prompted to enter the EUP ScriptName.

Understanding The "EUP ScriptName" Prompt

The script name is the exact formula connecting the AI to your outfits file. The formula is [OutfitScript].[VariationScript].

• Example: lspd_cop.m_base

• Example: sasp_pilot.m_helmet

The Dual-Mode Architecture & The Crash Shield

Arora is intelligent enough to handle both Custom EUP characters and Standard Vanilla characters.

Mode A: EUP Linking If you type an EUP ScriptName into the prompt, Arora writes the outfit="name" string directly into the XML, allowing EUP to dress the AI.

Mode B: Vanilla Linking If you leave the prompt entirely BLANK, Arora activates Vanilla mode. It reads your physical clothing components and hardcodes the raw data (e.g., comp_torsos="3,0") directly to the Ped node.

🚨 THE CRASH SHIELD PROTECTOR 🚨 GTA V and LSPDFR have a fatal flaw: If you attempt to save a Multiplayer skeleton (mp_m_freemode_01) as a "Vanilla" cop without an EUP outfit reference, LSPDFR will suffer a total AccessViolationException memory crash when it tries to load that cop on duty.

Arora monitors your inputs to prevent this. If the engine detects that you:

1. Left the EUP prompt blank (Requesting Vanilla Mode), AND...

2. Are physically playing as a Freemode/MP character...

The Crash Shield activates. Arora intercepts the injection, blocks the fatal error, drops a warning in the console logs, and silently forces the XML ped model to s_m_y_cop_01 (a safe, standard vanilla model). This guarantees that no matter how badly a user inputs data, Arora will protect the game from crashing.

10. ARORA SAFETYNET: BACKUPS & XML DIAGNOSTICS

Project Arora treats your game files like critical infrastructure.

The Backup Engine (AroraBackups)

Before Arora executes any SaveXmlSafe command, it triggers BackupXml().

• It takes a snapshot of the target file.

• It renames it with a precise timestamp (e.g., agency_20260408_143000.bak).

• It stores it securely in Plugins/AroraBackups.

System Rollbacks: If you ever make a mistake, open the F5 menu and navigate to System: Restore & Backups. Arora displays a list of your 20 most recent backups. Click any of them, and Arora will instantly overwrite your live XML with the healthy backup file, restoring your game without requiring a restart.

XML Health Diagnostics Scanner

Modding often involves copying and pasting text from websites. A single missing </Vehicle> tag will permanently break LSPDFR.

• Located in the F5 menu, the XML Diagnostics tool acts as an antivirus for your code.

• When clicked, it fires up a background GameFiber that silently attempts to compile every single active agency, duty, outfit, and backup XML file in your GTA directory.

• If a file is perfectly formatted, it reports [SYSTEM HEALTHY].

• If a file contains a syntax error, corruption, or missing bracket, it immediately throws a red [CORRUPTION DETECTED] warning, telling you exactly which file (e.g., CustomRegions.xml) is causing the failure so you can fix it.

11. TECHNICAL APPENDIX: HOW ARORA WRITES XML

For advanced modders, here is a visual representation of how Arora processes your UI clicks into actual LSPDFR XML code.

1. Agency Vehicle Injection (F5 Menu)

Action: User injects police3 into LSPD Patrol Unit. Toggle "SWAT" flag on. Resulting XML Generation:

XML

<Agency><Name>Los Santos Police Department</Name><ScriptName>lspd</ScriptName><Loadouts>
    <Loadout>
      <Name>Patrol Unit</Name>
      <Flags>
        <Flag>SWAT</Flag>
      </Flags>
      <Vehicles>
        <Vehicle chance="100">police3</Vehicle>
      </Vehicles>
    </Loadout></Loadouts></Agency>

2. Ultimate Backup Vehicle Injection (Mass Propagate)

Action: User executes Mass Inject with a "Pax" count of 2. Resulting XML Generation (Standard Region):

XML

<CustomRegion name="LosSantosCity"><VehicleSet type="LocalPatrol">
    <Vehicles>
      <Vehicle pax="2" pax_chance="100" chance="100">police3</Vehicle>
    </Vehicles></VehicleSet></CustomRegion>

Resulting XML Generation (Special Unit / Air Support):Note: Arora intelligently bypasses the VehicleSet wrapper because it recognizes it is inside a Special Unit.

XML

<SpecialUnit name="Air Support"><LosSantosCity>
    <Vehicles>
      <Vehicle pax="2" pax_chance="100" chance="100">polmav</Vehicle>
    </Vehicles></LosSantosCity></SpecialUnit>

3. EUP Ped Variation Injection (F6 Menu)

Action: User creates a new variation "Winter" for "LSPD Patrol". Resulting XML Generation:

XML

<Outfit><Name>LSPD Patrol</Name><ScriptName>lspd_cop</ScriptName><Variations>
    <Variation>
      <Name>Winter</Name>
      <ScriptName>m_winter</ScriptName>
      <Gender>male</Gender>
      <Components>
        <Component id="1" drawable="0" texture="0" />
        <Component id="3" drawable="12" texture="0" />
        <Component id="4" drawable="35" texture="0" />
        <Component id="8" drawable="58" texture="0" />
        <Component id="11" drawable="55" texture="0" />
      </Components>
      <Props>
        <Prop id="0" drawable="46" texture="0" />
      </Props>
    </Variation></Variations></Outfit>

Uniform Injection: Now you can inject uniforms into Special Units, Custom Regions, Default Regions, EUP Agencies, EUP Duty selection etc.

1:Now you can inject Outfits, and did I mention you can also ADD and REPLACE Outfits/Uniforms.

2:Now you would be guessing that Well i don't use EUP and i use some other configurations etc. I wanna edit well you don't gotta worry cuz anything that has "outfits","duty_selection,"agencies","custom regions"etc it will auto scan these files, and you can make changes in those files

3: It will auto read any files in the custom folder so u can make a file called agnecy_fallout_NV.xml and drop it into the custom folder the plugin will read that xml and you can add wtv u want cars or peds or outfits

4: It has support or UB (ultimate Backup) and (PR) Policing Redefined it will auto apply the syntax for both of them cuz those both mods have different xml syntax so ur pretty chill there it also calculates the chances so it always equals to 100 so you don't have to worry about the chances etc.

2:Smart Gender Detection: The outfit extractor now detects if the player is using mp_m_freemode_01 (Male) or mp_f_freemode_01 (Female) and automatically writes the correct <Gender> tag to the XML.

Upgraded Notifications: Startup notifications now dynamically display your current INI keybinds. Warning notifications have been updated to clearly state [ALREADY EXISTS] when a duplication attempt is caught.

XML Health Diagnostics Scanner: Added a new tool to the F5 menu. Arora will now scan all LSPDFR, EUP, UB, and PR XML files for syntax corruption and alert the user to broken files.