Featured SWAG + Donuts - Dynamic Spawn Waves and Custom Spawn Points 3.5.1

SPT 3.9.x ONLY

SWAG + Donuts v3.5.1 for SPT 3.9.x

Huge thanks to props and Archangel from the Fika discord for their hard work!

IF YOU HAVE PREVIOUSLY INSTALLED SWAG + DONUTS PLEASE READ:

Delete this folder first: <YOUR_SPT_FOLDER\BepInEx\plugins\dvize.Donuts\Config

Donuts will recreate this with updated default settings. If you wish to keep your old Donuts settings then you do not have to do this step but I highly recommend it as many default values have changed.

Fixes

- fixed spawn chance checks: Donuts would continuously check the same point that would result in low spawn chance points spawning bots anyway

- fixed random preset selection not working as intended

- fixed slow bot prep/raid load on subsequent raids

- fixed list of coordinates per selected zone note being properly randomized

- fixed starting bot available zones not getting reset properly after all zones were used (resulting in some number of starting bots not spawning in some cases)

Other Changes

- global minimum spawn distance to player/bots improvements - this check should be faster overall for solo bots especially; spawn point selection by Donuts is a little smarter now, if a coordinate is too close then Donuts will retry the next coordinate defined to that zone (at random) until all coordinates have been exhausted, then it fails that zone and moves on to the next spawn.

- global min spawn distance to player/bots now ENABLED by default again, sorry for the close bots

- global min spawn distance to player/bots values adjusted

- added presets: crazyraids, starting-pmcs-only-quietraids

- added new spawn points to Factory, Lighthouse

- added new starting spawn points to Ground Zero

- PMC Donuts bot caps increased slightly for all starting-pmcs-only presets

- PMC Donuts bot caps increased slightly for morepmcs preset

- SCAV Donuts bot caps increased slightly for morescavs preset

- Max Spawn Tries Per Bot (advanced settings) is now set to 1 by default

- code optimizations

- SWAG: added options for Ground Zero High Level. Kollontay and Cultists have a chance to spawn by default.

Known Issues

- Boss problems: I'm aware there are some users experiencing issues with boss spawns, it doesn't affect everyone so it's difficult to troubleshoot but it's on my to-do list!

SPT 3.9.0-3.9.1 ONLY

SWAG + Donuts v3.5.0 for SPT 3.9.0-3.9.1
SWAG + Donuts v3.4.0 for SPT 3.8.x

Sorry everyone for the wait, I hope it was worth it.

A huge thank you as always to props, this update would not have been possible without him.

SWAG + Donuts now requires Unity Toolkit by Arys (in addition to Waypoints). Please download and install that first!
UnityToolkit

Unity Toolkit allows for more performant and optimized code in SWAG + Donuts, a huge thanks to Arys for developing this!

For SPT 3.9.x ONLY: Please use DanW (Author of Questing Bots) AI Hostility Fix mod to fix buggy base game AI hostility: https://github.com/dwesterwick…ityFix/releases/tag/1.0.0
Please use the hub release of this once that is ready.

IF YOU HAVE PREVIOUSLY INSTALLED SWAG + DONUTS:

You must uninstall and delete all SWAG + Donuts files first! All mod folders in addition to the BepInEx mod config file- com.dvize.Donuts.cfg file from BepInEx\config folder must be deleted.

MAJOR CHANGES

NEW: In-game GUI

Donuts now has a GUI (all credit goes to props!). Accessible with F9 by default.

NEW: zoneSpawnPoints folder

This new folder contains all the spawn points available for Donuts to use. Each spawn points is assigned to a custom zone (defined by you). These spawn points and zones are used by the new spawn config files (read below). All spawn points are entirely configurable, feel free to add/change/remove any as you see fit or try creating your own.

NEW: map_start.json, map_waves.json files (patterns folders)

map_start - configs for all starting bots, PMC and SCAV.

map_waves - configs for all bot waves/respawns

For details on how these work please see the mod page > Donuts tab.

NEW: Max PMC/SCAV Respawns per Raid

You can now set the maximum number of PMC/SCAV respawns in each raid. Default is 0 which is unlimited.

NEW: Despawn Interval & Replenish Bot Interval

You can now change the interval at which Donuts despawns bots. Previously this was 10 seconds, now the default is 15 seconds.

Replenish Bot Interval is the frequency at which Donuts generates bot data during a raid for later use (so that bots spawn immediately when triggered).

OTHER CHANGES

- global minimum distance options are now DISABLED by default. if you don't want bots spawning too close to you then you need to enable this! keep in mind when using this option that if Donuts detects the spawn point is too close then it will skip that spawn entirely.

- performance improvements and code optimizations (thank you props, Arys for Unity Toolkit!)

- start of raid performance improvements: Donuts now only generates bot data it needs as defined by your starting bots configs. In other words, if you use lower bot counts/caps then Donuts needs to do less work = more performance.

- all presets have been changed to the new spawn config system; some presets have been removed

- SWAG: TotalBossesPerMap for all maps changed to from 1 to -1, this means any number of bosses can spawn per raid. If you do not want the chance of multiple bosses spawning in your raids then you need to change this!

FIXES

- fixed cooldown timers not working as expected

- fixed some grouped timers from not being reset properly resulting in too many spawns in some cases

- fixed bots sometimes "leaking" through the hard cap

- lots of other minor fixes, I forgot them all to be honest

SPT 3.8.x ONLY

SWAG + Donuts v3.4.0 for SPT 3.8.x

For all who have been waiting so patiently, this one is for you. Please read the SWAG + Donuts v3.5.0 for SPT 3.9.0 changelog for a full list of changes.

SPT 3.8.0 ONLY

This update includes performance improvements, bug fixes and some new stuff.

Performance Improvements

Some Donuts code has been refactored from running every frame and instead runs every second which should provide a significant performance boost. Huge thanks to Chomp for the idea and DanW (Questing Bots mod author) for using some of their code!

Global Minimum Spawn Distance From Player Improvements

Before this update the code for checking player distance from bots was slow at certain times which would still cause certain bots to spawn too close to the player. Now this code has been improved greatly so that it checks this distance value just before the bot is ready to spawn instead of earlier in the process which makes this check far more accurate.

NEW: Global Minimum Spawn Distance From Other Bots (Optional)

Similar to Distance From Player, these values set a minimum distance that bots can spawn from each other. If this check fails then that spawn will be skipped. Default is disabled.

NEW: Set your own Despawn Interval (Advanced Settings, Optional)

Under the BepInEx Advanced Settings for Donuts you can adjust how fast Donuts despawns bots in your raid. By default this is set to 10 seconds. Note: lowering this value may affect your performance!

DONUTS PRESETS

All spawn points re-balanced

SWAG

all boss spawn chances updated to match live (Kollontay added to Ground Zero)

SPT 3.8.0 ONLY

This in a minor update that adds compatibility and support for Punisher mod by GrooveypenguinX and Raid Overhaul mod by DjLang for custom bosses.

NEW: Legion - Raid Overhaul Custom Boss

The future SPT 3.8 update of Raid Overhaul will include a custom boss, Legion. To enable, go to bossConfig and scroll down to custom bosses. For more info, stay tuned for the new RO update (thank you DjLang!)

OTHER CHANGES

- Punisher compatibility improvements for SPT 3.8 (contributor: GrooveypenguinX)

- Labs added to Killa in bossConfig (was previously missing)

SPT 3.8.0 ONLY

This update includes a number of fixes and improvements that should bring more consistency to spawn counts and PMC/SCAV numbers on all presets, especially at the start of raid.

Additionally, this update includes performance improvements with bot spawning stutters many people experience, special thanks to DrakiaXYZ!

Be sure to install Waypoints 1.4.2+ for the best possible performance.

As always, thank you all for reporting issues and providing feedback and thanks for using this mod! A special thanks to Nahl from the SPT discord for all of their time spent testing many of the changes below.

NEW: Despawn PMCs or SCAVs

You can now enable/disable despawning for either PMC, SCAV or both (thank you Solarint for the suggestion!)

NEW: starting-pmcs-only-late-scavs (preset)

Same as starting-pmcs-only-live-like but 0 SCAVs spawn at the start of raid (Default is some SCAVs may spawn). With this preset there is a 2-5 minute window from the start of raid before SCAVs can start spawning. This preset has also been added to the random selections of "Starting PMCs Only (Random)" from the Donuts preset selector.

FIXED

- Global Minimum Spawn Distance From Player for Each Map not working as intended

- Customs: SCAV sniper in odd places (was using an incorrect bot zone, thanks Nahl!)

PRESET CHANGES

- spawn point balancing for all points, all presets

- starting-pmcs-only-live-like-alt: some starting PMC points have been changed on certain maps for added variety

- live-like-alt-2: now uses the same starting PMC points as above for added variety

- starting-pmcs-only (all presets)

- balanced all SCAVs - SCAV pop on all maps should be much better (especially smaller maps)

MAP SPAWN CHANGES

- Woods

- re-grouped points so that it is less crowded in Zone_RedHouse at the start of raid

- Customs

- re-grouped points so that it is less crowded in ZoneCustoms at the start of raid

DONUTS

- performance improvements (contributor: DrakiaXYZ)

- improved some Donuts menu option descriptions for clarity

- re-adjusted default Global Minimum Distance From Player values for all maps to more sensible levels

SWAG

- re-zoned some bosses and other types (like Bloodhounds) so that no "boss" share a zone (by default). This is to avoid any spawn blockage due to zone sharing (thank you Luna for the suggestion!)

SPT 3.8.0 ONLY

NEW: Global Minimum Spawn Distance From Player for Each Map

Instead of a single value for all maps you can now set the global min spawn distance per map from the F12 menu. The global option must be enabled for these to work, otherwise the spawn point parameter is used instead (in the Donuts spawn files).

CHANGES

- all presets, all maps re-balanced

- added new SCAV hot spot spawn point to Old Gas on Customs (all presets)

FIXED

- boss-mania Labs properly spawns bosses instead of PMCs

- Woods Big Mountain cliff spawn point where bots would fall off and die

- Ground Zero spawn points inside of the bank, 2nd floor in particular would get pretty crowded

To Install

1. download zip

2. unzip to your SPT directory, overwrite if needed

3. play

SPT 3.8.0 ONLY

NEW: Global Min Spawn Player Distance option

If enabled, uses this distance (in meters) for ALL spawns as the minimum spawn distance from the player (you). Disabled by default (uses the spawn point configs instead).

- balanced all presets: minor increase to SCAVs; Labs and Factory should be more consistent in spawn count

- fixed Donuts Force Bot Type option

- fixed broken Woods spawn point by the big mountain

- fixed missing scav snipers on Lighthouse and Streets

SPT 3.8.0 ONLY

SWAG + Donuts v3.3.0

A huge thanks to the SPT development team for all of their time, efforts and hard work on releasing SPT 3.8 to the masses!

This is a big update - a lot of things have changed for both SWAG and Donuts. Please take a few minutes to read through the changes as well as the mod page, as I've re-written a lot of the mod page for more clarity. Thank you for using this mod and enjoy!

SAIN is no longer a requirement though it is strongly recommended along with Looting Bots and Questing Bots. Waypoints is still absolutely required, please make sure you have the latest version installed.

DONUTS

The majority of spawn points have been completely overhauled. I've created hundreds of new spawn points for all maps that correspond to custom zones. Additionally, some PMC starting points have been adjusted from their live counterparts for better map spread and balance. Each preset has been balanced separately for their given purpose.

Please see the Custom Zones sections of the mod page for more details.

NEW: Ground Zero spawn points and presets

Custom spawn points have been created in custom zones (see: Donuts - Custom Zone Maps). All starting PMC spawn points are separated by zone and side of map. In live, PMC spawns can be a bit too close to each other on Ground Zero. I've adjusted starting PMC spawns so that they make more sense in regards to location. There are 2-3 points per zone, 1 on each side.

NEW: Force All Bot Type

You can now force PMC or SCAV spawns for all spawn points from the Donuts F12 menu. This can be toggled mid-raid. I've removed the "all-scav" and "all-pmcs" presets since they are no longer necessary with this option.

NEW: PMC/SCAV Hotspot Spawn Boost

If enabled, forces all spawn points labeled with "Hotspot" to always spawn (100% spawn chance) when triggered. This can be toggled mid-raid.

NEW: PMC/SCAV Hotspot Ignore Hard Cap

If enabled, all spawn points labeled with "Hotspot" ignore the "Hard Cap" option. I'll explain with a couple of examples:

Despawn Enabled

Hard Cap Enabled

Spawn Boost Enabled

Hotspot Ignore Hard Cap Enabled

Customs - 10 PMC, 10 SCAV caps

- Raid is full (20 bots total)

- Player enters hot spot area

- Hot spot spawn point is triggered (100% chance)

- Donuts spawns bots over the cap (ignore hard cap is enabled)

- Donuts begins despawning bots furthest away from you down to the max caps

For an optimal experience I suggest enabling all 4 options above, you'll get extra hot spot spawns but save on FPS with the hard cap.

PRESET CHANGES

- some presets removed

- all Donuts caps are now the same for all presets by default. Configurable in the ScenarioConfig.json.

- boss-mania

- all PMCs removed - it's you vs everyone now

- bot type is more random now and includes a chance for Bloodhounds, Raiders or Rogues to spawn in addition to named bosses

MISC CHANGES

- 'INS' and 'DEL' default key binds removed from spawn point editor (not set by default now)

---

SWAG

All SWAG config files have changed name, location or both. Please be sure this is a clean SWAG install. All SWAG files have changed in some way and use a new directory structure:

user\mods\SWAG\config\bosses

user\mods\SWAG\config\custom

user\mods\SWAG\config\other

user\mods\SWAG\config\bosses\goons.json

or

user\mods\SWAG\config\other\cultists.json

etc...

Some older SWAG options have been removed (mostly because I don't want to maintain old features anymore), some new options have been added, please read the below:

NEW: disableAllSpawns

This new option provides a simple way to disable all bosses or other bot type spawns.

NEW: useGlobalSpawnChance & useGlobalBossSpawnChance

Set these to true to use the map spawn chance defined in config.json or bossConfig.json.

If set to false then SWAG will use the "BossChance" defined in the spawn files (i.e. user\mods\SWAG\config\bosses\kaban.json)

NEW: Add other bot types to all maps

You can now add/remove other bot types (i.e. rogues, raiders, etc.) by adjusting the map spawn chance. By default, SWAG adds a single spawn of each bot type to all maps each in a random zone. All spawns are configurable, you can add/remove as much as you would like, see: user\mods\SWAG\config\other\ and the mod page for more info.

- SWAG difficulty "asonline" is a valid option and now randomly selects between easy, normal, hard and impossible.

SPT 3.7.5-3.7.6 ONLY

SWAG + Donuts v3.2.5

Note: SPT 3.7.5+ is required for this update.

FIX: extra spawns (vanilla spawns) would sometimes occur in the first raid after game load

This would unfortunately cause a significant performance drop simply due to the number of bots in that raid. This has been fixed. Special thanks to DrakiaXYZ for investigating and troubleshooting and PreyToLive (BSP mod dev).

NEW: Force PMC faction option

In the F12 menu under a new section, Additional Spawn Settings, you can set to force all your PMC spawns to be USEC, BEAR, or Default which is random.

NEW: PMC & SCAV Spawn Hard Stop option

If enabled, all PMC/SCAV spawns are skipped once there is 300 seconds or less (default) remaining in your raid. The time left in raid is configurable per PMC or SCAV. This is particularly useful for those who prefer fewer spawns depending on time in raid.

Plans for 3.8.0

I'm in the process of a huge spawn point rework with what will be custom "zones" on every map with new, properly labeled spawn points throughout. This will hopefully increase spawn location density and parity significantly for all presets, allow for easier user customization, new mod features in the future and some other cool stuff, stay tuned!