| STANDARDOBJEKT FUER RAEUME: |
| |
| BENUTZUNG: |
| inherit "std/room"; |
| |
| #include <properties.h> |
| #include <rooms.h> // Fuer AddItem() und NewDoor() |
| |
| BESCHREIBUNG: |
| Ein Raum ist ein Objekt, dass von Spielern oder anderen Lebewesen |
| betreten werden kann. Er hat Lang- und Kurzbeschrreibungen von |
| innen und aussen (zum Beispiel Schiffe oder aehnliche Raeume in |
| Raeumen), die sich der Spieler je nach seinen Beduerftnissen |
| anzeigen lassen kann (kurz/lang-Modus). |
| |
| Properties: |
| |
| P_INT_SHORT |
| Kurzbeschreibung innerhalb des Raumes |
| P_INT_LONG |
| Langbeschreibung innerhalb des Raumes |
| P_SHORT |
| Kurzbeschriebung von aussen (nur noetig, wenn man den Raum |
| auch wirklich von aussen sehen kann) |
| P_LONG |
| Langbeschreibung von aussen (siehe P_SHORT) |
| Um Situationsbezogene Beschreibungen zu bekommen, kann man |
| int_short(), int_long(), short(), long() ueberschreiben, oder |
| den process_string Mechanismus verwenden (siehe entsprechende |
| Dokumentation) |
| |
| P_LIGHT |
| Lichtlevel des Raums (0 dunkel, 1 hell) |
| P_INDOORS |
| 1 Wenn der Raum nicht im Freien ist |
| P_TRANSPARENT |
| Ist ungleich 0, wenn man in den Raum von aussen reinschauen |
| kann, oder von innen nach aussen |
| P_NO_TPORT |
| Zum verhindern von Teleportversuchen in oder aus dem Raum |
| (siehe auch /doc/properties.h) |
| P_NOMAGIC |
| Im Raum kann nicht gezaubert werden. |
| |
| Funktionen: |
| AddExit(string|string* kmnd, string zielraum) |
| <kmnd> kann ein String sein oder eine Liste von Strings |
| mit den Kommandos mit denen der Spieler in <zielraum> |
| landen soll. |
| RemoveExit(string|string* kmnd) |
| <kmnd> ist ein String oder eine Liste von Strings, deren |
| Ausgaenge entfernt werden sollen. Dabei muss man etwas vor- |
| sichtig sein, da ein Spieler, der zum Zeitpunkt des Aufrufs |
| im Raum ist, die Aktion fuer sich noch definiert hat. |
| Also: Nur benutzen, wenn man weiss, was man tut! |
| AddSpecialExit(string|string* kmnd, string funktion) |
| <funktion> wird aufgerufen, wenn der Spieler das Kommando |
| <kmnd> tippt (oder eins der Kommandos, wenn <kmnd> eine |
| Liste ist). Nuetzlich zum Beispiel um einen Spieler nur |
| durchzulassen, wenn ein Waechter nicht da ist. |
| RemoveSpecialExit(string|string* kmnd) |
| siehe RemoveExit() |
| NewDoor() |
| siehe /doc/std/door |
| |
| Um Raeume interessanter zu machen, kann man ihnen Details, die |
| vom Spieler angeschaut werden koennen, einbauen: |
| |
| AddDetail(string|string* keys, string descr) |
| Eine Beschreibung von Details, die vom Spieler angeschaut |
| werden koennen wird dem Raum gegeben. <keys> kann ein |
| String sein oder eine Liste von Strings. <descr> ist |
| die Beschreibung, die der Spieler erhaelt. |
| RemoveDetail(string|string* keys) |
| Entfernt ein Detail aus einem Raum. <keys> kann ein String |
| sein oder eine Liste von Strings. |
| AddSpecialDetail(string|string* keys, string function) |
| Im Prinzip wie AddDetail(), nur wird als zweites Argument |
| kein fester String angegeben, sonder eine Funktion, die |
| einen String zurueckgeben muss. Damit kann man variable |
| Details programmieren. |
| RemoveSpecialDetail(string|string* keys) |
| siehe RemoveDetail() |
| AddReadDetail(string|string* keys, string desc) |
| <desc> wird ausgegeben, wenn ein Spieler den <key> liest. |
| <keys> kann wieder ein String oder eine Liste von Strings |
| sein. |
| RemoveReadDetail(string|string* keys) |
| siehe RemoveDetail() |
| AddRoomMessage(string* msg, int prob, string|string *func) |
| Alle <prob> Sekunden wird aus einer Liste von Meldungen |
| (<msg>) zufaellig eine ausgesucht, die dann im Raum er- |
| scheint. Wenn das Argument <func> angegeben ist, wird |
| eine Funktion diesen Namens aufgerufen, der der Index |
| der ausgegebenen Meldung als Argument uebergeben wird. |
| func darf auch einen Array von Funktionen enthalten. Es wird |
| dann zufaellig eine ausgewaehlt. |
| |
| AddCmd(string|string* cmd, string func, int flag) |
| Im Raum wird beim Kommando <cmd> (oder einem der Kommandos) |
| die Funktion <func> aufgerufen. <func> muss 1 zurueck- |
| geben, wenn die Funktion die Kombination aus Kommando |
| und Argumenten akzeptiert, ansonsten 0. Alles was ein |
| Spieler hinter <cmd> noch angibt, wird der Funktion als |
| Argument uebergeben. Wenn <flag> gesetzt ist, wird jedes |
| Kommando, das mit <cmd> beginnt akzeptiert. |
| RemoveCmd(string|string* cmd) |
| Entfernt ein Kommando aus dem Raum. |
| ACHTUNG: Bei Spielern, die zum Zeitpunkt des Funktions- |
| aufrufs noch im Raum sind, ist das Kommando noch definiert. |
| Also: Nur benutzen, wenn man genau weiss, was man tut. |
| |
| AddItem(string filename, int refresh) |
| Ein Objekt mit Pfad <filename> wird erzeugt und in den |
| Raum bewegt, dabei gibt es vier verschiedene Modi, die |
| ueber das Argument <refresh> angegeben werden: |
| REFRESH_NONE: Das Objekt wird nur beim allerersten mal |
| erzeugt, und dann nie wieder (erst beim reboot) |
| REFRESH_DESTRUCT: Ein neues Objekt wird erst erzeugt, |
| wenn das alte zerstoert ist. So kann man sicher |
| gehen, dass nur ein Exemplar im Spiel ist. |
| REFRESH_REMOVE: Beim reset wird ein neues Objekt erzeugt, |
| wenn sich das alte nicht mehr im Raum befindet. |
| REFRESH_ALWAYS: Bei jedem reset wird ein neues Objekt |
| erzeugt. VORSICHT: Kann zu riesigen Mengen von |
| Objekten fuehren, wenn ein Raum lange nicht be- |
| sucht wird. |
| Die Konstanten REFRESH_* sind in <rooms.h> definiert. |
| |
| Auf die Properties P_EXITS, P_SPECIAL_EXITS, P_DETAILS, |
| P_SPECIAL_DETAILS, P_READ_DETAILS, P_COMMANDS und P_ITEMS |
| sollte NICHT direkt zugegriffen werden. |