blob: 13344f1d6715ddaf00c1b8f7dee0053f36bdcd3b [file] [log] [blame]
Zesstrabab5a9d2016-07-30 12:53:35 +02001NAME:
2 P_SYNTAX_HELP "lib_p_syntax_help"
3
4DEFINIERT IN:
5 /sys/thing/commands.h
6
7BESCHREIBUNG:
8 In dieser Property kann man fuer Spieler eine ausfuehrliche Syntaxhilfe zu
9 den Kommandos eines Objektes ablegen. Diese wird angezeigt, wenn der
10 Spieler das Kommando "synxtaxhilfe <objekt>" eingibt.
11 Die Property kann verschiedene Datenstrukturen enthalten:
12
13 1) ein String
14 Der String wird angezeigt, hierbei ggf. umgebrochen, vorhandene
15 Zeilenumbrueche werden beibehalten.
16
17 2) ein Array: ({hilfetext, bedingungen})
18
19 <hilfetext>:
20 * ein string:
21 Der String wird angezeigt, hierbei ggf. umgebrochen, vorhandene
22 Zeilenumbrueche werden beibehalten.
23 * eine lfun-closure:
24 Diese erhaelt beim Aufruf das betreffende Objekt als Argument.
25 Wenn diese dann einen String zurueckliefert, wird dieser dem Spieler
26 angezeigt. Hierbei wird ggf. umgebrochen, vorhandene Zeilenumbrueche
27 werden beibehalten.
28
29 <bedingungen>, welche erfuellt sein muessen, damit dem Spieler die Hilfe
30 angezeigt wird. Die Bedingungen sind entweder:
31 * ein Mapping fuer check_restriction()
32 * eine lfun-closure
33 Diese erhaelt beim Aufruf das betreffende Objekt als Argument und darf
34 eine 0 fuer 'erlaubt', 1 fuer 'nicht erlaubt (mit Standardtext)' oder
35 einen string fuer 'nicht erlaubt mit individuellem Text' sein.
36
37BEMERKUNGEN:
38 Hat ein Objekt keine Syntaxhilfe, wird das Kommando "syntaxhilfe" aus dem
39 Objekt wieder entfernt (d.h. die Property muss gesetzt sein, bevor der
40 erste Spieler das Kommando eingibt).
41
42SIEHE AUCH:
43 AddCmd
44