Jump to content
Search In
  • More options...
Find results that contain...
Find results in...

6 Screenshots

  • 29,471
  • 1,612
  • 186.72 kB

About BotReSpawn

BotReSpawn replaces BotSpawn, and spawns a set number of Rust AI bots at chosen monuments.
It also supports bots at server various events, supply drops, biomes, custom locations, and 'toplayer'.
 

Please read this before buying.

I intended to release this plugin in the new year but changes to Rust have forced early release.
As such, it doesn't yet have some of the new features I wanted to add,
and it's entirely possible that some minor features may not be fully implemented or work as intended.

However, a great effort has been made to make BotReSpawn easier to use, and to ensure that it is as close to fully functioning as possible for initial release.

 

My original intention was to keep the original BotSpawn available for free, and release this as paid,
but that's no longer possible due to Rust changes.
I hope you all understand.

Where BotSpawn was at end of life and not getting much attention,
this should be a new start, with new features and ideas to come in the near future.


Many thanks to @MikeHawkefor testing and general help.

If you encounter any issues please use the support section here, or use support channels in Codefling or Steenamaroo discord.

_________________________________________________________________

 

******Some people are reporting issues with Kits******

If you're unable to choose Kits, please ensure you're on the latest version of Kits from uMod, and that your Kits definitely have weapons in the belt.
If this is the case and you're still having issues, please let me know via support tab.

_________________________________________________________________

 

 

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...

@brantjehas kindly created a conversion tool which can be found here - https://corrosion-gaming.com/botrespawn.html
 

 

Optional dependencies -

  • Kits
  • CustomLoot
     

Permissions.

  • 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)

 

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.

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.
 

Spawnpoints.

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

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
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.

 

Configuration.

  • "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),
  • "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

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.

 

API :

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)

Example usage.

[PluginReference]
private Plugin BotReSpawn;

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

Puts($"{Spawn[0]}");
Puts($"{Spawn[1]}");

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.
Example.

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

 

 

FAQ.

 

Q: My npcs don't move.

A: Make sure the server has the following settings.

  • nav_wait true
  • nav_disable false
  • ai.think true

A: Also, if you use Rust Admin, please ensure that the animal AI option is enabled.

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 7
  • Sad 4
  • Haha 1
  • Love 15

Steenamaroo's Other Downloads


User Feedback

About Us

Codefling is a forward-thinking platform for developers to share and monetize their work from plugins to game assets and everything in-between.

10,978 files sold to 948 customers and $171,714 of 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.