About This File
NOTICE
Police Search is not compatible with some recent versions of RPH. This will be looked into when the authors have some free time. I, ToastinYou, have left LSPDFR developing in the dust, however I have committed to helping FtDLulz maintain Police Search, and since he has been inactive that is my responsibility. I apologize for the lack of updates, but I will be attempting to push some updates out when I get some free time to work on Police Search. Sorry for the inconvenience.
Information
Police Search allows you to search vehicles and pedestrians for illegal or suspicious items, giving you a reason to put those suspects behind bars. Wondering why that lady ran from you when you went to go check her ID? Searching her vehicle may turn up the answer. In addition to frisking and searching peds and vehicles, Police Search also gives you quick and easy access to gear. In a firefight, you can always go to your cruiser's trunk and pull out vital gear such as armor and a carbine rifle that could give you an edge, and even save your life against more threatening opponents.
Police Search combines and replaces my old plugins, Vehicle Search and Ped Search.
Installation
The read-me contains all of the necessary installation instructions, though it is pretty simple: drag the Plugins folder in the downloaded zip to your main GTA V directory, and voila! You're finished. To install an add-on list .xml file, just drag it into the 'Lists' folder, located in 'Plugins\LSPDFR\PoliceSearch'.
Change any settings you want in 'Plugins\LSPDFR\PoliceSearch\PoliceSearch.ini'. You can customize the search time, whether you find legal (flavor text) items, the item find chance and keybindings among other things.
You can customize controller settings in the .ini file as well, if you use one!
How-To
Using the plugin is very simple. Police Search is an LSPDFR plugin, so you only need to load LSPDFR and go on duty for it to work! Go up to a vehicle door or a pedestrian and hit your search key (default: G) and you will begin searching the vehicle/pedestrian. Moving, getting too far away or pressing the search key again will cancel the search. Once the search is finished, a list of items will display in your chosen position (default: notification, bottom left), or a notification telling you that nothing of interest was found.
Developer API
Police Search also has an experimental API that allows developers to add or remove items from vehicles and pedestrians, and also allows them to check if a vehicle/ped has been searched. The process is similar to Albo's API so I have linked his forum post in the readme.
Once you've set up a project, the rest is easy. Most functions have XML documentation to explain what they are for. Creating your own custom item is fast; here's an example:
PoliceSearch.PoliceSearchItem illegalItem = new PoliceSearch.PoliceSearchItem("illegal item", "illegal", false, new string[] { "trunk", "ped" });
This would create an item called "illegal item" that has a legality of "illegal" (totally not obvious, right?). The legality gives the item its color (and you can even just put a color code instead). The false indicates that it is not a drug, and the string array tells us where it can be found. This item would not be able to be found in a vehicle's door or hood, for example.
Credits
All of the moderators, managers, and coders of LSPDFR deserve a big round of applause for making the site and LSPDFR itself as good as it is today!
Now co-author @ToastinYou for making me release this finally in the first place and for helping me to test it so no obvious bugs are missed. He also deserves a lot of credit for helping me keep the plugin working and possibly adding new features while I'm busy with life!
@FinKone for the original help when I was just starting off as a wee little developer!
@Albo1125 for his excellent plugins and help with getting my API to work correctly!
And everybody here -- for taking the time out of your day to read this! Thank you.
If you have any suggestions to make this plugin even better or have an issue, send me a PM about it!
What's New in Version 1.0.1
Released
- Fixed a bug which made it impossible to search motorcycles.
