ModifySkill()
*************


FUNKTION
========

   public varargs void ModifySkill(string sname, mixed val,
                                   int diff, string gilde)


DEFINIERT IN
============

   /std/living/skills.c


ARGUMENTE
=========

   string sname     der zu aendernde Skill
   mixed val        Aenderungswert: int fuer SI_SKILLABILITY, sonst mapping
   int diff         Schwierigkeit (optional: default ist existierendes diff)
   string gilde     Gilde (optional: default ist eigene Gilde)


BESCHREIBUNG
============

   Mit der Methode kann man die Werte eines Skills/Spells veraendern. Dabei
   wird ein Skill immer in ein Mapping umgewandelt (Skills/Spells koennen
   auch einfach nur ihren Skillwert enthalten, diese ist aequivalent zu
   einem Mapping mit ([SI_SKILLABILITY:<Skillwert>]).

   Ist 'val' ein int, wird dieses als SI_SKILLABILITY gesetzt. Falls der
   Skill nur ein int war, wird ein 'diff'!=0 als SI_DIFFICULTY gesetzt.

   Ist 'val' ein Mapping, wird dieses zum Skillmapping addiert.


   Etwaige SI_SKILLABILITY-Aenderungen laufen danach noch durch LimitAbility.


BEISPIELE
=========

   // #1a: Lerne einen Spell/Skill (einer Gilde)
   caster->ModifySkill("feuerball", MAX_ABILITY, 100, "abenteurer")
   // #1b: ... oder ...
   caster->ModifySkill("feuerball", ([SI_SKILLABILITY: MAX_ABILITY]), 100,
                       "abenteurer")
   // #1c: ... oder fuer einen Abenteurer ...
   caster->ModifySkill("feuerball", ([SI_SKILLABILITY: MAX_ABILITY]), 100);


   // #2: Setze eine Skill-Funktion fuer einen Kampfskill des Klerus
   this_player()->ModifySkill(FIGHT(WT_CLUB),
                              ([SI_SKILLFUNC: "Keulenkampf",
                                SI_DIFFICULTY: 100]),
                              100, "klerus");

   // #3: Speichere im Skill (also Spieler) eine Option fuer diesen Skill
   // Vorteil: dieser Eintrag wird dem Spell immer uebergeben
   caster->ModifySkill("blitz", (["klerus_spell_option": 2]));

   (Code in /doc/beispiele/testobjekte/modifyskillspell_test)
   // #4: Lerne einen unabhaengigen Spell: ACHTUNG
   // dieser Spell funktioniert nur solange, wie die Closure existiert,
   // SI_SKILLABILITY und Spell bleiben jedoch im Spieler gespeichert (!)
   this_player()->ModifySkill("fnrx",
     ([SI_CLOSURE:
         function int (object caster, string skill, mapping sinf) {
           caster->LearnSkill("fnrx", 1);
           tell_object(caster, "Peng! Dein Skillwert steigt auf "+
                               caster->QuerySkillAbility("fnrx")+".\n");
           return ERFOLG;
         },
       SI_SKILLABILITY: 8432]),
     100,
     "ANY");


SIEHE AUCH
==========

   Skills Lernen:  LearnSkill, LimitAbility
   * Nutzung:      UseSpell, UseSkill
   * Abfragen:     QuerySkill, QuerySkillAbility
   * Modifikation: ModifySkillAttribute, QuerySkillAttribute,
                   QuerySkillAttributeModifier, RemoveSkillAttributeModifier
     * Properties: P_SKILL_ATTRIBUTES, P_SKILL_ATTRIBUTE_OFFSETS
   * sonstig:      spruchermuedung
   * Properties:   P_NEWSKILLS

3. Okt 2011 Gloinson