
Cartel Enforcer IL2CPP
Cartel Enforcer adds new features and challenges to the Cartel, including new ambush locations, events, and a better dealer robbery system. Experience the drive-by events, take on mini-quests, and influence the enforced Cartel's presence in new ways!Game version: 0.4.0 and higher (default or beta game version)
CartelEnforcer-IL2Cpp.dll SHA 256 File Hash: 6FEABA4D7DD6AB1EEB6B6F8796ADF2123720EB4617EDFA3C5340E8AC99F5C20C
Cartel Enforcer
Requires Melon Loader
Cartel Enforcer adds new features and challenges to the Cartel, including new ambush locations, events, and a better dealer robbery system. Experience the drive-by events, take on mini-quests, and influence the enforced Cartel's presence in new ways!
Table of Contents
- Features
- Installation
- Configuration
- Events and Activities
- End Game Quests
- Modifying Cartel Dealers
- Debug Mode
- In Multiplayer
- Modifying Spawns
Features
- Adds more Cartel Ambush locations from the ambush.json file.
- Allows configuration of default ambush locations, spawns, and radius from the default.json file.
- Realistic Robberies: Overhauled dealer robberies where a robber actually spawns to fight the dealer. Defend the dealer to reclaim stolen items and money, or chase down the escaping robber.
- Drive-By Events: Experience drive-by attacks by Thomas in designated areas when the Cartel is hostile.
- Mini-Quests: Take on missions from select NPCs to find Cartel dead drops and weaken their regional influence.
- End Game Quests: 2 New Quests where you get to fight enforced cartel members and weaken their influence across the entire Hyland Point.
- Intercept Deals: A new event where a Cartel Dealer attempts to intercept player deals and additionally sends Cartel Dealers to deal more often.
- Cartel Gatherings: Group of 3 Cartel Goons will spawn during day time at random locations to gather and chill. Killing Cartel Dealers will make the gatherings hostile. Gatherings frequency and hostility is dynamic based on the amount of Cartel Dealers killed.
- Enhanced Cartel Dealers: Cartel dealers are now officially bug fixed in this mod and they will roam the map by default. They will try to intercept pending deal requests and dealers active deals. Cartel Dealers can be configured from the CartelEnforcer/Dealers/dealer.json file.
- Persistence for Stolen Items: Stolen items are now saved per save file.
- Debug Mode: Visualize all locations, trigger events manually for testing.
Installation
- Install Melon Loader from a trusted source like the official MelonWiki.
- With Melon Loader install version 0.7.0 for Schedule I (0.7.1 is incompatible in IL2CPP)
- Manually download the correct .zip file and unzip it.
- Copy the .dll file and the Cartel Enforcer folder into your Mods folder.
Configuration
You can customize the mod's settings through the config.json file.
- Open the CartelEnforcer folder inside your Mods directory.
- Open the config.json file. Its contents by default are:
{
"debugMode": false,
"activityFrequency": 0.0,
"activityInfluenceMin": 0.0,
"ambushFrequency": 1.0,
"deadDropStealFrequency": 1.0,
"cartelCustomerDealFrequency": 1.0,
"cartelRobberyFrequency": 1.0,
"driveByEnabled": true,
"realRobberyEnabled": true,
"miniQuestsEnabled": true,
"interceptDeals": true,
"enhancedDealers": true,
"cartelGatherings": true,
"endGameQuest": true,
"endGameQuestMonologueSpeed": 1.0
}
debugMode:true: Show debug messages, visualize spawn locations, and display coordinates.false: Hides debug content. The cartel features will still be active.
activityFrequency: Adjusts how often Cartel activities occur.1.0: Activities happen roughly 10 times more frequently.-1.0: Activities happen roughly 10 times less frequently.0.0(Default): Activities happen at the game's default frequency.
activityInfluenceMin: Changes the minimum Cartel Influence required for activities.1.0: Activities will rarely happen, as they require maximum regional influence.-1.0: Activities do not require any regional influence and can happen anywhere.0.0(Default): Influence requirements are set to the game's default.
ambushFrequency: Adjusts the frequency of Ambush events.1.0: Ambush can happen as often as every 1 in-game hour.0.0: Ambush can happen at most once every 2 in-game days.-1.0: Ambush can happen at most once every 4 in-game days.
deadDropStealFrequency: Adjusts the frequency of Dead Drop Steal events.1.0: Can happen as often as every 1 in-game hour.0.0: Can happen at most once every 2 in-game days.-1.0: Can happen at most once every 4 in-game days.
cartelCustomerDealFrequency: Adjusts the frequency of Cartel Customer Deal events.1.0: Can happen as often as every 1 in-game hour.0.0: Can happen at most once every 2 in-game days.-1.0: Can happen at most once every 4 in-game days.
cartelRobberyFrequency: Adjusts the frequency of Cartel Robbery events.1.0: Can happen as often as every 1 in-game hour.0.0: Can happen at most once every 2 in-game days.-1.0: Can happen at most once every 4 in-game days
driveByEnabled:true: Enables drive-by events.false: Disables drive-by events.
realRobberyEnabled:true: Enables the realistic robbery system.false: Disables the realistic robbery system.
miniQuestsEnabled:true: Enables mini-quests.false: Disables mini-quests.
interceptDeals:true: Enables the Intercept Deals event.false: Disables the event.
enhancedDealers:true: Enables the Enhanced Cartel Dealers featurefalse: Disables the feature.
cartelGatherings:true: Enables the Cartel Gatherings eventfalse: Disables the event.
endGameQuest:true: Enables the generation of End Game Quest.false: Disables the generation.
endGameQuestMonologueSpeed:1.0: Monologue messages are displayed for roughly 5 seconds0.0: Monologue messages are displayed for roughly 10 seconds
Events and Activities
Realistic Robberies
When a dealer is being robbed, a robber will spawn and engage them in a fight. Your actions affect the regional Cartel influence:
- Robber defeated: If the robber is killed or knocked out before the dealer dies, regional influence decreases by 80. If the robber is knocked out while escaping, regional influence decreases by 25.
- Player flees: If you run out of range, regional influence increases by 20.
- Successful escape: If the robber kills the dealer and reaches a safehouse, regional influence increases by 50.
Intercept Deals
This is a new type of event where the Cartel actively attempts to intercept one of your deals.
- The event can only occur between 16:20 and 04:20 and when the Cartel is hostile.
- Randomized Frequency of Intercept Deals feature is tied to the Activity Frequency config value
- Only deals with less than 5 hours and more than 1 hour and 30 minutes remaining can be intercepted.
- If the player is within 40 units of the customer, the intercept is canceled.
- The Cartel Dealer can have your Stolen Items in their inventory
- Event Timeline:
- When the event starts, the quest icon on the left side of the screen changes to the Benzies logo.
- A timer of 30 seconds begins before the Cartel dealer starts their intercept.
- Outcomes:
- If you complete the deal within the 30 second grace period, Cartel influence decreases by 100 and your relationship with the customer increases slightly more.
- If you complete the deal after the grace period but before the Cartel dealer does, Cartel influence decreases by 100 and your relationship with the customer increases slightly more.
- If the Cartel dealer successfully intercepts the deal, regional influence increases by 100, and your relationship with the customer decreases to the next tier below.
Drive-By Events
These events only happen when the Cartel is hostile.
- Only happens at Night Time from 22:30 to 04:00
- Thomas will spawn in a car and try to shoot the player.
- They are triggered when the player is near one of the 11 designated hotspots (common dealing locations, homes, and businesses).
- These events have a randomized cooldown of 16-48 in-game hours.
- Their frequency can be adjusted with the
activityFrequencyparameter.
Mini-Quests
Mini-quests can be obtained from select NPCs (Anna, Fiona, Dean, Mick, or Jeff).
- The quest-giving NPCs are chosen randomly every 4-6 ingame hours. Random Choice prefers Unlocked NPCs more.
- Refusal Rate: The chance an NPC will refuse to give you a quest is now based on your relationship with them. It ranges from a 40% chance (at best relations) to a 70% chance (at worst relations).
- Time Window: When asking the NPC for rumours during 12:00 to 18:00, the NPC has higher likelihood of giving the quest.
- Payment: The cost to get a tip is now dynamic, ranging from $100 (at best relations) to $500 (at worst relations).
- Dead Drop Location: Based on the NPC relations there is 60% chance (at best relations) to tell exact location of the dead drop, and 40% chance to tell only the region. At worst relations there is 30% chance to tell the exact location and 70% chance to tell only the region.
- You have a 60 seconds to find the dead drop.
- Success: If you find the dead drop in time, you get +100 XP and the regional influence decreases by 25.
- Failure: If you fail to find it, the items vanish and regional influence increases by 50.
- Loot Pools: One of the following two pools is selected for each quest:
- Common (80% chance): 3-10 items chosen from: Cocaine, Meth, Green Crack Seed, OG Kush Seed.
- Rare (20% chance): 1 item chosen from: Silver Watch, Gold Watch, Silver Chain, Gold Chain, Old Man Jimmy's, Brut du Gloop.
- Stolen Items: Mini-quest rewards now also include some of the items stolen by the Cartel. This is additional to the Loot Pool selected drop.
Cartel Gatherings
Cartel Gatherings occur around the map and are dynamic in frequency and hostility. The gatherings are adapted based on Cartel Dealers deaths. Killing Cartel Dealers causes gatherings to become more frequent and more hostile. Gatherings primarily occur around the daytime in groups of 3 Cartel Goons.
- Killing the gathering Cartel Goons will lower regional cartel influence by 25
- If Gathering is not interrupted by player for 2 ingame hours, regional influence will rise by 5
End Game Quests
All end game quests scale in difficulty based on the total cartel influence across all regions. Higher total influence will result in enemies having more HP and being overall more lethal and harder to kill. XP Rewards are also scaled based on the total cartel influence to compensate for difficulty.
Unexpected Alliances
The End Game Quest can be started by speaking to Manny (the Warehouse Fixer). This Quest can be completed only once per session.
Note: The Unexpected Alliances Quest is in early phase development and is subject to change in content, difficulty and rewards.
-
Quest Prerequirements:
- Cartel must be Hostile
- Player must have Suburbia region unlocked
- Player must be atleast Enforcer rank
-
Upon paying the $5000 Bribe to Manny, you get a custom active quest:
- First you must intercept cartel dead drops twice (the Mini Quest in this document)
- After intercepts, you must wait for Manny to arrange a meeting and send a text.
- After player attends the meeting and finishes the dialogue they get the final quest step
- Kill the Cartel Brute
- If you run more than 70 units away from the Brute the Quest will fail
- If the Brute runs more than 70 units away from its spawn position the Quest will fail
- The Brute enters a Rage Stage when low on HP, starting to drink Cuke to regain health and having random sprint speed boosts
-
Quest Rewards:
- XP Based on Total Cartel Influence (850 - 1700 XP)
- You get a Gold Watch, Gold Chain and shotgun shells from the Cartel Brute inventory
- Cartel Brute has a ~33% chance to drop a Shotgun
- Customer relationships increase by 5% for all unlocked customers
- All unlocked regions have their Cartel Influence decreased by 25%
- And lastly but most importantly: Bragging Rights
Infiltrate Manor
The End Game Quest can be started by speaking to Ray between 18:15 and 19:00 when they are smoking a cigarette near the courthouse. This Quest can be completed only once per session.
Note: The Infiltrate Manor Quest is in early phase development and is subject to change in content, difficulty and rewards.
-
Quest Prerequirements:
- Cartel must be Hostile
- Player must have Suburbia region unlocked
- Player must be atleast Enforcer rank
-
Upon paying the $2500 Bribe to Ray, you get a custom active quest:
- First you must investigate the forest near Manor
- After investigating, return to Ray to obtain more information
- Wait for Night to arrive before breaking into Manor
- Break in through the back door of Manor
- Kill Manor Goons and steal their loot
- Investigate the Manor Upstairs rooms and find Thomas' safe
- Leave the Manor before police arrive
-
Quest Rewards:
- XP Based on Total Cartel Influence (600 - 1200 XP)
- Ray will give you -15% discount from all properties and businesses until the game is exited
- All unlocked regions have their Cartel Influence decreased by 15%
- Thomas' safe is filled in order to up to 5 items max from the loot table below
| Item | Drop Chance | Quantity | Notes |
|---|---|---|---|
| M1911 Magazine | 100% | 1 | This item is a guaranteed drop. |
| M1911 Pistol | 33.4% | 1 | |
| Cocaine | 10% | 12-20 | |
| Gold Bar | 5% | 1-3 | This drop prevents cash from spawning. |
| Cash | High Chance | $800-$4000 | Will spawn if a gold bar does not. The amount is rounded to the nearest $100. |
| Silver Watch | 20% | 1 | |
| Silver Chain | 20% | 1 | |
| Stolen Cartel Item | 80% | 1 | Only spawns if the cartelStolenItems pool has items. |
Enhanced Cartel Dealers
You can customize the Cartel Dealers' settings through the dealer.json file.
- Open the CartelEnforcer/Dealers folder inside your Mods directory.
- Open the dealer.json file. Its contents by default are:
{
"CartelDealerMoveSpeedMultiplier": 1.65,
"CartelDealerHP": 200.0,
"CartelDealerWeapon": "M1911",
"StealDealerContractChance": 0.2,
"StealPlayerPendingChance": 0.2,
"DealerActivityDecreasePerKill": 0.25,
"DealerActivityIncreasePerDay": 0.15,
"SafetyThreshold": -0.7,
"SafetyEnabled": true,
"FreeTimeWalking": true
}
CartelDealerMoveSpeedMultiplier: Adjusts the movement speed of Cartel Dealers (Range 0.1 - 3.0)CartelDealerHP: Sets the total health points for a Cartel dealer (Range 10.0 - 2000.0)CartelDealerWeapon: Specifies the weapon used by Cartel dealers. Supported values are: "M1911", "Knife" and "Shotgun".StealDealerContractChance: Controls the probability for the Cartel Dealer stealing Players hired dealers active contracts. (Range 0.0 - 1.0)StealPlayerPendingChance: Controls the probability for the Cartel Dealer stealing Players pending deal requests. (Range 0.0 - 1.0)DealerActivityDecreasePerKill: A decrease in dealer activity for each kill the player makes. (Range 0.0 - 1.0)DealerActivityIncreasePerDay: An increase in dealer activity for each in-game day that passes. (Range 0.0 - 1.0)SafetyThreshold: Defines the minimum value required for a dealers to stop leaving their houses. This will cause them to stay inside if too many dealers are killed. (Range -1.0 - 1.0)SafetyEnabled: When set totrue, this enables the usage of SafetyThreshold.FreeTimeWalking: Whentrue, dealers will randomly walk around when they are not performing an active task. Whenfalse, they will remain stationary at their apartment door when spawning.
Debug Mode
In debug mode, you can see various visual cues and use keybinds to test features.
The Debug Mode does not log anything into console in version 1.4.0 and above for performance reasons. For Console Logs you need to build the dll file from source code using DEBUG configuration. See GitHub BUILD.md for more info.
- Cubes: Visualize ambush positions. Their size corresponds to the detection radius and their color is based on the region. Standing under a cube will eventually trigger an ambush.
- Cyan Beams: Visualize the four spawn points for each cube.
- Orange Spheres: Show the locations of drive-by events triggers. Standing under the Sphere will eventually trigger a Drive-By.
- Keybinds:
Left CTRL + R: Trigger a Dealer Robbery at the nearest dealer.Left CTRL + G: Trigger an instant drive-by at the nearest location.Left CTRL + H: Give a mini-quest to one of the select NPCs.Left CTRL + L: Log internal mod data to the console. ( Only Debug Builds )Left CTRL + T: Trigger an Intercept Deal event.Left CTRL + Y: Generate the Unexpected Alliances Quest dialogue option for Manny, without checking prerequirements.Left CTRL + U: Generate the Infiltrate Manor Quest dialogue option for Manny, without checking prerequirements.Left CTRL + I: Place a non buildable safe (Do not use, left for future debugging and testing purposes)Left CTRL + O: Replaces the current Goon Pool with extended version (Do not use, left for future debugging and testing purposes)Left CTRL + P: Instantly spawn a Cartel Gathering at a random location
In Multiplayer
For multiplayer to function correctly, all players must have the same default.json, ambush.json and config.json content.
Not all events and activities added by this mod support multiplayer fully and might have bugs on server clients.
Modifying Spawns
You can add or modify custom ambush locations.
- Open the
Mods/CartelEnforcer/Ambush/ambush.jsonfile. - Edit existing entries or add new ones. Each entry has:
mapRegion: A number from0-5for the region.ambushPosition: The X, Y, and Z coordinates of the trigger area.spawnPoints: At least four spawn points for enemies (only X and Z values matter).detectionRadius: A decimal number for how close the player must be to theambushPosition.
{
"mapRegion": 5,
"ambushPosition": {
"x": 143.05,
"y": 1.75,
"z": -16.73
},
"spawnPoints": [
{
"x": 138.56,
"y": 0.0,
"z": -38.61
},
{
"x": 128.19,
"y": 0.0,
"z": -9.84
},
{
"x": 135.87,
"y": 0.0,
"z": -6.18
},
{
"x": 155.29,
"y": 0.0,
"z": -23.90
}
],
"detectionRadius": 10.0
},
Modifying Default Spawns
- Open
Mods/CartelEnforcer/Ambush/default.json. - You can only modify the values here; do not add or remove any ambushes.
- If the game receives a new update, delete
default.jsonto ensure your configuration is up to date. It will be recreated the next time you load a save.
Modifying Cartel Stolen Items
- Open
Mods/CartelEnforcer/CartelItems/(organisation name).json. - You can modify the values here and change quantity of items as you wish or add new ones. Make sure the item ID is always a valid id.
- If you want to reset the stolen items in the specific save, you can delete the file and it will get regenerated.
Note: The
config.json,default.jsonand persistent cartel stolen items files will be created automatically in theMods/CartelEnforcer/directory if they are missing.
Contribute, Build from Source or Verify Integrity -> GitHub
Finance the development or support my creations -> Ko-fi