Name: Larger Packs - Spawn Multiplier
Version: 1.20.3
Date: 05/05/2024
Category: Gameplay Effects and Changes
Requirements:
xNVSE 6.3.3 or higher
JIP LN NVSE Plugin 56.85 or higher
JohnnyGuitar NVSE 4.85 or higher

Author: ebizoe

Description
===========
Makes NPCs/creatures spawning in larger numbers.

Features
========
- Lets you increase the number of NPCs/creatures spawning up to 10 per spawn.
- Works for the spawns from any DLCs/mods.
- No save-bloat.
- Supports Tale of Two Wastelands.
- Can be configured, or even be ON/OFF on the fly in-game.

Known Issues
============
- Dead bodies of additional spawns will disappear after reloading a save or the player leaves the current area.
- There will be a few second delay before additional spawns appear.
- Some of the unique NPCs/creatures would get their unwanted clones.
- Radroaches are hard-coded to the inclusive filter so they cannot be excluded from receiving additional spawns.
- There are some places where you'll get no additional spawns at all due to how the mod's default actor filtering works.

Configuration Guide
===================
To tweak the settings of this mod, edit "config\Larger Packs.ini" directly, or if you have Pelinor's The Mod Configuration Menu installed, via MCM. I recommend using MCM since it allows you to tweak the settings on the fly.

In order to enjoy a smooth gameplay with a lot of NPCs/creatures on the screen, it's essential to have your game properly patched and setup. There are quite a few toos/mods available that'll help the game run more stable, faster and handle a lot of NPCs/creatures better. I won't list all those goodies here but there is a comprehensive modding guide by Qolore7, called Viva New Vegas, for you to follow. I highly recommend you to check it out to see if you missed anything important or did something you shouldn't do to your setup.

This mod is highly configurable. The default setting should be good for the most cases, but you are encouraged to tweak the settings to fit your needs.

For a detailed info on the configuration, see Larger Packs Configuration Guide:
https://www.nexusmods.com/newvegas/articles/56348

Install
=======
I recommend Mod Organizer 2 (https://www.nexusmods.com/skyrimspecialedition/mods/6194) for installation of this mod. If you're using Mod Organizer 2, follow its instruction for managing mods.

If you insist installing this mod manually;
1. Extract the files to a temporary location.
2. Copy "Larger Packs.esp" to Fallout New Vegas\Data\
3. Copy "Larger Packs.ini" to Fallout New Vegas\Data\config\
4. Copy "Larger Packs Filters" folder to Fallout New Vegas\Data\config\
5. Start FalloutNVLauncher, click 'Data Files', place a checkmark beside the .esp file.

Load order
==========
You can place this mod anywhere on your load order.

Upgrade
=======
Overwrite old files with new ones.

Uninstall
=========
You can just remove this mod whenever you want.
There are two files and one folder to be deleted;
- Fallout New Vegas\Data\Larger Packs.esp
- Fallout New Vegas\Data\config\Larger Packs.ini
- Fallout New Vegas\Data\config\Larger Packs Filters

History
=======
1.20.3, 05/05/2024
- FIXED: The "creatures only" option will be reset to 0 at every time the game is launched or a save is loaded. Thanks roquero13 for the report.

1.20.2, 30/04/2024
- FIXED: A possible crash.

1.20.1, 28/04/2024
- FIXED: Actor Filter is broken.

1.20, 27/04/2024
- Added level modifier settings. Thanks laclongquan for the idea.
- Overhauled the ref cleaning up script. It's significantly faster now.
- Added a few entries to Actor Filters.
- FIXED: Per-actor-type spawn multiplier for Deathclaws won't work sometimes.
- FIXED: Actor Filter won't work with a filter profile that has only one entry.

1.19, 11/03/2024
- Tweaked the default actor filter a bit so that there will be less places where the player encounter no additional spawns at all.
- Added a few entries to Actor Filters, including Deathclaws to Inclusive Filter.

1.18.1, 05/01/2024
- FIXED: Per-actor-type modifier for Raiders/Fiends affects all kinds of NPCs, not just Raiders and Fiends.
- FIXED: Per-actor-type modifier for Deathclaws doesn't work.
- FIXED: Some typos.

1.18, 29/12/2023
- Added per-actor-type spawn number modifier option. Thanks LoneDude for the idea.

1.17.1, 08/12/2023
- FIXED: An infinite-loop bug.

1.17, 05/12/2023
- None of additional spawns will be save-baked now, eliminating any chance of this mod causing save-bloat.
- FIXED: Spawns would occur right in front of the player under certain condition. Thanks LoneDude for the report.

1.16.2, 24/11/2023
- Added some of actors from Dj Mystro's A World Of Pain to the actor filters.
- FIXED: Original NPCs would go into no-clip state and cannot be interacted under certain conditions. Thanks niac2 for the report.
- FIXED: The MCM part won't work after loading a save with different mod-setup from previously loaded save at the same session.
- FIXED: "bExcludeDeathclaws" setting won't work on "Young Deathclaw" or "Irradiated Deathclaw".
- FIXED: Crimson at Paradise Falls would get her duplicates (TTW).

1.16.1, 08/09/2023
- FIXED: Disabling the spawn script via config will crash the game.
- FIXED: Think tank doctors from Old World Blues DLC get duplicates.

1.16, 31/08/2023
- The built-in actor filter has been tweaked in order to prevent additional spawns fighting for the same spot with originals.

1.15, 08/08/2023
- Any changes to the settings will take effect immediately.
- FIXED: When in random mode (non Custom chance % mode), additional spawns will appear only in maximum or minimum number, never in in-between numbers.

1.14.1, 28/07/2023
- FIXED: Possible CTD under certain conditions, especially when fast-traveled.

1.14, 24/07/2023
- Overhauled spawner script. It's faster and will cause less stutter when spawning additional spawns.
- When spawner scripts are switched off, the already-spawned additional spawns in current area will be erased immediately.
- FIXED: A few minor bugs.

1.13, 10/07/2023
- No-longer-needed additional spawns will be erased from saves more strictly.
- A few entries have been added to actor filters, including "Spook" and "Pitt Slave" from The Pitt DLC (TTW).
- BoS strike team at Arlington Library will no longer receive additional spawns in order to avoid messy glitch (TTW).
- FIXED: Error messages would spam console under certain condition. Thanks whodevenhackthissite for the report.
- FIXED: A few minor bugs.

1.12.2, 05/05/2023
- FIXED: The number of additional spawns changes each time a saved game is reloaded.

1.12.1, 03/05/2023
- FIXED: A critical bug which leads to corrupt saves.

1.12, 29/04/2023
- Required version of JIP LN NVSE Plugin is now v56.85.
- Added user-customizable "Incompatible Mod Filter". The mods listed on this filter are entirely ignored by Larger Packs.

1.11.1, 24/04/2023
- FIXED: A possible CTD under certain conditions.

1.11, 13/11/2022
- The actor filtering system, which previously only supports exclusive filters, now covers inclusive filters, too. This means now we can enjoy spicier Lonesome Road DLC with larger packs of Marked Men!
- Now changes to the actor-filters take effect not only by restarting game but by reloading saves, too.
- Added "Creatures Only" option. This excludes NPCs from receiving additional spawns. Thanks TLoV for the idea.
- Optimized the code a bit so that we have a less stuttering when there are a lot of actors spawning at the same time.
- FIXED: When using bCustomChance setting, the normal settings' min/max caps for number of spawns are applied, not the custom-chance settings'.
- A few minor bug fixes.

1.10.2, 12/10/2022
- FIXED: After reloading a save, actors won't receive any additional spawns at all under certain conditions.
- FIXED: bMinSpawns setting is ignored under certain conditions.
- FIXED: bExcludeDeathclaws setting is not functioning.

1.10.1, 24/9/2022
- FIXED: bEnabledExterior and bEnabledInterior settings are ignored under certain conditions.
- FIXED: Changes to some of the settings won't take effect immediately.
- FIXED: After reloading a save, actors won't receive as the same number of additional spawns before the reload.
- FIXED: Changes to actor-filters only take effect on new game.
- A few minor bug fixes.

1.10, 15/9/2022
- Overhauled the actor filter system. Users now can add/edit actor filters via ini files.
- A few actor filter have been added, including Gomorrah Dealer.
- Changed default value of iMaxSpawns to very conservative "30".

1.9.2, 1/9/2022
- Added JohnnyGuitar NVSE to the requirement.
- FIXED: Extra spawns sometimes take too long to appear.
- FIXED: Values for iMaxSpawnsExterior and iMinSpawnsExterior on MCM were not handled properly.
- FIXED: Actors with keys/notes in their inventory (ie Nightkin jailer, Rocksalt) shouldn't get duplicated.
- A few minor bug fixes.

1.9.1, 4/8/2022
- FIXED: Mistakenly uploaded a development version for 1.9.

1.9, 3/8/2022
- Additional spawns now follow their original spawn properly after the original spawn's AI package and linked-ref got changed by the script from other mods.
- FIXED: The scripts sometimes would lose track to additional spawns when the additional spawns go to lower processing level, resulting original spawns receive new spawns repeatedly.
- FIXED: Additional spawns to Legion members at Nipton won't follow the originals.
- FIXED: Additional spawns to Traveling merchants' guards won't follow the originals.
- FIXED: Additional spawns to BoS strike team at Arlington Library in Capital Wasterland won't follow their originals (TTW).
- FIXED: Scripts try to process invalid refs under certain conditions.

1.8.1, 6/7/2022
- FIXED: Additional spawns won't respawn when the saved game is reloaded.
- A few minor bug fixes.

1.8, 30/6/2022
- Name-filters now should work on non-English language versions of the game.
- Overhauled scripts so they run significantly faster.
- A few name-filter have been added, including Roxie in "Old World Blues" DLC.
- A few minor bug fixes.

1.7, 26/5/2022
- Required version of JIP LN NVSE Plugin has been updated to 56.52.
- A new setting "Custom chance percentage" has been added. You can now tweak the chance percentage for each spawn numbers. Thanks nottotallyhuman for this idea!
- A new setting "Exclude Deathclaws" has been added. You can now exclude Deathclaws from receiving additional spawns. Thanks bct18181 for this idea!
- A few name-filter have been added, including the arena fighters ("Gruber", "Grudd Bear" and "John Bear") in "The Pitt" DLC (TTW). Thanks shadowmere65 for the report!
- Made scripts run slightly more efficiently. Performance improvement is hardly noticeable, though.

1.6.2, 13/5/2022
- FIXED: Additional spawns still receive their own additional spawns under certain conditions.

1.6.1, 10/5/2022
- FIXED: Some of the debugging features were accidentally left undeleted.

1.6, 10/5/2022
- Required version of xNVSE has been updated to xNVSE 6.2.7.
- Slightly improved script performance when the spawns in the same area share the same leveled-list.
- Changed wording of the settings in MCM so the configuration menu could work with large (aka vanilla) fonts.
- A few name-filter have been added, including Enclave Doctors and Enclave Scientists in "Broken Steel" DLC (TTW).
- FIXED: MCM fails to load under certain conditions.
- FIXED: Scripts try to process invalid refs under certain conditions.
- FIXED: Original spawns keep receiving additional spawns repeatedly under certain conditions.
- FIXED: Additional spawns receive their own additional spawns under certain conditions.

1.5, 29/4/2022
- Slightly improved script performance under heavy load.
- Now Ghost people in "Dead Money" DLC receive additional spawns.
- No more clones for the scientists in "Old World Blues" DLC.
- No more clones for Gun Runner Guards in "Gun Runners' Arsenal" DLC.

1.4.2, 23/4/2022
- FIXED: Some of the actors from "Old World Blues" DLC get 100 additional spawns. Thanks FerFerra for reporting this bug!
- FIXED: Dead actors receive additional spawns.
- FIXED: "iMaxSpawns" was ignored by the scripts under certain conditions.

1.4.1, 22/4/2022
- FIXED: Sometimes original spawns keep receiving additional spawns repeatedly.

1.4, 22/4/2022
- Now you'll get the same number of spawns after reloading game from saves.
- Player no longer gets OP Strike Team at "Operation: Anchorage" DLC (TTW).
- New setting "Enemy Only" added.
- Even quicker exterior/interior configuration switching by employing event handler script function.
- Actors with zero aggression (i.e. Chem Addicts, Caravaneers) no longer receive additional spawns.
- FIXED: "Default" buttons didn't function on MCM.
- FIXED: Sometimes the value for "iCellDepth" setting cannot be changed.

1.3, 16/4/2022
- Dropped "large-creatures-get-fewer-spawns" feature.
- A smaller-delay option for "Script Processing Delay".
- Radroaches now get additional spawns, too.

1.2, 15/4/2022
- Large creatures (i.e. Deathclaws) get fewer additional spawns, about 1/3 to NPCs'.
- Slightly improved actor filter. No more clones for named NCR Rangers.
- Quicker exterior/interior configuration switching.
- New setting "Number of Cells to Scan" added.
- New setting "Script Processing Delay" added. Thanks bct18181 for this idea!
- Lowered the minimum for iMaxSpawns from 3 to 1. Thanks mikpez for this idea!
- Previously auto-generated "Larger Packs.ini" is now bundled with this package for MO2 to handle this mod better. Thanks bct18181 for the input!

1.1, 10/4/2022 - Tweaked scripts to become slower but less intensive, less resource hogging.
- Separate settings for Interior and Exterior cells. Thanks bct18181 for this idea!
- Increased the limit for "Overall Max number of actors" setting from 100 to 128.
- Less cases of unique actors getting their clones by filtering out actors with a key in their inventory. No more Rocksalt clones!

1.0, 8/4/2022
- Initial release.

Tools Used
==========
Garden of Eden Creation Key (GECK) - http://geck.bethsoft.com/index.php?title=Main_Page
GECK Extender - https://www.nexusmods.com/newvegas/mods/64888?tab=files
xEdit - https://www.nexusmods.com/newvegas/mods/34703
Readme Generator - http://HammondsLegacy.com/obmm/tools_readme_generator1.asp

Licensing/Legal
===============
You can do whatever you want with this mod.