MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 1 | Dokumentation fuer das Std-Seil: /obj/seil.c |
| 2 | |
| 3 | Abhaengigkeiten: /sys/thing/seil.h |
| 4 | |
| 5 | Das Standard-Seil ermoeglichst das Festbinden und Loesen eines Seiles an |
| 6 | Objecten und Raeumen. Es kann im ganzen Morgengrauen verwendet werden. |
| 7 | |
| 8 | in den Objecten, die festgebunden werden, wird die Propertie P_TIED gesetzt. |
| 9 | Sie enthaelt ein Mappng der Form: |
| 10 | |
| 11 | ([ |
| 12 | |
| 13 | objectid: ([ "player" : playerid, "time" : timestamp ]) |
| 14 | |
| 15 | ]) |
| 16 | |
| 17 | Wenn ein Object festgebunden wird, so wird die Funktion tie() in dem Object |
| 18 | aufgerufen. Die Funktion muss in dem Object vorhanden sein. Liefert die |
| 19 | Funktion 1 zurueck, darf man ein Seil daran binden. |
| 20 | |
| 21 | Aus der Funktion heraus kann im Seil in der Propertie P_TIE_USER ausgelesen |
| 22 | werden, welche User die Aktion ausgeloest hat. |
| 23 | (Diese Daten werden aus Kompatibilitaetsgruenden nicht an die Fkt. direkt |
| 24 | uebergeben.) |
| 25 | |
| 26 | Wird ein Seil wieder losgebunden, so wird die Funktion |
| 27 | untie() |
| 28 | in dem Object aufgerufen. |
| 29 | |
| 30 | Damit ein Seil in einem Raum festgebunden werden kann, muss der Raum eine |
| 31 | id() bekommen - wie ein normales Object. |
| 32 | |
| 33 | In den Funktionen tie() und untie() kann jeweils ueberprueft werden, ob ein |
| 34 | Spieler ein Seil benutzen darf oder nicht. Liefern die Funktionen 0 zurueck, |
| 35 | so wird die Benutzung des Seiles verweigert. |
| 36 | |
| 37 | Die Funktion seil->query_tied_to_ob() liefert das Object zurueck, an welches |
| 38 | ein Seil gebunden ist oder 0; |
| 39 | |
| 40 | Bei der Benutzung eines Seiles im Raum wird zur Beschreibung die Funktion |
| 41 | name() aufgerufen. Es kann also P_NAME gesetzt werden oder direkt name() im |
| 42 | Raum ueberschrieben werden. |
| 43 | |
| 44 | Seile koennen ueber NPC's/Raeume und Zauber gesteuert werden: |
| 45 | |
| 46 | varargs int binde_seil(string ziel, string msg) |
| 47 | |
Arathorn | 2e97b6a | 2019-12-03 00:37:34 +0100 | [diff] [blame^] | 48 | Ziel beschreibt das Object oder Raum, wo es festgebunden werden soll |
| 49 | msg ist die Ausgabe. Wird msg nicht gesetzt, so wird eine |
| 50 | Standard-Ausgabe ausgegeben. |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 51 | |
| 52 | varargs int loese_seil(string msg) |
Arathorn | 2e97b6a | 2019-12-03 00:37:34 +0100 | [diff] [blame^] | 53 | Das Seil wird geloest - es wird dabei die msg in den Raum |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 54 | ausgegeben. Ist msg nicht definiert, wird eine Standardausgabe |
Arathorn | 2e97b6a | 2019-12-03 00:37:34 +0100 | [diff] [blame^] | 55 | erzeugt. |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 56 | |
| 57 | |
| 58 | Beide Funktionen werden wir von enem Spieler behandelt - es werden tie() und |
| 59 | untie() in den festgebundenen Objecten ausgewertet. |
| 60 | |
| 61 | Eine weitere Propertie ist P_TIE_AUTO. |
| 62 | Dieser Wert steht per Default auf 1 und erlaubt damit eine automatische |
| 63 | Benutzung des Seiles ueber die Funktionen binde_seil() und loese_seil(). |
| 64 | Ist diese Propertie auf 0, so koennen nur Spieler das Seil benutzen. |
| 65 | |
| 66 | |
Arathorn | 2e97b6a | 2019-12-03 00:37:34 +0100 | [diff] [blame^] | 67 | Letzte Aenderung: 25.6. Gando |
| 68 | |