=======================================================
GTA V - LSPDFR - CompuLite Police Computer
Version 1.5.2.6 | Developed by BejoIjo Productions
BejoIjo Plugins: https://bit.ly/2H5CFt2
Copyright (c) 2021 All Rights Reserved
=======================================================

DISCLAIMER: 
-----------
!!!! WE CANNOT BE HELD RESPONSIBLE FOR ANY LOSS OR DAMAGE THAT MAY ARISE AS A RESULT OF THE USE OF OUR WEBSITE OR PLUGINS !!!!


PREREQUISITES:
--------------
1. Rage Plugin Hook v1.84
2. LSPD First Response v0.4.8 by G17
3. Rage Native UI v1.6.3.0 by alexguirre
4. Stop The Ped latest version by BejoIjo
5. Ultimate Backup latest version by BejoIjo


OPTIONAL 3RD PARTY PLUGINS:
---------------------------
- Traffic Policer latest version by Albo1125 (to have compatibility with older plugins/callouts on vehicle registration/insurance status)


OVERVIEW:
---------
"CompuLite" is a 'lore friendly' Police Computer plugin for LSPDFR. It allows you to look up ped and vehicle records by using the police computer or tablet.
It has an integrated "Court System", so you may see what is the outcome of each arrest reports or issued citation that you created using CompuLite.
The plugin UI is implemented using RageNativeUI, which should be lightweight and very stable.


INSTALLATION:
-------------
- Copy the contents of "Plugins\LSPDFR" in this package to: "GTA V directory\plugins\LSPDFR"
- If you haven't had "RageNativeUI.dll" in your "main GTA V folder", don't forget to copy the file from this package
- Please open and edit "CompuLite.ini" file, if you want to replace the keyboard key or controller button bindings


FEATURES:
---------
- Lore friendly UI (thanks to RageNativeUI) which allows you to navigate the menu using keyboard and mouse
- Access Ped and Vehicle Records from you police car using the police computer
- Access Ped and Vehicle Records while you're on foot by using a computer tablet
- It has an integrated "Court System". You may see what is the outcome of each arrest reports or citation that you created using CompuLite


HOW TO USE:
-----------
- To open Police Computer:
  - When using keyboard, you just need to HOLD the "E" key while the player is in the police car
  - When using controller, HOLD "DPadRight" controller button

- To open Police Tablet, you just need to PRESS "LControl+NumPad0" keys while the player is on foot

- To hand over the citation ticket to the ped, get closer to the ped and PRESS "LControl+PageDown" key

- All keys are configurable. You may change them in the "CompuLite.ini" file
 
- Look up Ped Records:
  - You may search the ped by first, last, or full name
  - The ped record will be automatically populated into the list:
    - If you asked Ped Id using "Stop The Ped" plugin
    - If you stopped the ped using vanilla LSPDFR
    - If you arrested the ped
    - If you're doing a traffic stop (driver and passengers records)
    - If you search the dead body
  - You may create citation or arrest report by clicking the button in the ped record panel
  - To create Citation:
    - You just need to go through on the citation list and select the desired citations by putting a checkmark
    - Then click the "OPEN ACTION MENU" button on the top to open the "Submit" and "Cancel" buttons
    - You may choose "Notify to Appear" checkbox if you want a court case to be issued for the citation
  - To create Arrest Report:
    - You just need to go through on the charge list and select the desired charges by putting a checkmark
    - Then click the "OPEN ACTION MENU" button on the top to open the "Submit" and "Cancel" buttons
    
- Look up Vehicle Records:
  - You may search the vehicle by it's plate number
  - If you're doing a traffic stop, the stopped vehicle will be automatically populated into the list
  - It will automatically open the vehicle owner ped record when you click the button in the vehicle record panel

- Court Case:
  - After you submitted Arrest Report or Citation (with notify to appear checked), a court case will be created.
  - Court cases in the list are sorted from the latest (on top) to the oldest ones
  - By default, it will take 2 days (48 hours) to have outcome/verdict from the court (you may configure it in the "CompuLite.ini" file)
  - But, if you're impatient to see the court results, you may click the "Reveal Outcome" button in the court case record panel
  - You may reset and clear all court cases by deleting "CourtCases.db" file in the "CompuLite" directory

- You can add a short notes on citation and arrest resport by pressing "Add Short Notes" below "Submit" and "Cancel" button. 
  The notes will be stored and can be seen on the court case.


XML EDITING - CITATIONS
-----------------------
# Acceptable attributes for each "Citation" tag:
  - "name" is the citation name or title
  - "fine" is the amount of fine money


XML EDITING - CHARGES
---------------------
# Acceptable attributes for each "Charge" tag:
  - "name" is the charge name or title
  - "traffic" determines whether the charge is in traffic category (true/false)
  - "can_be_warrant" determines whether the charge will be included in the list of possible ped arrest warrant (true/false). If not set, default value is true.
  - "susp_chance" probability of suspect's driver license gets suspended (0-100). This is only used when traffic="true"
  - "min_susp" and "max_susp" is the range of driver license suspension time in months. This is only used when traffic="true"
  - "revoke_chance" probability of suspect's driver license gets revoked (0-100). This is only used when traffic="true"
  - "fine" is the maximum amount of fine money
  - "fine_k" is the maximum amount of fine money in thousands
  - "probation_chance" is chance percentage that the judge would grant probation
  - "min_months" and "max_months" is range of jail time the suspect would get in months
  - "min_years" and "max_years" is range of jail time the suspect would get in years

# Note:
  - You cannot use "fine" and "fine_k" in the same entry
  - You cannot use "min_months-max_months" and "min_years-max_years" in the same entry)
  - You can set "max_years" value with "life", if the charge has maximum sentence of life in prison
  - If you don't want to apply fine or probation chance to a specified charge, just remove the attribute from the tag entry



KNOWN ISSUES & CAVEATS
----------------------
- The provided citations and charges in the xml files are fully fictional. You may edit it yourself to meet your own standard

- The ticket that will be handed over (using LControl+PageDown key) to the ped is the last submitted ticket

- The ped and vehicle records that can be displayed on the CompuLite are the ones that are still existed in GTA world and can be accessible by the API.
  (Note: that GTA V might despawn peds or vehicles if they're out of scope or not needed anymore)

- If you get unexpected vehicle details info notification after you search and entered the plate, make sure to set "VehicleDetailsChecksEnabled" to "false" in "Traffic Policer.ini" file

- The plugins is only tested on 1920x1080 screen resolution and it is not guaranteed if it wouldwork on other resolutions. Please report to me if you have issue with your screen resolution info.

- Make sure to set mouse input as "rawinput" in the GTA V setting to make the mouse control working


Please feel free to contact me through LSPDFR forum or download's comment section for any issue you encountered with this plugin.
Happy patroling! Enjoy! 


SPECIAL THANKS TO:
------------------
- Albo1125 for all your plugins which make LSPDFR very joyful!
- alexguirre for all your open source modules and plugins for LSPDFR
- PieRGud for the inspiring Computer+ plugin


VERSION HISTORY
---------------
v1.5.2.6 (latest)
- Added compatibility support for LSPDFR 0.4.9
- Added support for the new verification protocol

v1.5.2.5
- Fixed Bug. Fixed very rare/isolated crash due to the mouse handling on certain display resolution / multiple monitors

v1.5.2.4
- Improvement. Implemented better system resource management for displaying ped mugshot/headshot, since GTA V would sometimes crashes when it reaches the max limit

v1.5.2.3
- Fixed Bug. Sometimes CompuLite crashes for users in certain countries.

v1.5.2.2
- New Feature. CompuLite text language and localization support. You may edit "CompuLite\Localization.ini" file to customize it
- Fixed Bug. The Date/Time clock on the top right corner now should display the correct format set in the Windows Region Settings
- Fixed Bug. CompuLite now should display currency symbol properly according to the "CurrencySymbol" configuration in "CompuLite.ini" (e.g.  and )

v1.5.2.1
- Improvement. Added page navigation for citation and arrest report lists. This will fix a known issue with overflowing records in the list
- Improvement. Added page navigation for court cases's offense and outcome lists. Now you may throw as many charges as you like :)
- Improvement. Added mouse navigation support for ultra-wide monitor resolution (2560x1080 and 3440x1440). Make sure to use the latest RageNativeUI v1.7.1 (included in the installation package)
- Improvement. The Date/Time and number format displayed on the CompuLite should follow Windows Region Settings

v1.5.2.0
- Improvement. Added the total fine information for citation on the court case

v1.5.1.1
- New Feature. CompuLite will also display ped's picture (mugshot) on the Court Case
- Improvement. Added the total fine information in the court case result
- Fixed Bug. CompuLite will not display if vehicle is a bicycle

v1.5.1.0
- Added compatibility support for LSPDFR 0.4.8

v1.4.9.9
- Improvement. If a vehicle has no registration, CompuLite will treat the vehicle plate as counterfeit (fake), which means the system will not find the vehicle owner and insurance record

v1.4.9.8
- Improvement. The ped mugshot/headshot picture on ped detail will be rendered without hat or helmet if the ped wearing it
- Improvement. Added vehicle registration expiration date in the vehicle record (it is also synch-ed with Stop The Ped)
- Improvement. Added vehicle insurance expiration date in the vehicle record (it is also synch-ed with Stop The Ped)

v1.4.9.7
- New Feature. You can add a short notes on citation and arrest report by pressing "Add Short Notes" below "Submit" and "Cancel" button. The notes will be stored and can be seen on the court case
- Fixed Bug. Sometimes when the offences list on court case is too long, nothing is displayed (blank)

v1.4.9.6
- Improvement. Added support for new Stop The Ped API which manages vehicle registration and insurance status flags (This is useful when you don't have Traffic Policer by Albo installed)
- Fixed Bug. Sometimes police car would be added to the vehicle list
- Fixed Bug. Now felon who has arrest record should not have gun permit
- Fixed Bug. Cop showed as in parole or in probation and has arrest records 
- Fixed Bug. Sometimes if the citation or arrest record list is too long, nothing is displayed (blank)

v1.4.9.5
- Fixed Bug. Incorrect currency symbol on the citation notification
- Fixed Bug. Opening CompuLite tablet sometimes freezes the player character.
- Fixed Bug. In some location, tablet is failed to open

v1.4.9.3
- New Feature. Added support to ALPR Lite, which will add the hit vehicle automatically into the "Vehicle List"
- Fixed Bug. Sometimes the ped names are not removed from the ped list if they are a vehicle owner. It should be removed when the vehicle is no longer on the scene
- Fixed Bug. Sometimes the vehicle owner name is not in sync with other plugins (e.g. Police Smart Radio)

v1.4.9.2
- Added support for LSPDFR 0.4.7
- Fixed Bug. When handing over ticket to the driver and player is on the right side of the vehicle, the animation should be played correctly

v1.4.9.1
- Fixed Bug. Found the culprit in the source code which sometimes might cause glitches (e.g. ped is freezing)

v1.4.9.0
- New Feature. Added "can_be_warrant" flag in charge.xml to include/exclude the charge from arrest warrant selection. Please refer to "charges.xml" for examples
- New Feature. Separated probation and parole flags
- Fixed Bug. The "CourtCaseWaitingTime" parameter is not working properly
- Fixed Bug. Sometimes the currency string is incorrectly rendered (e.g. poundsterling character)

v1.4.8.0
- Added support for LSPDFR 0.4.6

v1.4.7.0
- Fixed Bug. Sometimes the prison time calculation of years and months are incorrect

v1.4.6.0
- Fixed Bug. Sometimes (in a certain PC spec) after submitting charge, the compulite doesn't return to the current ped record view
- Fixed Bug. When on foot ped receiving citation, the ped should do proper animation
- Fixed Bug. Incorrect frontend sound when pressing a button

v1.4.5.0
- New Feature. Added the total prison time information on the Court Case record.
- New Feature. Added integration to give the citation ticket using new STP Traffic Stop Menu
- New Feature. Now you can use keyboard or controller to navigate and choose the "Create Citation" and "Create Arrest Report" buttons on the ped record screen
- New Feature. Now you can use keyboard or controller to press the "View Owner Record" button on the vehicle record screen
- New Feature. Now you can use keyboard or controller to press the "Reveal Outcomes" button on the court case screen
- New Feature. Added a parameter to disable the auto-collect driver and occupant IDs during Traffic Stop ("EnableTrafficStopAutoCollectPedID"). 
  If you set it to "no", then you may use STP new Traffic Stop Menu to collect their IDs and add them into the Ped Record List for more immersive experience
- New Feature. Added a parameter to disable the auto-collect vehicle plate number during Traffic Stop ("EnableTrafficStopAutoCollectVehicleTag"). 
  If you set it to "no", then you may use STP new Traffic Stop Menu to collect the plate number and add them into the Vehicle Record List for more immersive experience

v1.4.3.0
- New Feature. Player can define the license suspension duration on traffic charge entry
- New Feature. Player can define the license revoked probability on traffic charge entry
- Fixed Bug. Sometimes LSPDFR crashes when player remove the "fine" attribute from any citation entry

v1.4.2.0
- Fixed bug. Sometimes the Ped Record list becomes not visible after player forces to exit CompuLite without submitting citation or charge

v1.4.1.0
- New Feature. Now you can delete individual court case by pressing "Delete" key
- Improvement. Various color and layout tweakings

v1.4.0.0
- Added supports for LSPDFR 0.4.3 
- Improvement. Remove the auto-dismissal of stopped ped (by STP) after player is handing over the citation
- Improvement. Various color and layout tweakings
- Fixed Bug. When citation and arrest records are too many, they may overflow the panel screen

v1.3.0.0
- New Feature. Added "Probation/Parole" status on the Ped Record
- Improvement. Now, the charge penalty can also be a combination of fine and probation/jail time. Please make sure to update replace Charges.xml with the new one from this version
- Improvement. Citation and charge record lists are not properly sorted
- Improvement. Optimized Outcomes text in Court Case to make it more readable

v1.2.0.0
- Major Feature Fix. The mouse pointer now should work properly on all screen resolutions
- New feature. Added "IsPausedWhenOpen" parameter in the CompuLite.ini file to set the "game pause" state when CompuLite is active
- New feature. Added "EnableScreenTransition" parameter in the CompuLite.ini file to enable/disable the grainy screen transition when opening CompuLite
- Fixed Bug. The plugin version on top right corner was not updated properly
- Fixed Bug. Sometimes we cannot click the create citation and charge button
- Fixed Crash. Sometimes LSPDFR crashes when we tried to click "Owner Record" on the vehicle record panel

v1.1.0.0
- Tweaked ped record panel layout position
- Tweaked vehicle record panel layout position
- Tweaked court case record panel layout position

v1.0.0.0
- Initial release
