move()

move()

FUNKTION:

Fuer unbelebte Gegenstaende (/std/thing):

varargs int move(object|string dest, int method);

Fuer Lebewesen (/std/living, /std/npc, usw.):

varargs int move(object|string dest, int method, string dir,

string textout, string textin);

DEFINIERT IN

/std/thing/moving.c
/std/living/moving.c

ARGUMENTE

dest
     Das Zielobjekt (entweder der Dateiname oder das Objekt selbst).

method
     Die Art der Bewegung (eine der unten aufgefuehrten Arten; es
     koennen auch mehrere zusammenge-ODER-t werden).

dir
     Die Richtung, in die ein Lebewesen geht. Normalerweise ist das die
     eingeschlagene Laufrichtung (zB. "nach Norden").

textout
     Verlaesst ein Lebewesen einen Raum, so wird diese Meldung in den
     Raum geschickt. Ist bei dir ein String angegeben, so wird dieser
     noch an textout angehaengt. Der Name des Lebewesens wird der
     Meldung in jedem Fall vorangestellt.

textin
     Dieser Text wird im Zielraum ausgegeben, wenn ein Lebewesen ihn
     betritt. Bei normaler Fortbewegung ist das "kommt an". Dem Text
     wird noch der Name des Spielers vorangestellt.

BESCHREIBUNG

Es wird versucht, das Objekt in das Zielobjekt dest zu bewegen.
Abhaengig vom momentanen Aufenthaltsort und dem Zielobjekt ist die
Bewegungsmethode method zu waehlen.

In <moving.h> sind folgende Konstanten fuer die Art der Bewegung
definiert:
M_NOCHECK
     Es werden keine Abfragen durchgefuehrt, ob das Objekt ueberhaupt
     in das Zielobjekt hineinpasst (was zB. aus Gewichtsgruenden der
     Fall sein koennte).

M_GO
     Ein Lebewesen bewegt sich gehend von einem Raum in den naechsten.
     Bei normalem Gehen wird diese Methode benutzt; man sollte sie auch
     benutzen, wenn man Spieler ueber einen SpecialExit in einen
     benachbarten Raum bewegt.

M_TPORT
     Ein Lebewesen wird von einem Raum in einen anderen teleportiert.
     Im Gegensatz zu M_GO kann ein Raum verhindern, dass man ihn
     mittels M_TPORT verlaesst oder betritt.

M_NO_SHOW
     Beim Bewegen von Lebewesen bekommen diese die Beschreibung des
     Zielraumes nicht ausgegeben.

M_NO_ATTACK
     Beim Bewegen von Lebewesen bekommen diese keinen
     Begruessungsschlag, wenn ein Feind im Zielraum steht.

M_SILENT
     Es werden beim Bewegen keine Meldungen ausgegeben. Dieser
     Parameter wirkt sich nur auf das Bewegen von Lebenwesen aus.
     (Magier mit 'mschau an' sehen die Bewegungen dennoch, es wird
      eine Standardmeldung ausgegeben.)

M_GET
     Das Objekt wird von einem unbelebten Objekt (zB. einem Raum, einer
     Leiche, einem Beutel) in ein lebendes Objekt (Spieler oder NPC)
     bewegt.

M_PUT
     Das Objekt wird von einem lebenden Objekt in ein unbelebtes Objekt
     bewegt.

M_GIVE
     Das Objekt wird von einem Lebewesen an ein anderes Lebewesen
     weitergereicht.

M_MOVE_ALL (Nur fuer Objekte, die /std/unit.c erben)
     Es wird die gesamte Menge bewegt, nicht nur ein Teil.

Soll das Objekt auf jeden Fall und ohne jede Abfrage bewegt werden, so
reicht es, als method M_NOCHECK zu uebergeben.

Waffen und Ruestungen werden, soweit sie gezueckt bzw. angezogen sind,
beim Bewegen auf jeden Fall weggesteckt bzw. ausgezogen. Ist in method
M_SILENT enthalten, so geschieht dies ohne Meldungen.

Die erste Art des Funktionsaufrufs ist sowohl beim Bewegen von
Lebewesen als auch von unbelebten Objekten moeglich. Die zweite Art
laesst sich nur bei Lebewesen anwenden.

ANMERKUNG

Diese Funktion sollte nicht (mehr) ueberschrieben werden. Stattdessen
greift bitte auf PreventMove() und NotifyMove() zurueck. RMs sind
aufgerufen, Objekt mit ueberschriebenen move() nur noch dann
anzuschliessen, wenn der Zweck sonst nicht erreicht werden kann. Solltet
ihr move() ueberschreiben: Seid euch sehr genau im klaren, was move()
genau macht. ;-)



Wenn Livings bewegt werden, sorgt move() automatisch in Abhaengigkeit
von P_PARA dafuer, dass das Lebewesen in der korrekten (Parallel-)Welt
landet.

Bei Gegenstaenden wird ebenfalls versucht, die richtige Zielwelt
auszuwaehlen (damit z.B. in der Parallelwelt geworfene Bumerangs auch nur
innerhalb der Parallelwelt fliegen). Um Rechenzeit zu sparen, wird das
allerdings nur versucht, wenn 'dest' ein Filename ist und kein Objekt.

Grund: bei Zielobjekten handelt es sich meist um Bewegungen in das Inv
oder Env eines Spielers - und die sind uninteressant. Raumwechsel dagegen
erfolgen fast immer unter Angabe eines Filenamens anstatt eines Objektes.

RUeCKGABEWERT

Alle Rueckgabewerte sind als symbolische Konstanten in <moving.h>
definiert. (MOVE_OK ist 1, alle anderen sind <0 und symbolisieren Fehler.
Traditionell erfolgt die Pruefung auf erfolgreiches Move mit == 1, in
Zukunft wird == MOVE_OK empfohlen.)



MOVE_OK
     Die Bewegung wurde erfolgreich abgeschlossen.

ME_PLAYER
     Lebewesen lassen sich nicht ohne weiteres bewegen. Es muss
     mindestens eine der Methoden M_NOCHECK, M_GO oder M_TPORT
     angegeben werden.

ME_TOO_HEAVY
     Das Zielobjekt kann dieses Objekt aus Gewichtsgruenden nicht mehr
     aufnehmen.

ME_CANT_TPORT_IN
     Das Zielobjekt verbietet das Teleportieren in sich hinein (nur bei
     M_TPORT ohne M_NOCHECK).

ME_CANT_TPORT_OUT
     Der Raum, in dem sich das Lebewesen befindet, verbietet das
     Teleportieren aus sich hinaus (nur bei M_TPORT ohne M_NOCHECK).

ME_CANT_BE_DROPPED
     Das Objekt kann nicht fallen gelassen werden (zB. weil P_NODROP
     gesetzt ist).

ME_CANT_BE_TAKEN
     Das Objekt kann nicht genommen werden (zB. weil P_NOGET gesetzt
     ist).

ME_CANT_BE_INSERTED
     Das Zielobjekt verhindert das Einfuegen aus bestimmten Gruenden.

ME_CANT_LEAVE_ENV
     Der Container verhindert ein verlassen des Objektes

ME_TOO_HEAVY_FOR_ENV
     Ein Objekt kann einen Behaelter nicht verlassen, da es dem
     Lebewesen sonst zu schwer wuerde.

TOO_MANY_OBJECTS
     Das Zielobjekt kann soviele Objekte nicht mehr aufnehmen.

ME_NOT_ALLOWED
     Raeume mit gesetzter Property P_NO_PLAYERS koennen nur von
     Testspielern und Magiern betreten werden. Bei Spielern oder
     Gildentesties gibt es diese Fehlermeldung.
ME_WAS_DESTRUCTED
     Das Objekt hat sich entweder im Verlaufe der Bewegung selbst
     zerstoert oder wurde zerstoert, sodass move() nicht erfolgreich
     beendet werden konnte. (Bsp: sensitive Objekte)

ME_DONT_WANT_TO_BE_MOVED
     Das Objekt moechte nicht bewegt werden.

BEISPIELE

o Ein Objekt "gibt sich" dem Spieler:

  move(this_player(), M_GET);

o Ein Lebewesen wird in die Abenteurergilde teleportiert:

  lv->move("/gilden/abenteurer", M_TPORT);

o Ein Spieler "wird in die Gilde gegangen":

  this_player()->move("/gilden/abenteurer", M_GO, "in die Gilde");

  Spieler, die mit ihm im gleichen Raum stehen, sehen folgende
  Meldung:
  "<name> geht in die Gilde."

o Ein Spieler schwimmt durchs Meer:

  this_player()->move("meer_xy", M_GO, "nach Norden", "schwimmt",
                      "schwimmt herein");

  Spieler in seinem Startraum sehen "<name> schwimmt nach Norden.",
  Spieler in seinem Zielraum sehen "<name> schwimmt herein."

SIEHE AUCH

Seherkommandos
    setmin, setmmin, setmout, setmmout, review
Verwandt:
    move_object(), remove(), PreventInsert(), PreventLeave(),
    PreventInsertLiving(), PreventLeaveLiving(), PreventMove(),
    NotifyInsert(), NotifyLeave(), NotifyMove(), NotifyRemove(),
    init(), exit()
Properties:
    P_MSGIN, P_MSGOUT, P_MMSGIN, P_MMSGOUT, P_NO_PLAYERS, P_PARA,
    P_NO_TPORT
Objekte:
    /std/thing/moving.c, /std/living/moving.c

2019-Aug-20, Arathorn