buffer_hp()
===========

FUNKTION
--------
::

    int buffer_hp( int val, int rate );

DEFINIERT IN
------------
::

    /std/living/life.c

ARGUMENTE
---------
::

    val:  Gesamte Heilung.
    rate: LP-Rate.

        

BESCHREIBUNG
------------
::

    Erhoeht die LP eines Spielers automatisch insgesamt um den Wert "val".
    Pro heart_beat() wird ihm dabei der Wert "rate" zugefuehrt.
    Sollen neben P_HP noch weitere Props manipuliert werden - bspw. zur
    P_FOOD - bietet sich die Funktion consume() an.

RUECKGABEWERTE
--------------
::

    Der getankte Wert pro heart_beat().

BEMERKUNG
---------
::

    Sollte von jeder tragbaren Heilung genutzt werden, welche den Spieler
    darauf schliessen lassen kann, auf natuerlichem und nichtmagischem Weg
    (Essen, Trinken) geheilt worden zu sein.

BEISPIEL
--------
::

    #define TP this_player()
    #define BS(x) break_string(x, 78)

    int heilung=1;

    protected void create()
    {
      ::create();
      SetProp(P_NAME,"Heilpflanze");
      ...

      AddCmd("iss&@ID", "eat", "WAS willst Du essen?");
    }

    int eat(string str)
    {
      if ( TP->eat_food(25) )
      {
        TP->buffer_hp(20,5);
        TP->buffer_sp(80,10);
        heilung--;
        tell_object(this_player(), BS("Du fuehlst langsam, wie Deine Kraefte "
            "zurueckkehren."));
      }
      // Wenn der Spieler nichts mehr essen kann, wird die Meldung von 
      // eat_food() erzeugt.
      return 1;
    }

    void reset()
    {
      heilung=1;
      ::reset();
    }

    Es wird durch eat_food() getestet, ob der Spieler noch genuegend essen 
    kann. Wenn ja, kriegt unser Held die 25 automatisch oben drauf und 
    ausserdem 20 LP in 5-LP-Schritten und 80 KP in 10-KP-Schritten 
    gutgeschrieben.

SIEHE AUCH
----------
::

     Aehnlich:  heal_self, restore_spell_points, restore_hit_points, 
                buffer_sp
     Tanken:    consume, drink_alcohol, drink_soft, eat_food
     Props:     P_SP, P_HP,
     Konzepte:  heilung

9. August 2015 Gloinson