
QuerySkillBonus()
*****************


FUNKTION
========

   int QuerySkillBonus(object caster, object target, mapping sinfo)


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

   beliebigen Objekten


ARGUMENTE
=========

   object caster
        der Benutzer eines Skills/Spells (Lebewesen)
   object target
        das Ziel eines Skills/Spells (beliebiges Objekt oder 0)
   mapping sinfo
        das Skillinfomapping


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

   Diese Funktion wird von der Gilde des Casters im Environment und ggf.
   auch im Ziel eines Skills/Spells gerufen.
   Die Gilde uebergibt neben Caster und Ziel ein Mapping mit Skillinfos (s.
   SI Konstanten aus new_skills.h fuer Details), welches alle wesentlichen
   Informationen ueber den benutzten Skill/Spell enthaelt.

   QuerySkillBonus() liefert einen Bonus (oder Malus) zurueck, den der
   Aufrufer als Faktor in der Berechnung des Effekts des Skills
   beruecksichtigen kann (aber nicht muss).
   Der Bonus/Malus wird hierbei als ganzzahliger 0.01-Prozentwert aufgefasst
   (10000 == 100% == keine Veraenderung, 1 == 0.01%).

   Diese Funktion kann in beliebigen Objekten (re-)definiert werden. Im
   Falle mobiler Objekte oder anhaltender Effekte ist jedoch eine
   Balancegenehmigung erforderlich, sofern kampfrelevante Skills beeinflusst
   werden.
   Eine flaechendeckende Reduzierung von Skills/Gildenfaehigkeiten ist
   explizit _nicht_ erwuenscht und soll auf einzelne Raeume und Objekte
   beschraenkt sein.


BEMERKUNGEN
===========

   Das Mapping <sinfo> kann in dieser Funktion geaendert werden. Dieses kann
   allerdings sehr weitreichende Folgen haben, speziell bei mangelnden
   Kenntnissen ueber Interna des Skillsystems. Daher bitte von Aenderungen
   absehen bzw. vorher mit dem jeweiligen Gildenmagier und/oder der
   Gildenbalance abklaeren.
   Die Bedeutung der Werte in <sinfo> kann je nach Gilde variieren. Im
   Zweifelsfall bitte bei den jeweiligen Gildenmagiern nachfragen.
   Die Gilde kann diese Funktion rufen, muss aber nicht. Ebenso kann sie das
   Ergebnis beruecksichtigen, muss aber nicht.


BEISPIELE
=========

   In einem Raum sollen Heilzauber besonders effizient sein:
   int QuerySkillBonus(object caster, object target, mapping sinfo) {
      if (pointerp(sinfo[SI_MAGIC_TYPE])
          && member(sinfo[SI_MAGIC_TYPE], MT_HEILUNG) > -1)
      {
          return 12000 + random(3000); // bonus von 120-150%
      }
      return 10000;
   }


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

   gilden-doku
   <new_skills.h>


LETZTE AeNDERUNG
================

19.08.2013, Zesstra