From 5e56a0ee1b63a771e9d936dc86e41de0ecfb0db2 Mon Sep 17 00:00:00 2001 From: Dan Date: Thu, 5 Mar 2020 20:56:35 +0000 Subject: [PATCH] Create README.md --- README.md | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 122 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..151cf80 --- /dev/null +++ b/README.md @@ -0,0 +1,122 @@ +# Wraith ARS 2X +The **Wraith ARS 2X** (Wraith Advanced Radar System) is a realistic police radar that takes heavy inspiration from the real Stalker DSR 2X radar system. It includes a plethora of features from the DSR 2X such as the new operator menu, to improve the realism and experience whilst using the newest instalment from the collection of Wraith radar systems. Previously with WraithRS, vehicle speeds were only displayed in the target window, with no priority to certain vehicles (such as large and slower vehicles, or smaller and faster vehicles). The Wraith ARS 2X tracks both large and faster, smaller targets and displays the speeds of both in the target windows, meaning the radar can track 4 different speeds with both antennas turned on and transmitting. Alongside the new radar system is also a plate reader that scans in front and behind the patrol vehicle, a BOLO plate can also be set, but developers can also hook into the scanner to link it into other resources. + +## Installation +--- +Installing the Wraith ARS 2X into your FiveM can be done by following the listed steps below. +1. Download the latest version of the resource from [here](https://github.com/WolfKnight98/wk_wars2x/releases) +2. Open the zip file and place the `wk_wars2x` folder into your server's resource folder +3. Open up your server configuration file and add `ensure wk_wars2x` to your resource start list + +It's now installed! When you boot your server you should see a Wraith ARS 2X message as well as the version check message. + +## Script configuration +--- +All of the configuration for the Wraith ARS 2X is done inside the `config.lua` file, below is a copy of the configuration file. All of the options have comments to describe what they do, along with the available options you can set. You have the ability to change the key binds for the large and small key set, the default operator menu options, and the default UI element scale and safezone. +```lua +-- Radar fast limit locking +-- When enabled, the player will be able to define a fast limit within the radar's menu, when a vehicle +-- exceeds the fast limit, it will be locked into the fast box. Default setting is disabled to maintain realism +CONFIG.allow_fast_limit = true + +-- Sets all of the controls +CONFIG.keys = +{ + -- Remote control key + -- The default key to open the remote control is 166 (F5 - INPUT_SELECT_CHARACTER_MICHAEL) + remote_control = 166, + + -- Radar key lock key + -- The default key to enable/disable the radar key lock is 182 (L - INPUT_CELLPHONE_CAMERA_FOCUS_LOCK) + key_lock = 182, + + -- Radar keybinds switch + -- The default key to switch the bind set is (K - INPUT_REPLAY_SHOWHOTKEY) + switch_keys = 311, + + -- Keys for a full size keyboard + [ "full" ] = { + -- Radar front antenna lock/unlock Key + -- The default full keyboard key to lock/unlock the front antenna is 111 (Numpad 8 - INPUT_VEH_FLY_PITCH_UP_ONLY) + front_lock = 111, + + -- Radar rear antenna lock/unlock Key + -- The default full keyboard key to lock/unlock the rear antenna is 112 (Numpad 5 - INPUT_VEH_FLY_PITCH_DOWN_ONLY) + rear_lock = 112, + + -- Plate reader front lock/unlock Key + -- The default full keyboard key to lock/unlock the front plate reader is 118 (Numpad 9 - INPUT_VEH_FLY_SELECT_TARGET_RIGHT) + plate_front_lock = 118, + + -- Plate reader rear lock/unlock Key + -- The default full keyboard key to lock/unlock the rear plate reader is 109 (Numpad 6 - INPUT_VEH_FLY_ROLL_RIGHT_ONLY) + plate_rear_lock = 109 + }, + + -- Keys for smaller keyboards + [ "small" ] = { + -- Radar front antenna lock/unlock Key + -- The default small keyboard key to lock/unlock the front antenna is 157 (1 - INPUT_SELECT_WEAPON_UNARMED) + front_lock = 157, + + -- Radar rear antenna lock/unlock Key + -- The default small keyboard key to lock/unlock the rear antenna is 158 (2 - INPUT_SELECT_WEAPON_MELEE) + rear_lock = 158, + + -- Plate reader front lock/unlock Key + -- The default small keyboard key to lock/unlock the front plate reader is 160 (3 - INPUT_SELECT_WEAPON_SHOTGUN) + plate_front_lock = 160, + + -- Plate reader rear lock/unlock Key + -- The default small keyboard key to lock/unlock the rear plate reader is 164 (4 - INPUT_SELECT_WEAPON_HEAVY) + plate_rear_lock = 164 + } +} + +-- Here you can change the default values for the operator menu, do note, if any of these values are not +-- one of the options listed, the script will not work. +CONFIG.menuDefaults = +{ + -- Should the system calculate and display faster targets + -- Options: true or false + ["fastDisplay"] = true, + + -- Sensitivity for each radar mode, this changes how far the antennas will detect vehicles + -- Options: 0.2, 0.4, 0.6, 0.8, 1.0 + ["same"] = 0.6, + ["opp"] = 0.6, + + -- The volume of the audible beep + -- Options: 0.0, 0.2, 0.4, 0.6, 0.8, 1.0 + ["beep"] = 0.6, + + -- The volume of the verbal lock confirmation + -- Options: 0.0, 0.2, 0.4, 0.6, 0.8, 1.0 + ["voice"] = 0.6, + + -- The volume of the plate reader audio + -- Options: 0.0, 0.2, 0.4, 0.6, 0.8, 1.0 + ["plateAudio"] = 0.6, + + -- The speed unit used in conversions + -- Options: mph or kmh + ["speedType"] = "mph" +} + +-- Here you can change the default scale of the UI elements, as well as the safezone size +CONFIG.uiDefaults = +{ + -- The default scale of the UI elements. + -- Options: 0.25 - 2.5 + scale = + { + radar = 1.0, + remote = 1.0, + plateReader = 1.0 + }, + + -- The safezone size, must be a multiple of 5. + -- Options: 0 - 100 + safezone = 20 +} +``` \ No newline at end of file