FUNKTION:
varargs int UnlockDoor(string cmd, object akteur, object key)
DEFINIERT IN:
/std/room/doors.c
/sys/doors.h
ARGUMENTE:
cmd - Kommando fuer das Durchschreiten der Tuer (z.B. "osten")
akteur - (optional) der Spieler der die Tuer oeffnet, also im Sinne
des ET_DOOR_UNLOCK Events der ET_DOOR_ACTOR
key - (optional) der passende Tuerschluessel, MUSS mit angegeben
werden, wenn die Tuer abschliessbar ist und ein Akteur
angegeben wurde.
RÜCKGABEWERT:
0 - die Aktion ist aus irgendeinem Grund fehlgeschlagen
(Beispiele: Event abgebrochen, Schluessel falsch)
1 - die Aktion war erfolgreich (die Tuer ist aufgeschlossen)
BESCHREIBUNG:
Schliesst die angegebene Tuer auf und erzeugt gegebenenfalls einen
ET_DOOR_UNLOCK Event.
BEMERKUNG:
Ist die Tuer bereits aufgeschlossen, returnt UnlockDoor() ebenfalls
1, es wird aber kein ET_DOOR_UNLOCK Event durchgefuehrt.
Wird ein Akteur und Schluessel angegeben, muss dieser Schluessel
auch zur vorgegebenen Tuer passen, sonst schlaegt UnlockDoor() fehl.
BEISPIELE:
Im Raum:
UnlockDoor("osten");
-> Schliesst die Tuer nach Osten auf, unabhaengig vom Akteur.
raum->UnlockDoor("osten", this_player(), schluessel);
-> this_player() schliesst die Tuer nach Osten in Raum 'raum' mit
Schluesselobjekt 'schluessel' auf.
SIEHE AUCH:
AddDoor(L), RemoveDoor(L), OpenDoor(L), CloseDoor(L), LockDoor(L),
HideDoor(L), ET_DOOR_UNLOCK, SetDoorEventMsgs(L),
QueryDoorEventMsgs(L), doors(WL)
|