Go to file
bmgjet e15fd2777d
Update RECustomBots.cs
2022-10-08 12:03:49 +13:00
README.md Update README.md 2021-12-19 00:28:57 +13:00
RECustomBots.cs Update RECustomBots.cs 2022-10-08 12:03:49 +13:00
RECustomBotsImage.jpg screenshot 2021-12-12 01:57:25 +13:00

README.md

RECustomBots

This plugin modifies the bots getting spawned by rust edits NPC Spawners.
Just prefab group the NPC Spawn to a placeholder prefab (Random Switch Deployed by default)
And set the name of the prefab group to have what settings you want to change.


Avaliable keywords

  • name=            if set it will apply a specific name to the bot, Other wise will pick one at random based on userid the spawner creates.
  • kit=                 if set will apply kit to bot, Can do male/female specific kits by using ^ between them kit=malekit^femalekit
  • stationary       if this keyword is present bot will remain stationary.
  • parachute           if this keyword is present bot will parachute to navmesh.
  • replace              if this keyword is present bot replace default items with kit items.
  • strip                if this keyword is present bot will strip all its loot on death.
  • radiooff              if this keyword is present bot will not use the radio to chatter.
  • peacekeeper            if this keyword is present bot will only fire on hostile players.
  • mount              if this keyword is present bot will mount the closest seat.
  • taunt              if this keyword is present bot will make taunts in the chat to players it interacts with.
  • killnotice              if this keyword is present kills/deaths of this bot will be announced to chat.
  • health=              if set will adjust the bots health to this example health=150
  • attack=              if set the bot will attack only up to this range.
  • roam=              if set this is how far the bot can move from its home spawn before it wants to return.
  • cooldown=              if set changes the default home check rate.
  • height=              if set can make small adjustment to bots navmesh height usual settings range will be -3 to +3.
  • speed=              if set adjusts how fast the bot can run.
  • steamicon=            if set the bot will use this steam profiles icon example steamicon=76561198188915047
  • apcattack            if set the bot will get attacked by APCs
  • canheal            if set the bot will use any health items in the kit when its below 1/2 health.
  • damageScale=            Sets the percentage of normal damage. 100 default = normal player ammount damage;
  • accuracy=            Sets what percentage change a bullet has of doing damage. Default lowered to 30

How To Use:

Create a NPC Spawner and set the type of bot you want. Create a placeholder prefab, By default this is Random Switch Deployed prefab. You can change this placeholder in the plugin file to any other prefab you wish to use.

Copy the NPC Spawner position. And paste that position into the placeholders so they are both centered. Now select both and create a selection group.
The name you give this is what will set up the bots from that spawner. Keywords can be in any order. Not providing a keyword will use the default setting. If the setting has a = in it you must provide a number after the =

Example:
If you wanted a bot that was just stationary and no other changes youd call it
BMGBOT.stationary

If you wanted a bot that parachutes in and has 500 hp youd enter
BMGBOT.parachute.health=500

Here is a video to show it being done.
VIDEO:
https://youtu.be/ckGnEDdqwZQ

You can also do gender based kits by providing a ^ between the male and female kit. As shown the screen shot. That will give male bots the kit called "malekit" and female bots the kit called "femalekit"
The setting replace will remove the default items of that bot and use the kits items.


Advanced settings in the plugin:

These can be edited inside the plugin cs file.

  • Debug = false or true This setting will show debug info in the console if set to true
  • MapLockLocation Set the X,Y,Z locations of a invalid prefab here to use it as copy protection for your map. A example would be place a pumpjack item at some location under the map. Then copy and paste its position in here.
  • FixDoors = true or false. This setting will scale doors X-axis to 0.1 to allow players to move around them but still provide some navmesh to bots.
  • prefabplaceholder this is the path of the prefab your using as placeholder for grouping with.
  • bot_tick how fast the scripts tick rate is, 1 = once a second 0.50 wouldnt be uncommon to increase responsiveness of bots.
  • ScanDistance is how far away from the npc spawner the placeholder prefab can be at most to be detected.
  • MountScan How much of a area to seach for mountable seats
  • AnnouncementIcon enter a steamid for the profile you want the kill/death announcer to take its icon from.
  • color the color of the announcer name example red,orange,blue
  • SleepProtect Stops custom bots from shooting at sleepers
  • ChuteSider timer that will destroy the parachute after X seconds if it gets stuck on something
  • ColliderDistance How close to a object before parachute is removed automatically
  • private string[] Dead is a collection of things the bot will say on its death if taunting is enabled.Using {N} replaces that with the players name.
  • private string[] Killed is a collection of things the bot will say when it kills a player. Using {N} replaces that with the players name.