| Zesstra | 953f997 | 2017-02-18 15:37:36 +0100 | [diff] [blame] | 1 | |
| 2 | P_HARBOUR |
| 3 | ********* |
| 4 | |
| 5 | |
| 6 | NAME |
| 7 | ==== |
| 8 | |
| 9 | P_HARBOUR "harbour_name" |
| 10 | |
| 11 | |
| 12 | DEFINIERT IN |
| 13 | ============ |
| 14 | |
| 15 | /sys/transport.h |
| 16 | |
| 17 | |
| 18 | BESCHREIBUNG |
| 19 | ============ |
| 20 | |
| 21 | Array mit eindeutiger Bezeichnung des 'Hafens' |
| 22 | |
| 23 | |
| 24 | BEMERKUNGEN |
| 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 | |
| 57 | HINWEISE |
| 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 | |
| 70 | HISTORIE |
| 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 | |
| 82 | SIEHE 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 | |
| 91 | LETZTE AENDERUNG |
| 92 | ================ |
| 93 | |
| 94 | 2015-Jan-18, Arathorn |