🚨 Modding Guide: How to create ELS mods!

Starting with The Traffic Management Update, Police Simulator: Patrol Officers will officially support ELS Modding.

In this guide, we will explain how you create, upload and download your ELS mods for Police Simulator: Patrol Officers!

Example Mods

Welcome to our Modding Guide!

ELS Modding is quite a bit more complex than the previous mods related to skins, uniforms, and names. To make sure you know where and how to start, we've put together a collection of example mods.

Check out the Example Mods Collection in the Steam Workshop.

We've also updated the Official Modding Kit which now contains the Example Mods as well.

After downloading the Example Mods and the Modding Kit, you can find the files here:

C:\Program Files (x86)\Steam\steamapps\workshop\content\997010

How to create a Modpack

This guide focuses specifically on ELS Modding and requires a basic understanding of how the creation of mods for Police Simulator: Patrol Officers works.

To learn more about it, we highly recommend taking a look at our previous guide in which you get to know everything you need to know about creating, uploading and downloading mods for the game. In that guide, you can also learn more about the nature of Override Mods.

Check out the official guide on Steam:
https://steamcommunity.com/sharedfiles/filedetails/?id=2778896763
By the way! endline has created an incredibly nice Mod Editor dedicated to ELS Modding. It greatly helps with the creation of your ELS Mods!

Check it out here:

https://steamcommunity.com/sharedfiles/filedetails/?id=2816922331

Supported Override Keys in the manifest.json file

In the usual manifest.json file (to be found at <ModDir>/FancyMod/manifest.json), we support the following Override Keys for ELS Modding:

OverrideKey	OverrideValue Type & Example	Description
POLICE_CAR1_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_Cruiser/ElsLightPattern.json"	Replaces the ELS light pattern of the cruiser saved in a level sequence with the pattern defined in the json file
POLICE_CAR1_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_Cruiser/BlipLightPattern.json"	Replaces the Blip light pattern of the cruiser saved in a level sequence with the pattern defined in the json file
POLICE_CAR2_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_Interceptor/ElsLightPattern.json"	Replaces the ELS light pattern of the interceptor saved in a level sequence with the pattern defined in the json file
POLICE_CAR2_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_Interceptor/BlipLightPattern.json"	Replaces the Blip light pattern of the interceptor saved in a level sequence with the pattern defined in the json file
POLICE_CAR3_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_Utility/ElsLightPattern.json"	Replaces the ELS light pattern of the utility saved in a level sequence with the pattern defined in the json file
POLICE_CAR3_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_Utility/BlipLightPattern.json"	Replaces the Blip light pattern of the utility saved in a level sequence with the pattern defined in the json file
POLICE_CAR4_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_UTV/ElsLightPattern.json"	Replaces the ELS light pattern of the UTV saved in a level sequence with the pattern defined in the json file
POLICE_CAR4_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_UTV/BlipLightPattern.json"	Replaces the Blip light pattern of the UTV saved in a level sequence with the pattern defined in the json file
POLICE_CAR5_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_CPV/ElsLightPattern.json"	Replaces the ELS light pattern of the CPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR5_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_CPV/BlipLightPattern.json"	Replaces the Blip light pattern of the CPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR6_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_GPV/ElsLightPattern.json"	Replaces the ELS light pattern of the GPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR6_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_GPV/BlipLightPattern.json"	Replaces the Blip light pattern of the GPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR7_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_MPV/ElsLightPattern.json"	Replaces the ELS light pattern of the MPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR7_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_MPV/BlipLightPattern.json"	Replaces the Blip light pattern of the MPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR8_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_WPV/ElsLightPattern.json"	Replaces the ELS light pattern of the WPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR8_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_WPV/BlipLightPattern.json"	Replaces the Blip light pattern of the WPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR9_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_IPV/ElsLightPattern.json"	Replaces the ELS light pattern of the IPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR9_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_IPV/BlipLightPattern.json"	Replaces the Blip light pattern of the IPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR10_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_SPV/ElsLightPattern.json"	Replaces the ELS light pattern of the SPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR10_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_SPV/BlipLightPattern.json"	Replaces the Blip light pattern of the SPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR11_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_EPV/ElsLightPattern.json"	Replaces the ELS light pattern of the EPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR11_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_EPV/BlipLightPattern.json"	Replaces the Blip light pattern of the EPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR12_ELS_ LIGHT_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_FPV/ElsLightPattern.json"	Replaces the ELS light pattern of the FPV saved in a level sequence with the pattern defined in the json file
POLICE_CAR12_ELS_ BLIP_PATTERN	"OverrideValue": "%MODPACK%/PoliceCar_FPV/BlipLightPattern.json"	Replaces the Blip light pattern of the FPV saved in a level sequence with the pattern defined in the json file

Supported Override Keys in the individual ElsLightPattern.json & BlipLightPattern.json file

Use this reference image when working on your mod. Please click on the image for a higher resolution so that you can actually read the text.

Some example directions for these Override Keys could look like this:

• <ModDir>/FancyMod/PoliceCar_Cruiser/manifest.json
  
• <ModDir>/FancyMod/PoliceCar_Interceptor/manifest.json
  
• <ModDir>/FancyMod/PoliceCar_Utility/manifest.json

We want to provide you with a solution that allows for a maximum of customizability when it comes to adjusting the patterns. This includes the adjustment of emission levels, several addressees, color and frequency.

Further down below, we provide a self-explanatory example for changing a select light pattern. In these individual ElsLightPattern.json and BlipLightPattern.json files we support the following Override Keys:

Flasher Patterns

OverrideKey	OverrideValue Type & Example	Description
"FlasherEmissionLevel"	float value: "0.5"	This value adjusts the emission level of the flashers.
"OverrideKey"	Name of the addressed flasher: "Front_Left_1" "Front_Left_2" "Front_Left_3" "Mirror_Left_1" "Side_Left_1" "Side_Left_2" "Back_Inner_Left_1" "Back_Inner_Left_2" "Back_Inner_Left_3" "Top_Back_Left_1" "Top_Back_Left_2" "Top_Front_Left_1" "Top_Front_Left_2" "Top_Side_Left_1" "Top_Lower_Back_Left_1" "Top_Lower_Back_Left_2" "Top_Lower_Back_Left_3" "Front_Right_1" "Front_Right_2" "Front_Right_3" "Mirror_Right_1" "Side_Right_1" "Side_Right_2" "Back_Inner_Right_1" "Back_Inner_Right_2" "Back_Inner_Right_3" "Top_Back_Right_1" "Top_Back_Right_2" "Top_Front_Right_1" "Top_Front_Right_2" "Top_Side_Right_1" "Top_Lower_Back_Right_1" "Top_Lower_Back_Right_2" "Top_Lower_Back_Right_3"	The name of the flasher that the player wants to address and change. If a flasher does not get addressed the default pattern will be played for this player.
"ColorOverrideValue"	RGB Value : "rgb(209, 34, 41)"	This value changes the light pattern for the overridden flasher.
"FrequencyOverrideValues"	Boolean list for each frame: [ "False", "False", "True", "False", "False","True", "False", "False", "True", "False", "False", "True", "False","False", "True", "False", "False", "True", "False", "False", "True", "False", "False", "True", "False","False", "True", "False", "False", "True", ... ]	The actual ELS light pattern. Each second consists of 30 frames. For an easy use it's recommended that for each second 30 booleans are used. ElsLightPattern.json: 5 seconds x 30 frames = 150 booleans BlipLightPattern.json: 1 seconds x 30 frames = 30 booleans If the player uses more than the maximum boolean amount all the rest will not be considered. If the player uses less than the maximum boolean amount the booleans get evenly distributed between the LoopTime (like that it’s hard to predict how the end result will look like). The booleans will create keyframes where the system interpolates the light intensity between 0 and the value set in the FlasherEmissionLevel Key. The booleans are not fixed states. When: "True", "False", "False" the light interpolates down from one Keyframe to the other and is then fully turned off. When: "False", "True" the light interpolates up from one keyframe to the other and is then fully turned on, but the light will already be turned on after the false keyframe passed.

"TurretLightPatterns"

OverrideKey	OverrideValue Type & Example	Description
"OverrideKey"	Name of the addressed turret : "EmergencyLightLeft_Front" "EmergencyLightLeft_Middle" "EmergencyLightLeft_Rear" "EmergencyLightRight_Front" "EmergencyLightRight_Middle" "EmergencyLightRight_Rear"	The name of the flasher that the player wants to address and change. If a flasher does not get addressed the default pattern will be played for this player.
"ColorOverrideValue"	RGB Value : "rgb(209, 34, 41)"	The name of the flasher that the player wants to address and change. If a flasher does not get addressed the default pattern will be played for this player.
"ColorOverrideValue"	RGB Value : "rgb(209, 34, 41)"	This value changes the light pattern for the overridden turret.
"LoopTimeOverrideValue"	float value : 1	This float changes the duration of the ELS sequence specified in "FrequencyOverrideValues" in seconds. The default value is also the maximal value, which is 5 seconds. Higher values are clamped down to 5s. If the time is larger than 5s the key frames are squashed down into the 5s duration (this might lead to skipped frames and weird flickering when the value is higher than 10s). If the time is smaller than 5s the frames are repeated until the 5s are full. The last loop might be cut off. Therefore in the siren light pattern a value of 5.0 is recommended or not to use this override key at all, so that the default value will be used. For the blip light pattern only the first second is played. Therefore in the blip light pattern a value of 1.0 is recommended. Each 1s long section of the 5s is looped 3 times before going to the next
"FrequencyOverrideValues"	Integer: [ 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80 ]	This value must be between 0 and 100, else it will be clamped either to 0 or 100. This value changes the light intensity

For 'LoopTimeOverrideValue', we have an additional graphic prepared for you which explains the timings in an even easier way:

Example for Light Patterns

"Flashers" :
 {
      "FlasherEmissionLevel": "0.5",
       "FlasherPatterns": [ {
            "OverrideKey": "Front_Left_1"
            "ColorOverrideValue": "rgb(209, 34, 41)",
            "LoopTimeOverrideValue": 5,
            "FrequencyOverrideValues": [ "False", "False", "True", "False",
            "False", "True", "False", "False", "True", "False", "False", "True",
            "False", "False", "True", "False", "False", "True", "False", "False",
            "True", "False", "False", "True", "False", "False", "True", "False",
            "False", "True", "False", "False", "False", "False", "True", "True",
            "True", "False", "False", "False", "False", "True", "True", "True",
            "False", "False", "False", "False", "True", "True", "True", "False",
            "False", "False", "False", "True", "True", "True", "False", "False",
            "True", "True", "True", "True", "False", "False", "True", "True",
            "True", "True", "False", "False", "True", "True", "True", "True",
            "False", "False", "True", "True", "True", "True", "False", "False",
            "True", "True", "True", "True", "False", "False", "False", "False",
            "False", "False", "False", "False", "False", "False", "False", "False",
            "False",  "False", "False", "False", "False", "False", "False", "False",
            "False", "False", "False", "False", "False", "False", "False", "False",
            "False", "False", "False", "False",  "True", "True", "True", "True",
            "True", "True", "True", "True", "True", "True", "True", "True",
            "True", "True", "True", "True", "True", "True", "True", "True",
            "True", "True", "True", "True", "True", "True", "True", "True",
            "True", "True" ] 
            },
            {
                        ...
            }
       ]
 },
       "TurretLightPatterns": [
 {
             "OverrideKey": "EmergencyLightLeft_Front",
             "ColorOverrideValue": "rgb(209, 34, 41)",
             "LoopTimeOverrideValue": 5,
             "FrequencyOverrideValues": [ 80, 0, 0, 0, 80, 80, 0, 0, 0, 80,
             80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80,
             0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80, 80, 0, 0, 0, 80 ]
             },
             {
                        ...
            }
       ]
}

Attention:
The final result can look a bit different than imagined because each full second gets repeated multiple times (around 3 times) before the next second gets played.

How to replace ELS Sounds

The steps to override ELS Sounds with custom ones are very similar to those connected to the override of skins and uniforms.

To replace the unique sounds, you can use the following Override Keys:

OverrideKey	OverrideValue Type & Example	Description
POLICE_CAR1_ELS_SOUND	"OverrideValue": "%MODPACK%/PoliceCar_Cruiser/Siren.wav" Analogous for all other sound overrides Allowed file formats are .wav, .mp3 and .flac	Replaces the ELS Siren sound for the Cruiser patrol car.
POLICE_CAR1_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the Cruiser patrol car.
POLICE_CAR1_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the Cruiser patrol car.
POLICE_CAR1_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the Cruiser patrol car.
POLICE_CAR2_ELS_SOUND	See above	Replaces the ELS Siren sound for the Interceptor patrol car.
POLICE_CAR2_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the Interceptor patrol car.
POLICE_CAR2_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the Interceptor patrol car.
POLICE_CAR2_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the Interceptor patrol car.
POLICE_CAR3_ELS_SOUND	See above	Replaces the ELS Siren sound for the Utility patrol car.
POLICE_CAR3_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the Utility patrol car.
POLICE_CAR3_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the Utility patrol car
POLICE_CAR3_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the Utility patrol car.
POLICE_CAR4_ELS_SOUND	See above	Replaces the ELS Siren sound for the UTV.
POLICE_CAR4_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the UTV.
POLICE_CAR4_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the UTV.
POLICE_CAR4_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the UTV.
POLICE_CAR5_ELS_SOUND	See above	Replaces the ELS Siren sound for the CPV.
POLICE_CAR5_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the CPV.
POLICE_CAR5_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the CPV.
POLICE_CAR5_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the CPV.
POLICE_CAR6_ELS_SOUND	See above	Replaces the ELS Siren sound for the GPV.
POLICE_CAR6_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the GPV.
POLICE_CAR6_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the GPV.
POLICE_CAR6_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the GPV.
POLICE_CAR7_ELS_SOUND	See above	Replaces the ELS Siren sound for the MPV.
POLICE_CAR7_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the MPV.
POLICE_CAR7_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the MPV.
POLICE_CAR7_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the MPV.
POLICE_CAR8_ELS_SOUND	See above	Replaces the ELS Siren sound for the WPV.
POLICE_CAR8_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the WPV.
POLICE_CAR8_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the WPV.
POLICE_CAR8_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the WPV.
POLICE_CAR10_ELS_SOUND	See above	Replaces the ELS Siren sound for the SPV.
POLICE_CAR10_ELS_BLIP_SOUND	See above	Replaces the Blip Siren sound for the SPV.
POLICE_CAR10_ELS_Yelp_SOUND	See above	Replaces the Yelp Siren sound for the SPV.
POLICE_CAR10_ELS_HONK_SOUND	See above	Replaces the car honk/horn sound for the SPV.

Questions?

No worries, that can always happen!

If you need any support, we highly recommend taking a look at the Steam Forums.

Even better: Join our official Discord[discord.gg] and talk to other community members about everything related to modding! Our developers are also active there... so feel welcome :)

[IkbeNick0]

What are the replace names of the new Highway Patrol Expansion Pack?

[chebonaparte]

all the mods I see are only cosmetic so far, will there be functional mods that change settings and functions soon

[Vetr "Winter"]

This is awesome, is there a way to mod the save file of a game so u can progress faster?

[Piggsbuddy]

This is awesome. Thank you!

[Tropilac]

A game that started off well, grows into something great, AND now officially supports MODs!

[𝖛☆𝖑𝖙𝖆𝖌𝖊]

This is Amazing. I can not believe it =).