Jump to content

BotReSpawn 1.1.6

   (30 reviews)

6 Screenshots

  • 89,023
  • 4,993
  • 249.67 kB

About BotReSpawn

Spawns set numbers of customised npcs at monuments,
various events, supply drops, biomes, custom locations, and 'toplayer'.

Plugin Description.

This is a new plugin.
Old BotSpawn data files are not compatible.
You will have to create your profiles and spawnpoints from scratch, however the majority of that can now be done via UI.


Optional dependencies -

  • Kits
  • CustomLoot


  • botrespawn.allowed - Required for non-admin use

Chat commands.

  • /botrespawn - Opens UI.
  • /botrespawn add *profilename* - Adds a custom profile then opens UI. (please don't use  spaces or hyphens)
  • /botrespawn remove *profilename* - Removes a custom profile.
  • /botrespawn info - Tells you about the npc you're looking at.

Console commands.

  • bot.count - Gives total number of spawned npcs.
  • bots.count - Gives a breakdown of spawned npcs per profile.
  • addspawn - Enabled via UI, in Edit Spawnpoints menu - for keybinding.
  • botrespawn toplayer NameOrId ProfileName amount(optional)
  • botrespawn enable/disable "Profile name here"
  • botrespawn tempspawn "Profile name here"


Default locations.

All major monuments are automatically included, plus profiles for the four biomes.

The following events also have default profiles

  • Airdrop (supply grenade optional)
  • Locked Crate Spawn
  • Locked Crate Hack Start
  • APC Kill
  • PatrolHeli Kill
  • CH47 Kill


Configurable via json, per profile.

  • BotNames
  • BotNamePrefix
  • Announcement_Text
  • Instant_Death_From_Headshot_Allowed_Weapons (accepts item shortnames)

See note at end for weapon list formatting.
Everything else is configurable via UI.



Kits are managed, per profile, in UI.
As with BotSpawn, kit probability can be balanced by assigning a number to a kit.

When selecting multiple kits, increasing a kit's number increases its chances of being picked.

Only kits with weapons in the belt are shown in UI.

Please stick to normal bullet weapons and melee weapons for now, with your npcs.
There are plans to support the more unusual weapons in future.


Adding and managing spawnpoints is done, per profile, in UI,
or by enabling 'add by command' in spawnpoints menu, then using 'addspawn' console command.
You can bind this command for your convenience.

When opting to use the 'addspawn' command, a button will show in UI main page, allowing you to quickly return to the profile you were editing.

A new feature is that each spawn point can have overrides, forcing that specific npc to have different values to the rest of the profile's npcs.
At present you can override

  • Stationary
  • Kits
  • Health
  • RoamRange


If you choose to use Parent_Monument, you can select it via UI, but do so before you add custom spawn points (if applicable).
Parent_Monument ensures that your profile and its spawn points will relocate after a map change,
so that they are in the same place, relative to that chosen monument.

If a profile uses custom spawn points, but does not have enough custom spawn points to cover the whole population,
it will spawn randomly placed npcs to make up the numbers, in accordance with the profile "Radius" setting.

EG :
Day_Time_Spawn_Amount 10
Number of custom spawn points 5
Result : 5 npcs on custom spawn points, and 5 randomly placed around the area, within the specified radius.



Murderer true/false is no longer an option.
Instead, the AI will respond differently based on the weapons you give it.
If you want the AI to run directly at victims and attack, give it melee weapons only.


Peacekeeper has now been changed to be more in line with the vanilla npcs.
Peacekeeper true npcs will now respond to whether or not the game considers you hostile.



  • "DataPrefix": "default", (tells BotReSpawn which data files to load),
  • "UseServerTime": Uses server IsNight check, instead of manual day/hour settings,
  • "Show_Profiles_Seconds": 10,
  • "DayStartHour": 8,
  • "NightStartHour": 20,
  • "SuicideBoom": true, (toggles explosion sound for suicide npcs),
  • "APC_Safe": true,
  • "Turret_Safe": true,
  • "Animal_Safe": true,
  • "Supply_Enabled": false, (spawn 'airdrop' bots for user-called supplys),
  • "Ignore_Skinned_Supply_Grenades": true,
  • "Remove_BackPacks_Percent": 100 is always : 0 is never,
  • "Remove_KeyCard": true, (any keycards in bot default loot will be destroyed),
  • "Remove_Frankenstein_Parts": true, (any frankenstein parts in bot default loot will be destroyed),
  • "Ignore_Sleepers": true/false,
  • "Pve_Safe": true, (bots will not be injured by fire/barbs, etc.),
  • "Max_Chute_Fall_Speed": 100,
  • "Staggered_Despawn": false,
  • "Disable_Non_Parented_Custom_Profiles_After_Wipe": false
  • "Announce_Toplayer": false
  • "RustRewards_Whole_Numbers": true
  • "XPerience_Whole_Numbers: true
  • "NPCs_Damage_Armour": true
  • "Limit_ShortRange_Weapon_Use": false
  • "Allow_Ai_Dormant": false
  • "Prevent_Biome_Ai_Dormant": false
  • "Scale_Meds_To_Health": false (increases npc heal amount relative to npc's max health.
  • "Ignore_Factions": false - Makes all profiles fight all profiles.
  • "Reduce_Damage_Over_Distance: false
  • "Deaggro_Memory_Duration: 20 - Number of seconds it takes an npc to forget you outside deaggro range/line of sight.
  • "Ignore_HackableCrates_With_OwnerID" - Makes hackable crate profiles only respond to crates with OwnerID 0 (server spawned)
  • "NPCs_Assist_NPCs" - true/false. When a botrespawn npc is attacked, nearby botrespawn npcs will also respond and defend.
  • "Enable_Targeting_Hook": false
  • "Allow_AlphaLoot": false

These values are adjustable via UI, with the exception of DataPrefix.


Profile values.

Each profile value and description is not listed here, but all (apart from text strings) are now configurable via UI,
and have sensible default values.
Most should be self explanatory, although I do intend to add descriptions/notes in the UI itself in the near future.

If any specific setting/value is unclear, please just ask in CF discord, my discord, or the support section here.


Notes : 

Durations which used to be in seconds are now in minutes.

"Type" is an internal use variable - Users should not change this option.

Profile copy/paste does not include location, Parent_Monument, or custom spawnpoints.


BotNames, and Headshot weapons should be formatted as follows:
["name1"], for single or ["name1", "name2", "name3"], for many.
["rifle.lr300"], for single or [ "rifle.lr300", "pistol.m92" ], for many.



string[] AddGroupSpawn(Vector3 location, string profileName, string group, int quantity)
string[] RemoveGroupSpawn(string group)
object OnBotReSpawnCrateDropped(HackableLockedCrate crate)
object OnBotReSpawnCrateHackBegin(HackableLockedCrate crate)
object OnBotReSpawnAPCKill(BradleyAPC apc)
object OnBotReSpawnPatrolHeliKill(PatrolHelicopterAI heli)
object OnBotReSpawnCH47Kill(CH47HelicopterAIController ch)
object OnBotReSpawnAirdrop(SupplyDrop drop)
void OnBotReSpawnNPCTarget(ScientistNPC npc, BasePlayer player) 

Example usage.

private Plugin BotReSpawn;

Vector3 location = new Vector3(0,0,0);
string[] Spawn = BotReSpawn?.Call("AddGroupSpawn", location, "The Dome 0", "MadeUpNameHere", 5) as string[];


Passing 0 for quantity will spawn the appropriate amount of npcs for the time of day, according to the profile.



Method call OnBotReSpawnNPCSpawned(ScientistNPC npc, string profile, string group, notifies of spawned npcs.

void OnBotReSpawnNPCSpawned(ScientistNPC npc, string profile, string group)  
    if (String.IsNullOrEmpty(group))
        Puts($"BotReSpawn spawned an npc from profile {profile}");
        Puts($"BotReSpawn spawned an npc from profile {profile} - API group name {group}");





Q: My npcs don't move and/or won't attack

A: If you have any PVE plugins or settings please try disabling those temporarily to test.
A: Make sure the server has the following settings.

  • nav_wait true
  • nav_disable false
  • ai.think true

A: If you use Rust Admin, please ensure that the animal AI option is enabled.
A: If you have Vanish installed please try unloading it. If this worked, check you don't have the permission for permanent Vanish.

Q: There's a million options. Where do I start?
A: Set AutoSpawn to true for at least one monument in config/BotSpawn.json, then reload the plugin.
A: Everything else is preference/user customisation.
A: If the monument has a building/structure near the middle, like Dome, you may need to increase the spawn radius option to get going.

Q: My bots won't die / my bots take damage when attacking people.
A: Make sure Godmode permissions allow you to do damage.
A: Same for vanish ^.
A: Ensure you don't have a PVE plugin which is causing this damage behaviour.

Q: I take damage when attacking my bots.
A: This can also be caused by server, or plugin, PVE settings.

Q: Will X kill my bots?
A: Radiation, drowning, falling, and helicopters should not kill your bots.
A: Turrets targeting bots can be toggled. Bradleys targeting bots can be toggled.
A: Fire (campfires etc) will kill your bots. Damage from barbs, cacti etc will kill your bots, but can be prevented with the 'Pve_Safe' config option set to true.

Q: What weapons can my bots use?
A: I recommend sticking to basic bullet-weapons, hand tools and melee weapons.
A: Some weapons may work better than others. Some weapon skins have been known to cause issues and errors.
A: Please try plain weapons if you're having problems.
A: There are plans to accommodate more interesting weapons in the near future.

Q: Can I have custom profile locations?
A: Yes. Your custom locations are stored in data with a filename of *YourPrefix*-CustomProfiles.json.
Use chat command '/botrespawn add NewNameHere' to create a profile at your present location.
A: Doing so will open the UI, at the page for your new profile's settings.

Q: Can I have specific custom spawn points? (underground, etc)
A: Yes. Use the built in UI to create custom spawn points and set UseCustomSpawns to true, for some profile..
A: That BotReSpawn profile will now ignore radius settings and use the precise spawn points from your file.

Q: Can I spawn bots at events.
A: Yes. There are event profiles for aidrop, hackable crate spawn and hack start, and the destruction of CH47, Patrol Heli, and APC.
For the airdrop profile, spawn at user-supply call is an additional option, found in the global config.

Q: My bot kits aren't working.
A: Kits which don't have a valid weapon in the belt will not be made available in the UI.
A: Please redeem the kit yourself to an empty inventory, to ensure that the expected items are definitely in it.

Q: How can I prove that bots have spawned? I can't find them.
A: Type bot.count into console for a total number, or bots.count for a per-profile breakdown.
A: Respawn timer is taken into account so if you spawn one and kill him, bot.count will show 0 until respawn.

Q: bot.count console command shows that there are 0 bots.
A: Double check that at least one monument is set "AutoSpawn": true in your config, and reload the plugin.
A: Also, don't forget their respawn timer. If they're all dead when you do bot.count, it will show 0.

  • Like 9
  • Sad 5
  • Haha 1
  • Love 19

User Feedback



Total number of downloads.



Total customers served.


Files Sold

Total number of files sold.


Payments Processed

Total payments processed.

  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.