Introduction to Weapons

How do I make a Weapon

Advanced Features

Well, right now the weapon is functional, but pretty basic. The 
following functions can be used to spice it up a bit.


    
set_light
    
    USAGE: set_light

    This function makes it so that the weapon actually emits light,
    light that will effect everyone in the room. Positive numbers
    give light while negative numbers make the object absorb
    light.

   
    
add_stat_bonus

    USAGE: add_stat_bonus(stat,amount)

    This function allows to give bonuses to the weapon. See current
    guidelines (help eqstats) to check limits of such bonuses. Valid additions to
    this function are usual statistics (str, con, dex, int, wis, sta),
    regeneration(sp_regen, hp_regen, ep_regen) and special stats
    like all_skills, all_spells, damage, avoid_hits.


 
    
add_resist_bonus()

    USAGE: add_resist_bonus(resistance,percent)     

    Adds a magical bonus to a resistance to the weapon. First argument
    has to be a valid damage type. Second argument is the value of the
    resistance.

    add_resist_bonus("physical", 2);

  
    
set_wield_message()
   
    USAGE: set_wield_msg(string)


    Defines a special message that is displayed to the player when he
    wields the weapon. Message can be based off the messages module.

    set_wield_msg("$N $vfeel a surge of power as $n $vwield the famous "
	          "sword of power.\n");
    
    
set_unwield_msg()
  
    USAGE: set_unwield_msg(string)


    Defines a special message that is displayed to the player when he
    unwields the weapon. Message can be based off the messages module.


    set_unwield_msg("$N $vfeel weak as $n $vunwield the sword.\n");


    
set_magical_damage_type()

    USAGE: set_magical_damage_type(string | mapping )

        
       This functions allow the weapon to do damage types other than physical
       in melee (physical is the default damage). 

       There are two options, the first one is to set a string (which was 
       the original way for it to work) and in that case the weapon will do 
       half physical damage and half fire damage (in our example, you can use 
       any allowed damage type).

             set_magical_damage_type("fire");

       The two other examples use a mapping as the argument to the function, and
       in that case the mapping must be a list of valid damage types which 
       are affected values that represent percentages. The sum of the values
       must therefore never go over 100. If the sum is inferior to 100, the
       remaining damage is attributed to physical damage type. So in the two
       examples given, first one the weapon will do 75% fire and 25% physical,
       while in the second the weapon will do 10% magical, 10% acid and 80%
       physical.  

             set_magical_damage_type( ([ "fire" : 75 ]) );
             set_magical_damage_type( ([ "magical" : 10, "acid": 10 ]) );

Special Attack

With some weapons, you are going to want to add special abilities 
that are not included in the standard weapon code. The most common is
to give a weapon a special hit. 

The following example does not cover all of the possibilities, by any
means. If you can imagine it, odds are it can be done.

The following code should be located outside the void setup() {} 



void special_attack(object target) 
{
    object attacker = this_object()->query_wielded_by();

    if (random(4)) 
      return;
    attacker->combat_targetted_action(
        "$P mighty broadsword slips past $p1 defenses and strikes "+
        "home!\n", target);
    target->hit_me(random(150), "physical", attacker);
}



This function is called once per round. Since random(4) is true 75% of the
time (true meaning non zero here), it means the attack will occur one round
out of 4. 

Combat_targetted_action is a special messenging function that 
takes into account the flag for combat silent.

If you don't understand any part of this code, please feel free to ask
another wizard to clarify.