Gunter Severloh

Description
Bandit Hideouts is a standalone but upgraded version of all the AMJM Transport mod bandit features, created by crossed99.
Both crossed and Gunter Severloh created the Bandit Hideouts mod, but Gunter maintains and updates the mod
    with crossed occasionally helping with code where needed.
LittleBigSmoak maintains and updates the Hideout Locations map for each update to the mod.

Features
Bandit Hideouts
The Bandit Hideouts mod adds many new hideouts across the RDR2 map for the player to discover and clear out.
Each hideout ranges in the number of bandits, but you can define in the ini of the mod how many bandits
a hideout will have, what gang will spawn there and how many reinforcements will come if any,
even if zombies will spawn there instead of bandits.

Hideout Locations Map
The hideout locations map is a high resolution map of the RDR2 world you can download and use as a reference to
see where all the hideouts, & ambush locations are at in the world.           
    The legend on the map will tell you what region a hideout or ambush location is in, what gang is there, each hideout/ambush
spot is marked with a colored skull icon to represent a hideout, and an X to represent an ambush location,
both a numbered and listed in the legend accordingly.  Icons on the map will indicate their exact locations.
Download
Google Drive:  59.5mb https://drive.google.com/drive/folders/1iLI3Yjmay0uw22f-0MUg0j0__DAEYlGK?usp=sharing

Credits: LittleBigSmoak & Moth-man

Ingame Blips & Icons
Hideout Locations Blip (icon)

A blip (icon) of a house with a skull inside it, will show up at the bottom left corner of your screen
 it means a hideout has spawned in and is nearby.
    If you pass by a hideout without attacking it, the map blip (icon) will disappear once your out of range of the hideout.
If you attack and clear the hideout then the blip on the map will be removed and your screen until the hideout timer is up.
        You can disable this icon if you wish through the included bandit hideouts.ini

Default spawned in hideout map blip

When a hideout spawns in, by default this icon will be showing on the map at the location of the hideout,
the player has 3 other choices of map icons they can use if they want to change it which can be done through the ini

Persistent Blip (icon)
The Persistent blip icon will show on every hideout location on the map whether your near a hideout or not,
if you clear a hideout the blip icon on the map will be removed until the spawn time for that hideout has returned.
   The persistent blip icons have their own icon type vs the one on screen. The icon can also be turned off in the ini, and
only the blip icon of a hideout will show on the map when the hideout spawns in.

Types of bandit hideouts
Each bandit hideout can be a house, camp, cabin, abandoned building, cave, mine, fort, ruin, and other places.

   Hideouts will spawn bandits in by chance when you're nearby, this means that if set in the Bandit Hideouts.ini
you set the chance to 100 then each time you come close to an area where a hideout would be then bandits
will spawn there for sure, the lower the chance then it becomes random or less.

Cleared hideout message
A small feature by default is if you cleared a hideout a message will show on the screen saying
       "You have cleared the hideout!"
you can disable this in the ini if you wish.

Earn money from clearing hideouts!
Yes you read that right, after killing all the bandits in a hideout, you will earn a random
amount of money ranging from $25 - $150
You can customize the amount you want to earn in the ini or set it to 0 to disable it.

Cleared hideout respawn
Once you clear a hideout you can set in the ini the cool down of how long before they respawn again.
If you set the respawn to 1 for example then in one hour from when you cleared the hideout bandits will spawn in again.

Hideout bandit/gang types
Each hideout will be populated with gang members for the area the hideout is in, for example:
Valentine area will have O'Driscoll members or a generic gang. Lemoyne/ Rhodes area will have Lemoyne Raiders, and a generic gang. Annesburg area will have Murfree gang members. Saint Denis area may have either Nightfolk, or a generic gang. Tall Trees area you will see the Skinner brothers gang. New Austin area you will see the Del Lobo gang. Grizzlies West (snow region) area will have a generic gang. Grizzlies East (snow region) area will have a generic gang. Guarma will have the Cuban Army and Nightfolk.
Disable individual Hideouts and Ambush points
This feature allows the player to disable any individual hideout and ambush point in the mod through the included ini
all you need to do is locate the hideout you want to disable through the downloadable map and then change the number from a 1 to a 0.
    There is a list of all hideouts and ambush points in the ini.
 
Custom Gangs in hideouts
Each hideout listed in the ini for the Disable Individual Hideouts list can either be disabled, or changed so it spawns another gang.
The gang types to choose from are the following:
// Gang Type Reference //
  Generic gang - 7   Murfree Brood - 8   Lemoyne Raiders - 9   O'Driscoll Boys - 10   Skinner Brothers - 11   Del Lobo gang - 12   Nightfolk -13   Cuban Army -14   Ku Klux Klan - 15   Wapiti Warriors - 16   United States Army - 17   Laramie gang - 18   Micah's gang - 19   Angelo Bronte's Mob - 20   Cornwall Goons - 21   Braithwaites - 22   Gray Family - 23   Foreman Brothers - 24   Bounty Hunters - 25                        Pinkertons National Detective Agency - 26 Chelonians - 27 Vampires - 28 Here is an example hideout in the ini that is listed in the Disable Individual Hideouts list:
ENABLE_ABANDONED_FACTORY=1
- With the setting at 1 the hideout spawns its default gang.
- With its setting at 0 the hideout is disabled and wont spawn.
- If the number is changed to a number from either 7-28 seen in the list above, then that hideout will spawn that gang based on the number. 

For example if we changed the number to say
ENABLE_ABANDONED_FACTORY=18
then the Laramies gang will spawn at that hideout instead of the default gang.
     Here is an article on how this works in more detail with a video demonstration/guide
https://www.nexusmods.com/reddeadredemption2/articles/435

Custom Gangs in Regions
A feature where you can define what gangs will spawn in what regions for hideouts, a list in the ini of all the regions
or areas on the map, each region has a default number, the number represents what gang will spawn in that region.
From the reference in the ini, you can change the number for the region for whatever gang you want to
spawn at the hideouts in those regions.  This feature is disabled by default.
 
Exact or random number of bandits in a hideout
The amount of bandits you can encounter in a hideout will be defined in the Bandit Hideouts.ini
there you can set the minimum and maximum numbers you will encounter, this is for all hideouts.
  If you set the number for both min/max the same you will get that exact amount, if you set the number to
exceed the default random min and max then the extra bandits will come as reinforcements.

Bandit Reinforcements
Bandits at hideouts can call in reinforcements, they will show up on horses and or on foot.
Reinforcements is set by chance in the ini, the higher the percentage (chance) then reinforcements will show.
Reinforcements also has a setting where you can define how many bandits will come, and if you only wanted
bandits on horses, or foot, or both, you also can disable reinforcements from coming in the ini.

Bandit Spawn Amount
In the included bandit hideouts.ini there is a list called spawn amount, this list will list every hideout/ambush point
and allow you to set a specific number that you want to spawn at a or each individual hideout.
This lets you taylor or customize hideouts based on how you want to play.
        Each hideout and ambush point has a default or base number of spawn points you can use this article reference
to get the base default number of each hideout:   LINK

Knowing the base number of a hideout or ambush point will tell you how many bandits can be spawned there.
For example: If you chose a hideout that had 10 bandits spawn positions that means if you set the spawn amount
to say 5 then only 5 bandits would spawn. If you set the number to say 15 then the extra 5 bandits would spawn
at the reinforcement spawn points.
    The would respawn at the reinforcement spawn points because there are only 10 available spawn points
at the hideout. The same applies to ambush points.

Bandits will chase the player
Bandits will chase you if you ride off or run away after attacking their hideout.

Bandit Ambushes
Ambushes are not dynamic they are built the same as hideouts and are at set locations.
Each ambush location can vary between 2-6 bandits that will attack you on foot if you enter an ambush location.
   If you run away on foot or on horse the bandits at the ambush location will chase after you either on foot or get on a horse.
Ambush locations are marked on the downloadable map with an X

Enable/Disable individual Ambush Points
This feature introduced in v1.18 gives the player the option to enable or disable an individual ambush location through the included ini,
all you need to do is refer to the map linked for download and decide which ambush location you want to disable for whatever reason,
you open up the ini file, locate the ambush point in the list, and just set the setting accordingly.

Bandit Posse on Horseback
As players explore the game world, they will randomly be attacked by bandits on horseback, these encounters can happen at any time.
In the Bandit Hideouts.ini you can define how often (how many ingame hrs) bandits will attack,
and a minimum and maximum number of bandits on horseback that will attack, you can disable this feature in the ini if you want to.

    Just to note they will mostly show up if your near or on a road, but i've had them show up in the middle of the wilderness too.
They can and will interfere with any story missions your doing, so best disable this feature in the ini if you plan on doing story missions.

Random Roaming Bandits
Bandits roaming the world, they will spawn in the area you are in and will be bandit/gang members
from that area so if your in Valentine Area then you might see a small group of O'Driscolls wandering around.
These bandits may be on foot, on horseback alone, in a group, or on a wagon, or both.
    You can also set in the ini if they attack you on sight or not, as well as disable them.

Hired Gunmen
Players can hire up to 9 gunmen to fight alongside them, to do so just talk to the barkeep in any saloon.
    These hired guns will assist the player in combat, making it easier to take on large groups of bandits or zombies.
You can hire up to 9 gunmen at a time. You can hire a random gunmen with their own gear and weapons. You can customize what they wear, and the weapons they carry. Hired Guns will not fight while in a town (can change this in the ini). Story characters are also available. You can use the 'Rest & Recover' option in the menu that will teleport your hired guns to you in case  you got separated, they'll be cleaned and their hats and weapons will be recovered if they lost them.
They automatically go into "sneak and hold fire" mode while you're crouching / sneaking outside of combat. If the "Allow revive" option is enabled, instead of dying they will go down into an injured state and be revived  by crouching close to their head until the 'Help' prompt fills up (10 seconds).
 Using the 'Wait for signal' command will make them stay and don't do anything until you signal to them by whistling. The 'Ride with me' command will prevent them from spawning in their own horse. If there's another free horse around they'll use that, but if not they'll ride with you on your horse.

Commands menu:
You can also give commands to them through their command menu, Numpad 1-9 keys by default.

Hired Gunmen Voice Lines
When you tell your hired gunmen to stay or follow, Arthur or John will actually say out loud those commands,
 and when your crouched and you tell your gunmen to stay Arthur or John will say it in a quiet voice.
This feature can also be enabled and disabled in the ini, and is enabled by default.

The command menu has some extra commands:
 Aim at person while the menu is up: Attack target, lasso target.  Aim at dead / hogtied person: pick up target.  Aim at horse: put carried body on horse.  Aim at downed hired gun: help up (it'll take them the same amount of time as for you).  Press numpad 0 to make all hired guns stay / follow
Zombies
As if bandits weren't enough to deal with, the mod also adds zombies to the game world.
    Disabled by default, you can enable them in the Bandit Hideouts.ini

There are some options in the ini to customize them, like the following:
Spawn frequency - this is how much more or less you will see of them. Day/night detection - this is a setting where you can set if the zombies detect you. Zombie health - this is how much a zombie can take before you kill them. Min and max - this will be the group size of how many groups of zombies. Min and max number during day or night. Zombies burst into flames upon dieing. Zombie lairs - this will change all the bandit hideouts to zombie lairs,         so instead of bandits spawning, zombies will.

Customization
All of the features in the mod can be customized by editing the Bandit Hideouts.ini file.
Each setting in the ini has a description on what it does and how to enable/disable it or adjust it.
   Open the ini file with notepad to edit it, also run it as administrator if you are being denied access.

Installation
Move the following files:
Bandit_Hideouts.asi Bandit_Hideouts.ini Bandit_Hideouts_CustomPeds.txt  to your RDR2 directory which can be found here:
C:\SteamLibrary\steamapps\common\Red Dead Redemption 2

Requirements
 Script Hook By Alexander Blade is required to run the mod.
https://www.dev-c.com/rdr2/scripthookrdr2/

Credits
Crossed99  for his help and support, and patience in helping me create and update this version of his great mod!
LittleBigSmoak & Moth-man for their help in creating the Bandit Hideouts map showing all the locations
of the hideouts, and sorting them based on color and gang.

Bandit Hideouts Youtube Channel
Gunter Severloh RDR2
Check the Bandit Hideouts Youtube Channel for gameplay, guides and how to videos on the mod.

Description
Hired Guns is a standalone version of the hired guns feature seen in my Bandit Hideouts mod, crossed and i created this
mod using the Bandit Hideouts mod. We disabled a number of codes and scripts to enable this mod to work on its own.
     This mod isn't meant to be used with Bandit Hideouts as its already in Bandit Hideouts, rather its a mod to be used
by those who are not using Bandit Hideouts, and want an upgraded version of the BodyGuard Spawner.
 
Hired Guns can also be found on the Nexus: https://www.nexusmods.com/reddeadredemption2/mods/4663

Features
Hire a gunmen that will travel with you and protect you from animal predators and bandits in the world.

Hire up to 7 gunmen at the following locations:
Annesberg Gunsmith Armadillo Saloon Blackwater Saloon Tumbleweed Saloon Rhodes Saloon St.Denis Saloon Strawberry Hotel Valentine Saloon - Hire a random gunmen, or customize one, make it a male or female, change their outfits, and set what guns they will carry.
- Hire and customize a character from the story.
- Your gunmen will sit at your campfire when you setup a campfire and rest and recover.

- You can use the 'Rest & Recover' option in the menu that will teleport your hired guns to you in case you got separated,
   they'll be cleaned and their hats and weapons will be recovered if they lost them.

- Gunmen will automatically go into "sneak and hold fire" mode while you're crouching / sneaking outside of combat.
- Revive your gunmen if they get shot and go down.
- If the "Allow revive" option is enabled, instead of dying then can go down into an injured state and they can be revived
   by crouching close to them until the 'Help' prompt fills up (10 seconds).

- Set how much it cost to hire a gunmen in the ini default is $25 per gunmen.
- Set the hired gun-men's health in the ini whether hes a tough fighter or easily wounded or killed.
- Hired guns will spawn their own horse if you decide to mount up, or they will look around for a horse to ride.
- Command your gunmen out loud using Arthur, and John's voice, or give them silent commands.
- Command your gunmen individually, tell them to follow, stay, mount, wait for your signal and more.
- Using the 'Wait for signal' command will make them stay and don't do anything until you signal to them by whistling.
- The 'Ride with me' command will prevent them from spawning in their own horse.
     If there's another free horse around they'll use that, but if not they'll ride with you on your horse.

Making hired guns drive
Target them and use the "You drive" prompt. Put down a custom waypoint on the map to make them drive there.
Deleting the waypoint will make them stop.
Use the 'speed up' and 'slow down' hotkeys to change their driving speed (up arrow and down arrow by default).

Their driving skills are ok-ish, generally they'll find their way from point A to point B, but sometimes they
can take a wrong turn... Also, they can't really turn around.

If you're sitting next to them, you can take away / give back the control with the 'switch
seats' key, should be 'Z' on keyboard. Make sure you stop them (slow down key until they're fully stopped) before you take
away the control, or they might bug out.

Commands menu
You can also give commands to them through their command menu, Numpad 1-3 keys by default.
The command menu has some extra commands:
 - Aim at person while the menu is up: Attack target, lasso target
 - Aim at dead / hogtied person: pick up target
 - Aim at horse: put carried body on horse
 - Aim at downed hired gun: help up (it'll take them the same amount of time as for you)

Known Issues
- Gunmen may multiply with the same gunmen when you restart or load into a new game.
  (If this happens just create a new save on an empty slot).

- The game may randomly crash if gunmen spawn their own horses, to prevent this set this setting in the ini to 1
      HIRED_GUNS_DONT_SPAWN_HORSE=0
   Doing so will force them to either ride with you, or locate any horses around to ride instead of spawning them.
  
- You can command the first 3 gunmen with the numpad keys, but currently the other 2 gunmen if you hire 5 wont
have menus to command accessed through the numpad keys, thats num 4 and 5, in general you can command them with prompts.
==============

Customization
All of the features in the mod can be customized by editing the Hired_Guns.ini file.
Each setting in the ini has a description on what it does and how to enable/disable or adjust it.
   Open the ini file with notepad to edit it, also run it as administrator if you are being denied access.

Installation
Move the following files:
Hired_Guns.asi Hired_Guns.ini Hired_Guns_CustomPeds.txt  to your RDR2 directory which can be found here:
C:\SteamLibrary\steamapps\common\Red Dead Redemption 2

Requirements
 Script Hook By Alexander Blade is required to run the mod.
https://www.dev-c.com/rdr2/scripthookrdr2/

Credits
Crossed99 for his help, support, and patience in helping me create this standalone version of the Bandit Hideouts mod!

Youtube Channel
Gunter Severloh RDR2