========================================
1. WHAT PRIORITY RESPONSE DOES
========================================

Priority Response is an LSPDFR plugin focused on backup coordination and scene support.

It can:
- give you a manual backup request menu during active callouts
- automatically dispatch backup based on incident priority
- work with Native LSPDFR, Policing Redefined, and Ultimate Backup
- use editable priority phrase data
- support custom scanner audio and Grammar Police extras

The goal is to make backup feel more controlled, more configurable, and more useful during normal patrol gameplay.

========================================
2. REQUIREMENTS
========================================

Required:
- Grand Theft Auto V
- RAGE Plugin Hook
- LSPDFR

Optional:
- Policing Redefined
- Ultimate Backup
- Grammar Police

IMPORTANT:
Policing Redefined and Ultimate Backup are optional.
Priority Response can still run without them.

========================================
3. BASIC INSTALLATION
========================================

STEP 1 - AUDIO FOLDER
Drag the included "lspdfr" folder into your main GTA V folder.

This installs the Priority Response scanner audio files.

Correct scanner audio path:
Grand Theft Auto V\lspdfr\audio\scanner\PriorityResponse\

Custom audio path:
Grand Theft Auto V\lspdfr\audio\scanner\PriorityResponse\custom\

STEP 2 - PLUGIN FILES
Drag the included "Plugins" folder into your main GTA V folder.

This installs:
- PriorityResponse.Core.dll
- the PriorityResponse data folder

Main plugin path:
Grand Theft Auto V\Plugins\LSPDFR\PriorityResponse.Core.dll

Main data path:
Grand Theft Auto V\Plugins\LSPDFR\PriorityResponse\

========================================
4. PROVIDER SUPPORT
========================================

Priority Response now handles provider support through the main plugin DLL.

That means:
- there is no separate PR provider DLL to install
- there is no separate UB provider DLL to install

If you use Native LSPDFR only:
- install PriorityResponse.Core.dll
- install the PriorityResponse data folder
- install the audio folder if you want the included scanner audio

If you use Policing Redefined:
- install PriorityResponse.Core.dll
- install the PriorityResponse data folder
- make sure Policing Redefined itself is already installed correctly

If you use Ultimate Backup:
- install PriorityResponse.Core.dll
- install the PriorityResponse data folder
- make sure Ultimate Backup itself is already installed correctly

IMPORTANT:
Priority Response does not require you to install separate provider bridge DLLs anymore.
It detects and uses supported providers through the main plugin.

========================================
5. GRAMMAR POLICE SETUP
========================================

If you want the extra Grammar Police support, open the included "Grammar Police" folder from the release package.

Follow the included reminder/instructions and place the provided Grammar Police content into one of your Grammar Police EN language folders.

This step is optional and only needed if you want the additional Grammar Police dispatch flavor/support.

========================================
6. FIRST RUN CHECKLIST
========================================

After installation:

1. Start the game through RAGE Plugin Hook
2. Load LSPDFR
3. Go on duty
4. Confirm Priority Response loads
5. Open the manual backup menu
6. Open the config menu
7. Check that the provider/status information matches your setup
8. Confirm the PriorityResponse data files exist in:
   Plugins\LSPDFR\PriorityResponse\

If something seems wrong, double-check:
- the files were dropped into the correct GTA V root folder
- LSPDFR is already working correctly
- your optional provider mod is already installed correctly if you expect PR or UB support

========================================
7. PRIORITY RESPONSE DATA FILES
========================================

The PriorityResponse folder contains the main editable files:

- PriorityResponse.ini
- PriorityResponse.CalloutPriorities.xml
- PriorityResponse.CallsignRules.ini

These files control how the plugin behaves.
Edit them carefully and always keep backups before making major changes.

========================================
8. WHAT EACH FILE IS FOR
========================================

A) PriorityResponse.ini
This is the main settings file.

Use it for things like:
- keybinds
- menu/config behavior
- provider-related options
- auto backup timing
- responder limits
- notification behavior
- general plugin behavior

B) PriorityResponse.CalloutPriorities.xml
This controls phrase-based priority matching.

Use it to:
- add or remove phrases
- decide what wording should count as low, medium, or high priority
- tune how automatic response reacts to incident text

C) PriorityResponse.CallsignRules.ini
This controls callsign/audio selection rules.

Use it to:
- tune how callsigns are chosen
- shape scanner flavor
- control allowed naming/audio combinations

========================================
9. HOW TO EDIT THE FILES PROPERLY
========================================

General advice:
- make a backup before editing
- use a proper text editor
- save changes cleanly
- avoid random formatting edits
- change one thing at a time when testing

PriorityResponse.ini:
- use this for behavior and timing changes
- test after major adjustments

PriorityResponse.CalloutPriorities.xml:
- add phrases carefully under the correct priority section
- avoid dumping too many overlapping phrases in at once
- test your changes in-game

PriorityResponse.CallsignRules.ini:
- make smaller changes first
- test before doing large rewrites

Best practice:
small edits and quick testing will save you a lot more trouble than giant overhauls.

========================================
10. CUSTOM .WAV FILE SUPPORT
========================================

Priority Response supports custom scanner audio.

Custom audio folder:
Grand Theft Auto V\lspdfr\audio\scanner\PriorityResponse\custom\

How it works:
- the included audio pack provides the default Priority Response sound set
- your own custom .wav files go in the "custom" folder
- keep your files inside the Priority Response scanner path

Important:
- use .wav files only
- keep backups of anything you change
- follow the same general naming style used by the included files if you want the cleanest results

If your custom audio does not play:
- confirm the files are actually .wav files
- confirm they are inside:
  lspdfr\audio\scanner\PriorityResponse\custom\
- confirm the main Priority Response audio folder is installed correctly

========================================
11. TROUBLESHOOTING
========================================

If the plugin does not load:
- verify PriorityResponse.Core.dll is in Plugins\LSPDFR\
- verify the PriorityResponse folder is in Plugins\LSPDFR\PriorityResponse\
- verify LSPDFR and RAGE Plugin Hook are already working first

If provider support does not work:
- confirm the provider mod itself is installed and working
- confirm Priority Response is loading normally
- check the in-game provider/status information

If audio does not work:
- verify the lspdfr audio folder was installed into the GTA V root correctly
- verify the PriorityResponse scanner folder exists
- verify custom .wav files are inside the custom folder

If edits break behavior:
- restore your backup
- redo the edit more carefully
- change one thing at a time and test

========================================
12. FINAL NOTES
========================================

Priority Response is easiest to maintain when you:
- keep your install clean
- back up your editable files before changing them
- make smaller changes instead of giant ones
- test after each major change

That will save you a lot of frustration and make troubleshooting much easier.
"""

path = Path("/mnt/data/PriorityResponse_Installation_Instructions_Updated.txt")
path.write_text(content, encoding="utf-8")
print(path)
