Skip to content
This repository has been archived by the owner on Jan 5, 2024. It is now read-only.

Grenade Bandolier Manual

Jump to bottom
Gareth YR edited this page Jun 17, 2023 · 3 revisions

How to create a grenade bandolier:

Requirements: A predefined TDExplosive or ThrownDevice, in other words the grenade you want the bandolier to have.

  1. You have to define a grenade bandolier item in ini as a TDExplosive or ThrownDevice, preferably below the previous grenade, and preferably named something like <Grenade name> Bandolier.
    The quickest way to do so is to just copy the ini of the actual grenade and remove any lua scripts it may have.

    (OPTIONAL) You can also remove stuff like explosion gibs (smoke, etc), and gib sounds of that nature.

  2. Give it the script Base.rte/Devices/Shared/Scripts/GrenadeBandolier.lua.

  3. Give it this list of CustomNumberValues in the ini:

    AddCustomValue = StringValue
	GrenadeName = My Grenade
AddCustomValue = StringValue
	GrenadeTech = MyTech.rte
AddCustomValue = NumberValue
	GrenadeCount = #
AddCustomValue = NumberValue
	ReplenishRate = # in ms
AddCustomValue = NumberValue
	BandolierMass = # in Kg

    (WARNING) if your device is a ThrownDevice instead of a TDExplosive, then you must also input this custom value:

    AddCustomValue = NumberValue
	GrenadeIsThrownDevice = 1

  4. Modify values as needed:
    GrenadeName - The name of the predefined TDExplosive or ThrownDevice you want the bandolier to use.
    GrenadeTech - From what tech the grenade is from.
    GrenadeCount - How many grenades come per bandolier.
    ReplenishRate - How long, in ms, does the bandolier take before replenishing the grenade.
    BandolierMass - The starting weight of the bandolier that will be attached to the actor.

  5. Modify the bandolier item's mass and GoldPrice (IMPORTANT):

    • The mass of the bandolier item should be defined as: Mass = BandolierMass + (GrenadeMass * GrenadeCount).
      GrenadeMass is the mass of the TDExplosive or ThrownDevice the bandolier is going to use.

      EXAMPLE:

       AddCustomValue = NumberValue
 	BandolierMass = 2
 AddCustomValue = NumberValue
 	GrenadeCount = 3
 
 // The mass of an individual grenade is 1.5
 // The mass of the bandolier item should then be: 2 + (1.5 * 3) = 6.5

    • The gold price of the bandolier item should be defined as: GoldValue = GrenadeValue * GrenadeCount.

      EXAMPLE:
      A grenade cost 10oz and its bandolier has 3 grenades. The bandolier should then cost 30oz.

      (OPTIONAL) Consider discounting the bandolier if you make purchasing individual grenades unavailable.

  6. (OPTIONAL) Make the actual grenade non-buyable with the ini property Buyable = 0.
    Make sure to replace them in your loadouts for their bandolier counterparts.

  7. (OPTIONAL) Give it an icon like those of vanilla with the number of grenades in the bandolier.

  8. (OPTIONAL) Write in the description the replenish rate and bandolier mass stats like in vanilla.

Clone this wiki locally