P_NETDEAD_INFO
==============

NAME
----
::

    P_NETDEAD_INFO                "netdead_info"                

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

    /sys/player.h

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

     Wird im Raum X gesetzt und wirkt nur, falls dieser Raum ein '#' im
     object_name() hat (normale Clones, zB "/room/void#10153018").

     

     Bei Einschlafen eines Spielers in diesem Raum werden die Werte aus
     der Property im Spieler gespeichert (Netztoteninformationen).

     Ist beim Aufwachen des Spielers das Raumobjekt X zerstoert worden, dann
     wird bei der Blueprint von X per SetProp() die gespeicherte Information
     gesetzt. Der Rueckgabewert des SetProp wird als Pfad zu einem Ausweich-
     Aufwach-Raum interpretiert und der Spieler wird in dem Fall dorthin
     bewegt.

BEMERKUNGEN
-----------
::

     Zum Clonen von Raeumen sollten Virtual Compiler benutzt werden:
     Wird in den erzeugten Objektnamen KEIN '#' verwendet, dann ist diese
     Property nicht sinnvoll und wird nicht verwendet. Ein ordentlicher
     VC kann Bewegen eines Spielers in dessen alten, nicht mehr existierenden
     Raum oder einen Ersatzraum beim Aufwachen selbst loesen.

BEISPIELE
---------
::

     // #1: geclonter Raum mit Ausweich-Aufwachraum: Klerus-Gilde
     #include <properties.h>
     inherit "/std/room";

     

     void create() {
       ::create();

       SetProp(P_NETDEAD_INFO, "/gilden/klerus");
       SetProp(P_LIGHT, 1);
     }

     

     // #2: komplexerer Beispielraum fuer P_NETDEAD_INFO-Funktionalitaet
     // Siehe auch: /doc/beispiele/testobjekte/netdead_info_testraum.c
     #include <properties.h>
     inherit "/std/room";

     void create() {
       ::create();

       if (clonep(this_object()))
         // setze Informationen, die im Netztoten gespeichert werden sollen
         Set(P_NETDEAD_INFO, random(5));
       else
         // Blueprint: hier kann man zu einem Cloneraum gehen
         AddExit("cloneraum", #'create_room);

       // Set-Method, um die Informationen aus P_NETDEAD_INFO beim Aufwachen
       // in der Blueprint auswerten zu koennen
       Set(P_NETDEAD_INFO, #'create_destiny, F_SET_METHOD);
       SetProp(P_LIGHT, 1);
     }

     

     // Raum entfernen, normalerweise so KEINE GUTE IDEE!
     void BecomesNetDead(object pl) {
       call_out(#'remove, 30);
     }

     // erzeuge einen Cloneraum und bewege den Spieler dahin
     int create_room(string dir) {
       object dest = clone_object(object_name(this_object()));
       this_player()->move(dest, M_NOCHECK);
       return 1;
     }

     

     // Set-Method fuer P_NETDEAD_INFO: gibt Pfad zurueck
     // benutze die Informationen aus dem jetzt aufwachenden Netztoten, um
     // einen alternativen Aufwachraum zu ermitteln, da der Einschlafraum
     // zerstoert ist
     string create_destiny(mixed val) {
       if (intp(val)) {
         switch (val) {
           case 0:
             return "/d/ebene/room/PortVain/po_haf1";
           case 1:
             return "/gilden/klerus";
           case 2:
             return "/gilden/karate";
           default:
         }
         return "/d/ebene/room/waldweg4";
       }
     }

2. Jan 2012 Gloinson