BNWCS Weapon API

Intro

To enhance your weapons for the BNWCS, you will need the "BNWCS Developer's Kit."

Splash Damage

Splash damage allows you to make an object that will damage all avatars that are both wearing a BNWCS health meter, and are within a set distance from the object. To implement the Splash Damage API in one of your scripts, follow these steps:

  1. Place the "BNWCS.api.AoE.lsl" next to the other script(s) inside your projectile.
  2. Add the following line of code to your main projectile script, wherever you have code that you want to deal BNWCS Splash damage:
    //----------
    llMessageLinked(LINK_SET,damage,"BNWCS AoE","range");
    //----------
    
    replace the word "damage" with a number (up to 100) of damage.
    replace the word "range" with a number between 0 and 10. Leave the number in quotation marks. "Range" is the *radius* of the splash damage - that is to say, avatars that are less than RANGE meters from the object, will take damage, while avatars that are further than range meters, will not take damage.
  3. Done!

Advanced Splash API Usage

  • Targetted Splash

    You can set the AoE API to only damage a specific avatar within range, by adding that avatar's UUID to the linked message, like so:
    //----------
    llMessageLinked(LINK_SET,damage,"BNWCS AoE","range|target_uuid");
    //----------
    
    Where "target_uuid" is the target avatar's UUID Key. If that avatar is within range, they will take damage. Other avatars within range will not take damage.
  • Confirm Splash Damage

    When the Splash API successfully receives your linked message, and activates, it will send the following linked message back - so your scripts can know that the damage was sent.
    //----------
    llMessageLinked(LINK_SET,damage,"BNWCS AoE Sent","range|target_uuid");
    //----------
    

Caveats:

  • "damage" values over 100 will be ignored by the BNWCS
  • The BNWCS will automatically make damage decrease slightly as distance increases.
  • Very close splash damage will not "fall off" at all, and avatars will take the full damage.
  • Splash damage is affected by a combat zone's "damage modifier" much less than normal damage.
  • Vehicles and Targets may have armor that will reduce the damage they take from the splash API.
  • The BNWCS enforces a delay between splash damage. After taking splash damage, a BNWCS will ignore all other splash damages for a number of seconds equal to:

    (Splash damage maximum range), or 2, whichever is larger.
    5 seconds if the source of the splash damage is inside the avatar's hitbox.

    For example, a BNWCS grenade going off 3 meters from an avatar, set for a maximum of 5 meters, would cause the BNWCS to wait 5 seconds before accepting any more splash damage.


Last updated Feb 28, 2010
meter_state
integer

Values:
0: Loading
1: Non-combative
2: Combative
3: Dead
Team
string

Values:
None, Red, Orange, Yellow, Green, Blue, Purple, Pink
Achievement_Type
string

Values:
headshot, multi_kill, killing_spree
This is a list of all the avatar's statistics and ranking information for the current sim, in stat=value format.

You would probably want to split this string at an ampersand (&) character, then split each of THOSE pieces at an equals sign (=).

The statistics are identified by shortened names in lower-case, as follows:

rtg: Rating
k: Kills
d: Deaths
a: Assists
kpd: Kills per Death
m: Longest Life
p: Total Playtime
r: Revived
hl: Healed
s: Sniped
hd: Headshots
mk: Multikills
ks: Killing Sprees
rnk: Rank
This is a list of all of the sim's settings, as provided by the "BNWCS Combat Zone Custom Settings Server" object.

You would probably want to split this string at an ampersand (&) character, then split each of THOSE pieces at an equals sign (=).

More information about all the different settings you will encounter in this string can be found at http://BNWCS.org/?zone_notes
Statistic_Name
string

Values:
Rating
Kills
Deaths
Assists
KPD (Kills per Death)
Maxlife (Longest Life)
Playtime (Total Playtime)
Revived
Healed
Sniped
Headshots
Multikills
Sprees (Killing Sprees)
Rank