Modul:Entity/Location/doc
Weitere Optionen
Dies ist die Dokumentationsseite für Modul:Entity/Location
| Function list |
|---|
| L 68 — p.getApiConfigs L 102 — isJumpPointRecord L 142 — recordFamily L 176 — p.matches L 190 — p.resolveSubtype L 205 — p.getEditorialManifest |
Orts-Art (Location-Kind) des Entity-Frameworks: Entitäten hinter dem Spieldaten-Endpunkt /api/locations (Sternensysteme, Sprungpunkte, Sterne, Planeten, Monde, Asteroidenformationen und Orte). Sechs Leafs rendern es: StarSystem, JumpPoint, Star, Body, Belt und Place.
Editoren rufen dieses Modul nie direkt auf; es läuft innerhalb von Vorlage:Location, die die Art deklariert, oder innerhalb von Vorlage:Entity, wenn die UUID der Seite einen Datensatz dieser Art auflöst. Pipeline und Hook-Tabelle stehen auf Modul:Entity.
Für Modul-Editoren
API
p.name = 'Location': kanonischer Artname, alsData.get(args).kindexponiert.p.editorialMode = true: eine artdeklarierte Seite ohne echten Datensatz rendert über den redaktionellen Zweig — der Einstieg für Lore-Systeme, die nur in der Starmap existieren.p.defaultFamily = 'starsystem': das Leaf, das eine artdeklarierte Seite ohne typisierten Datensatz annimmt.p.matches(apiData): wahr für eine Standort-Signatur (respawn_location_type) und einen Datensatz, den ein Leaf rendert. Sprungpunkt-Gates tragen den TypAnomaly, den sie sich mit Wrackteilen teilen; ein Gate wird am exaktenJump Point-Namenspräfix/-suffix erkannt.p.resolveSubtype(apiData, args): ein typisierter Datensatz entscheidet allein.recordFamilyist dreiwertig und die Unterscheidung trägt: String nennt das Leaf,falsemarkiert einen typisierten Datensatz, den kein Leaf modelliert (Wrack, schlichter Asteroid),nilheißt gar kein Datensatz. Nurnilfällt an|family=durch.p.getApiConfigs(): der Identitäts-Endpunktlocations/%s.p.getEditorialManifest(): die kindweiten Lore-Felderdiscoveredin,discoveredby,historicalnames.
Leaves
Zwei Starmap-Brücken bedienen alle sechs Leafs und schließen einander aus: StarSystem, Body, Belt und Place holen über attachStarsystem ein ganzes System als apiData.starsystem; JumpPoint und Star über attachCelestialObject ein Objekt als apiData.celestialobject.
- StarSystem (
starsystem): Brücke über den Systemnamen. Liefert Systemtyp- und Zugehörigkeitskategorien, einen eingeklappten Orbitalzonen-Abschnitt sowie Starmap-Schaltfläche und Metadatenzeile. - JumpPoint (
jumppoint): Brücke über|starmapcode=. Ein- und Ausgangssystem kommen zuerst aus dem kanonischen Seitennamen, dann aus der Starmap-Bezeichnung. - Star (
star): eine Seite pro Stern, dazu das schwarze Loch in derselben Gestalt. Die Klassifizierung ist der Infobox-Untertitel;getCategorieslöst die Spektralklasse aus dem Starmap-sub_type, bevor der Anzeigetext drankommt. Radius bevorzugt|radius=, sonst die Starmap-sizein km, unterdrückt unter 5 km und über dem Klassen-maxRadiusKm. - Body (
body): Planeten und Monde in einem Leaf, weil sich ein Mond von einem Planeten nur im Elternteil unterscheidet. Gibt den SYSTEMNAMen explizit weiter, daapiData.nameder Körper selbst ist. Mond-oder-Planet entscheidet in fünf Schritten (Datensatz-Elterntyp, eigener Typ,|type=, Starmap-Token, Default Planet). Radius liest diesizedes Datensatzes in Metern, nie die der Starmap; ohne Datensatz gilt|radius=in Kilometern. - Belt (
belt): Gürtel, Haufen und Planetenringe. Nichts dispatcht hier aus einem Datensatz, weil dieAsteroid-Zeilen der Locations-API in-systemische POIs sind, nicht die Formationen der Starmap; jede Seite trägt|family=belt|system=.BELT_TYPESbildet die ARK-sub_types auf die Wiki-Begriffe ab; jeder Eintrag nenntpage, weil die Familie eine Konzeptseite hat statt Typindizes. Die Distanz-Zeile ist ARK-distancein AE, elternrelativ; ein Ring meldet 0 und die Zeile entfällt. - Place (
place): Stationen, Außenposten, Landezonen und ihre Einrichtungen; die Klasse ist ein kuratiertes|classification=aus classes.json. Die Zone (surface, orbit, lagrange, inside, star) kommt zuerst aus|lagrange=/|zone=, dann aus dem Datensatz, sonst der Klassen-Default. Die Zuständigkeit kommt aus Modul:Entity/Location/Jurisdiction.
Erweitern
Ein weiteres Leaf: pages/module/Entity/Location/<Name>.lua mit p.parent = 'Entity/Location' und einem p.family, das mit seinem LOCATION_SUBTYPE_MAP-Schlüssel übereinstimmt. Genau ein Eintrag in LOCATION_SUBTYPE_MAP (ein Loader), und recordFamily muss den Token für die beanspruchten Datensätze liefern. testSubtypeLeavesConformToChainLinkContract in den Testcases validiert jedes Leaf gegen Modul:Entity/Contract im strikten Modus; ein neues Leaf ist damit abgedeckt, sobald es in der Map steht.
Stolperfallen
- Ein datensatzloses Lore-System rendert über den redaktionellen Zweig:
apiDataresettet auf{}und die Kette reruntenrichallein ausargs— so bekommt auch ein Starmap-only-System seine Brücke. attachStarsystemnamespaced den Starmap-Datensatz alsapiData.starsystemund merged nie flach: beide Payloads tragen kollidierendename/type/description/affiliation-Schlüssel.attachCelestialObjectfragt?include=starsystem, weil das der einzige verlässliche Weg ist, das System eines Objekts zu benennen: das erste Segment eines Starmap-Codes ist ein Code, kein Name.- Die
Jump Point-Namensanker sind absichtlich case-sensitiv und ungetrimmt: die API emittiert die Titelcase-Form ohne nachfolgende Leerzeichen auf jedem beobachteten Datensatz.


