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