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