Better Npc

depends on

Npc Spawn

About Better Npc

This plugin adds variety of NPC sets with very high number of parameter sets on standard and custom monuments. Also it is added during dropping the server AirDrop, locked crate and destroying a tank or helicopter

Dependencies (optional, not required)

Custom maps

Maps that have default settings for their custom monuments. For these maps, you will not need to create places for the appearance of NPCs, they have already been created by the map developer and are located inside the archive when buying the map
You can also download all these files for all maps here

Standard monuments

This item of the plugin settings is used for appearing NPCs in all standard monuments. All these settings are located in the Monument folder (oxide/data/BetterNpc/Monument). Each file in this folder corresponds to a standard monument

If there is no standard monument file in the folder, you can create it (you need to name the file the same way as the standard monuments on the map inside the game). You can copy the settings from any other standard monument

Configuration parameters:

Enabled? [true/false] – It allows to enable/disable the appearance of NPC on the monument. If you need NPCs appearing on the map and don’t need it on another map, you can use this option simply
The size of the monument – this parameter contains two values. It is the length and width of the monument. This parameter is necessary for random appearance of NPC on the monument and indication of limits of removal of standard NPCs on the monument (if it is necessary)
Remove other NPCs? [true/false] – It deletes the standard NPCs inside the limits of this monument
Presets – It is a list of all the NPC presets to appear on the monument (the description of the NPC preset settings is located below)

Custom monuments

This item of the plugin settings is responsible for the appearance of NPCs on custom monuments. All these settings are located in the Custom folder (oxide/data/BetterNpc/Custom). Each file in this folder corresponds to a custom monument

If you have bought a map with already configured NPC appearance files for custom monuments you will copy these files into the Custom folder. If you want to create and configure the appearance of NPC in your custom location on the map, you will use the command in the administrators’ chat /SpawnPointAdd {name} (see the description of this command below in the instruction)

Configuration parameters:

Enabled? [true/false] – It allows to enable/disable the appearance of NPC on the monument. If you need NPCs appearing on the map and don’t need it on another map, you can use this option simply
Position – It is a position of the custom monument on the map
Rotation – It is a rotation of the custom monument on the map (this parameter is necessary for using custom places to appear of NPC on the monument, if the monument is used on more than one map)
Radius – It is the radius of the custom monument from the position on the map
Remove other NPCs? [true/false] – It removes the standard NPCs inside the limits of this monument
Presets – It is a list of all the NPC presets to appear on the monument (the description of the NPC preset settings is located below)

Roads

This item of the plugin settings is used to appear NPCs on all types of roads. All these settings are located in the Road folder (oxide/data/BetterNpc/Road). Each file in this folder corresponds to a particular road type

ExtraNarrow – It is a narrow, unpaved walkway

ExtraWide It is a wide, paved, two-lane, beltway road

Standard – It is a regular, paved road

Configuration parameters:

Enabled? [true/false] – It allows to enable/disable the appearance of NPC on the road. If you need NPCs appearing on the map and don’t need it on another map, you can use this option simply
Presets – It is a list of all the NPC presets to appear on the road (the description of the NPC preset settings is located below)

Biomes

This item of the plugin settings is used to appear NPCs on all types of biomes. All these settings are located in the Biome folder (oxide/data/BetterNpc/Biome). Each file in this folder corresponds to a particular biome type (Arctic, Arid, Temperate, Tundra)

Configuration parameters:

Enabled? [true/false] – It allows to enable/disable the appearance of NPC on the biome. If you need NPCs appearing on the map and don’t need it on another map, you can use this option simply
Presets – It is a list of all the NPC presets to appear on the biome (the description of the NPC preset settings is located below)

In-game events

This item of the plugin settings is used to appear the NPCs in standard Rust events. All of these settings are located in the Event folder (oxide/data/BetterNpc/Event). Each file in this folder corresponds to its own type of event

The supported events:

When the plane drops the server AirDrop, it will be guarded by specific NPC presets

CH47 – When the chinook drops a locked crate during patrolling the map, it will be guarded by specific NPC presets

Bradley – When someone destroys a tank, its crates will be guarded by specific NPC presets

Helicopter – When someone shoots down a patrol helicopter, its crates will be guarded by specific NPC presets

Configuration parameters:

Enabled? [true/false] – It allows to enable/disable the appearance of NPC on the event. If you need NPCs appearing on the map and don’t need it on another map, you can use this option simply
Radius – NPC appearance radius
Presets – It is a list of all the NPC presets to appear on the event (the description of the NPC preset settings is located below)

The NPC preset parameters

Enabled? [true/false] – It is enabling/disabling the preset
Minimum numbers – Day – It is the minimum number of NPCs from the day preset
Maximum numbers – Day – It is the maximum number of NPCs from the day preset
Minimum numbers – Night – It is the minimum number of NPCs from the night preset
Maximum numbers – Night – It is the maximum number of NPCs from the night preset
NPCs setting – It is all NPC settings of this preset (see the description of NPC settings for details)
Type of appearance (0 – random; 1 – own list) – It is a type of NPC appearance. You can create your own list of places of NPC appearance. The NPC will appear only randomly. This parameter is not used in Road appearance types
Own list of locations – It is your own list of NPC appearances. You need to use the number of locations at least the maximum possible number of NPCs in this preset. This parameter is not used in Road appearance types
The path to the crate that appears at the place of death – It is the full path to the crate prefab that appears at the place of death of an NPC. If you don’t need this parameter, you should leave this blank
Which loot table should the plugin use (0 – default; 1 – own; 2 – AlphaLoot; 3 – CustomLoot; 4 – loot table of the Rust objects; 5 – combine the 1 and 4 methods) – It is the type of the NPC loot table in this preset. Type 5 includes two types (1 and 4) at the same time and locates items from both types
Loot table from prefabs (if the loot table type is 4 or 5) – It is a setting of the loot tables from Rust objects. You can see the loot table of Rust objects description for more details
Own loot table (if the loot table type is 1 or 5) – It’s NPC’s own loot table. You can see the description of your own loot table for more details

The NPC settings description

Names is a list of NPC names. It is selected from the list randomly
Health – It’s the HP amount of the NPC
Roam Range – It’s the patrolling area distance. It’s the distance that the NPC can move from the place of appearance during patrolling
Chase Range – It’s the chase range of the target. It’s the distance that the NPC can chase his target from the place of appearance
Attack Range Multiplier – It’s the attack range multiplier of the NPC’s weapon
Sense Range – It’s a target detection radius
Target Memory Duration [sec.] – It’s the time that the NPC can remember his target
Scale damage – It’s the damage multiplier from NPC to the player
Aim Cone Scale – It’s the spread of NPC shooting, the default value in Rust is 2. It doesn’t take negative values
Detect the target only in the NPCs viewing vision cone? [true/false] – It’s the parameter that allows detecting the target only in a certain NPC viewing. If you want to detect the target in 360 degrees, you will set the parameter “False”
Vision Cone – It’s the NPC viewing. The range of values is from 20 to 180 degrees. If the previous parameter is False, this parameter is not used
Speed – It’s the NPC speed. The default value in Rust is 5
Minimum time of appearance after death [sec.] – It’s the minimum time of NPC appearance after the death. This parameter is not used in the NPC Event places
Maximum time of appearance after death [sec.] – It’s the maximum time of NPC appearance after the death. This parameter is not used in the NPC Event places
Disable radio effects? [true/false] – You can disable/enable radio effects
Is this a stationary NPC? [true/false] – If this parameter is True, the NPC will not move or run
Remove a corpse after death? [true/false] – This parameter can control the deleting of NPC corpses (only backpacks are left). This parameter improves efficiency if there are a lot of NPCs
Wear items – It’s a list of NPCs’ clothes and armor
Belt items – It’s a list of weapons and items NPCs’ fast slots. Medical syringes are used for healing. If you give grenades to an NPC, he will use them. Smoke grenades are used for creating smoke screens (if you don’t need them, you should remove them from your inventory). If you give a Rocket Launcher to an NPC, he will raid the target’s building (if the target is inside it)
Kits – It gives a pack of Kits plugin. If you don’t need this parameter, you should leave this blank. I recommend using the previous 2 points to configure NPC items

A description of the Rust loot table settings

Minimum numbers of prefabs –It’s the minimum numbers of prefabs that are needed to appear in the NPC loot table
Maximum numbers of prefabs –It’s the maximum numbers of prefabs that are needed to appear in the NPC loot table
Use minimum and maximum values? [true/false] – this parameter specifies whether to use the minimum and maximum numbers to limit the number of items
List of prefabs – It’s a list of prefabs that need to add in the loot table. It is necessary to indicate the full path to the prefab and the probability of falling out this prefab

A description of the own loot table settings

Minimum numbers of items – It’s the minimum number of items
Maximum numbers of items – It’s the maximum number of items
Use minimum and maximum values? [true/false] – this parameter specifies whether to use the minimum and maximum numbers to limit the number of items
List of items – It’s a total list of all items that can fall out in the NPC loot table. You can specify any standard items, their blueprints and any skinned or custom items

The commands in the chat (for admins only)

/SpawnPointPos {name} – To show the local admin’s position coordinates relative to the place where the NPC {name} appears

/SpawnPointAdd {name} – To create the NPC appearance point {name} in the Admin’s custom coordinates. A file with this name will be created in the folder Custom and you can configure it as you need

/SpawnPointAddPos {number} {name} – To write the local admin’s coordinate into the preset with the positional number {number} (starting from 1) to the place where the NPC {name} appears

/SpawnPointAddWear {number} {name} – To write all the admin’s dressed clothes into the preset with the positional number {number} (starting from 1) to the place where the NPC {name} appears

/SpawnPointAddBelt {number} {name} – To write all the admins’ quick slots cells into a preset with the positional number {number} ( starting from 1) to the place where the NPC {name} appears

/SpawnPointShowPos {number} {name} – To show to the Admin all the custom NPC appearance points in the preset with the positional number {number} ( starting from 1) in the place where the NPC {name} appears

/SpawnPointReload {name} – Reload Spawn Point with the name {name}

Console commands (RCON only)

ShowAllNpc – Shows the number of all NPCs of the BetterNpc plugin on your server

Hooks

object CanAirDropSpawnNpc(SupplyDrop supplyDrop) – It is called before an NPC appearance to guard an AirDrop. The returning of a non-zero value stops an NPC appearance

object CanCh47SpawnNpc(HackableLockedCrate crate) – It is called before an NPC appearance to guard a locked chinook crate. The returning of a non-zero value stops an NPC appearance

object CanBradleySpawnNpc(BradleyAPC bradley) – It is called before an NPC appearance to guard the boxes from crushed Bradley. The returning of a non-zero value stops an NPC appearance

object CanHelicopterSpawnNpc(BaseHelicopter helicopter) – It is called before an NPC appearance to guard the crates from crushed patrol helicopter. The returning of a non-zero value stops an NPC appearance

API

void DestroyController(string name) – It destroys the place of appearance NPC with the name {name}

void CreateController(string name) – It creates the place of appearance NPC with the name {name}

These APIs can be used with standard monuments, custom monuments (NPC locations) and roads. The name of this monument is in standard monuments {name}. It is the name of the file in the Custom and Road folder in custom monuments and roads

My Discord: KpucTaJl#8923

Join the Mad Mappers Discord here!

Check out more of my work here!

Creator of the default configuration – jtedal