blob: a8a75155053d5e26a8eb4293906e0bd7c60c502a [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001P_HARBOUR
2=========
3
4NAME
5----
6::
7
8 P_HARBOUR "harbour_name"
9
10DEFINIERT IN
11------------
12::
13
14 /sys/transport.h
15
16BESCHREIBUNG
17------------
18::
19
20 Array mit eindeutiger Bezeichnung des 'Hafens'
21
22BEMERKUNGEN
23-----------
24::
25
26 Diese Property wird in Raeumen gesetzt, die als Anleger fuer Transporter
27 dienen sollen. Sie enthaelt ein Array aus zwei Elementen, einem String
28 und einem String-Array, zum Beispiel:
29
30 ({ "zur Sonneninsel", ({"sonneninsel"}) }) oder
31 ({ "nach Titiwu", ({"titiwu"}) })
32
33 Damit bekommt der Spieler bei einer Abfrage seiner Reiseroute mittels
34 "reise route" eine Ausgabe wie
35 'Du reist mit dem Floss nach Titiwu' oder
36 'Du reist mit dem Wal zur Sonneninsel'.
37
38 Das zweite Element der Property enthaelt eine Liste der IDs, mit denen
39 sich der Hafen mit dem Befehl "reise nach <ID>" ansprechen laesst. Im
40 Beispiel oben wuerde also "reise nach sonneninsel" und
41 "reise nach titiwu" akzeptiert werden. Der erste Eintrag in dieser ID-
42 Liste wird in der Ausgabe des Befehls "reise route" verwendet, sollte
43 also den Anlegeort korrekt bezeichnen und nicht z.B. eine Abkuerzung
44 enthalten.
45 Es bietet sich an, bei bestimmten, deklinierbaren Bezeichnungen alle
46 Varianten einzutragen, z.B. "verlorenes land" und zusaetzlich
47 "verlorene land" und "verlorenen land", damit alle Varianten von
48 "reise nach ..." funktionieren.
49
50 Ist in einem Hafen diese Property nicht gesetzt, so bekommt der
51 Spieler keinerlei Hinweis darauf, wohin ihn ein bestimmter Trans-
52 porter befoerdert.
53 Stattdessen erhaelt er die Bezeichnung 'unbekannt'.
54
55HINWEISE
56--------
57::
58
59 Wird der zweite Parameter in dieser Property, d.h. die Liste der
60 Anleger-IDs, nicht korrekt gesetzt, kann das dazu fuehren, dass Spieler
61 den hier anlegenden Transporter nicht benutzen koennen, weil es
62 keine sinnvolle Syntax gibt, um den gewuenschten Zielhafen zu finden.
63
64 Zu achten ist auch darauf, das der erste Eintrag unveraendert in einer
65 Meldung an den Spieler ausgegeben wird, d.h. Gross-und Kleinschreibung
66 sollte korrekt sein.
67
68HISTORIE
69--------
70::
71
72 Frueher war der zweite Eintrag in dieser Property ein einzelner String.
73 Es existiert eine SetMethode auf dieser Property, die solche Daten in
74 altem Code auf die neue Datenstruktur umbiegt. Dies fuehrt dazu, dass
75 bei solchen Objekten die im geladenen Raum enthaltenen Daten nicht mit
76 den Daten im File uebereinstimmen. Dies moege aber bitte niemand
77 zum Anlass nehmen, in neuem Code veraltete Daten in die Property zu
78 schreiben!
79
80
81
82SIEHE AUCH
83----------
84::
85
86 Properties: P_NO_TRAVELING, P_TRAVEL_INFO
87 Funktionen: AddRoute(L)
88 Spielerbefehle: reise
89 weitere Doku: /d/inseln/schiffe/HowTo
90
91LETZTE AENDERUNG
92----------------
93::
94
952015-Jan-18, Arathorn
96