ModifySkillAttribute()

FUNKTION

public int ModifySkillAttribute(string atrname, mixed value,
                                int duration)

DEFINIERT IN

/std/living/skill_attributes.c

ARGUMENTE

<atrname>   string
            Name des zu veraendernden Attributes
            (Definiert in /sys/living/skill_attributes.h)

<value>     int oder closure
            Wert des Modifikators
            oder
            eine Closure, welche bei Abfrage des betreffenden SAs
            abgefragt um den Modifikator zu bestimmen.

<duration>  int
            Dauer in Sekunden

BESCHREIBUNG

Aendert temporaer, d.h. fuer eine bestimmte Zeit, ein Skill-Attribut
eines Lebewesen, indem ein Modifikator hinzugefuegt wird.



Der Standardwert eines SA wird von P_SKILL_ATTRIBUTE_OFFSETS festgelegt
oder ist 100, wenn besagte Property leer ist.
Alle Modifikatoren (negativ wie positiv) werden addiert und bilden
zusammen mit dem Standardwert eine Gesamtsumme.
Bei allen SAs ausser SA_QUALITY wird diese Gesamtsumme noch mit
SA_QUALITY (welches sich damit auf alle anderen Skill-Attribute
auswirkt) multipliziert und das Ergebnis stellt den Endwert des SA dar.
(Beispiel s.u.)

Der Wert eines Modifikators muss zwischen -1000 und 1000 liegen. Der
Gesamtwert eines SA kann 10 nicht unter- und 1000 nicht ueberschreiten.

Falle <value> eine Closure ist, wird diese Closure jedesmal
ausgefuehrt, wenn das entsprechende SA abgefragt wird. Der
Rueckgabewert dieser Closure stellt dann den Wert des Modifikators
dar. Auch dieser muss zwischen -1000 und 1000 liegen. Gibt die
Closure keinen int zurueck, wird der Modifikator geloescht.

Gueltige Skill-Attribute sind momentan:
* SA_QUALITY:    Allgemeine Qualitaet: wirkt sich auf alle anderen
                 Attribute auch aus (multplikativ auf Basis 100)
* SA_DAMAGE:     Schaden, den das Lebewesen macht
* SA_SPEED:      Geschwindigkeit des Lebewesens (zB Angriffe/Runde)
* SA_DURATION:   Spell-/Skilldauer
* SA_ENEMY_SAVE: identisch zu SA_SPELL_PENETRATION (OBSOLET!)
* SA_SPELL_PENETRATION: Chance des _Casters_, einen Spell durch ein
                        P_NOMAGIC durchzukriegen.
* SA_RANGE:      Reichweite des Lebewesens (eher unbenutzt)
* SA_EXTENSION:  "Ausdehnung" bei Gruppen-/Flaechenspells: FindGroupN/P

RUECKGABEWERT

SA_MOD_OK              wenn der Modifikator gesetzt wurde
SA_TOO_MANY_MODS       wenn die max. Anzahl an Mods schon erreicht ist.
SA_MOD_TOO_SMALL       wenn der Modifikator zu klein ist
SA_MOD_TOO_BIG         wenn der Modifikator zu gross ist
SA_MOD_INVALID_ATTR    wenn das gewuenschte SA gar nicht existiert
SA_MOD_INVALID_OBJECT  wenn das setzende Objekt ungueltig ist
SA_MOD_INVALID_VALUE   wenn der Modifikator ungueltig ist
Wenn man nur wissen will, ob die Operation erfolgreich war, empfiehlt
es sich, auf == SA_MOD_OK zu pruefen.

BEMERKUNGEN

Nachdem ein Objekt, welches Modifikatoren setzte, zerstoert wurde,
werden die Modifikatoren spaetestens ungueltig, sobald in dem
manipulierten Lebewesen erneut ModifySkillAttribute() gerufen wird!
Bei Closures ist der Mod sofort weg.

BEISPIELE

// sei PL ein Spieler, den mein NPC schwaechen will:
PL->ModifySkillAttribute(SA_QUALITY, -75, 13);
// Fuer 13s wird SA_QUALITY um 75 reduziert. Dies wirkt sich auf alle
// anderen SAs aus! (s. drittes Beispiel)

// sei PL ein Lebewesen, welchem ich fuer 11s 2 Schlaege pro Kampfrunde
// zusaetzlich geben moechte:
PL->ModifySkillAttribute(SA_SPEED, 200, 11);
// wenn keine weiteres Modifikatoren wirken, hat PL jetzt 3 Schlaege
// pro Kampfrunde (Basiswert 100 + 200 == 300 => 3).

Angenommen, ein Lebewesen hat einen Basiswert von 130 auf SA_SPEED und
100 auf SA_QUALITY (P_SKILL_ATTRIBUTE_OFFSETS) und nun 3 Modifikatoren
gesetzt: SA_SPEED +100, SA_SPEED -30 und SA_QUALITY von -10:
Zunaechst wird SA_QUALITY bestimmt: 100 - 10 = 90  => 0.9
Anschliessend wird SA_SPEED bestimmt: 130 + 100 - 30 = 200 => 2
Nun wird SA_SPEED noch mit SA_QUALITY multipliziert: 2 * 0.9 = 1.8
Das Lebewesen hat nun also im Endeffekt 1.8 Schlaege pro Kampfrunde.

SIEHE AUCH

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

5. Okt 2011 Gloinson