Jump to content
Menü aufrufen
Toggle preferences menu
Persönliches Menü aufrufen
Nicht angemeldet
Ihre IP-Adresse wird öffentlich sichtbar sein, wenn Sie Änderungen vornehmen.

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, als Data.get(args).kind exponiert.
  • 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 Typ Anomaly, den sie sich mit Wrackteilen teilen; ein Gate wird am exakten Jump Point-Namenspräfix/-suffix erkannt.
  • p.resolveSubtype(apiData, args): ein typisierter Datensatz entscheidet allein. recordFamily ist dreiwertig und die Unterscheidung trägt: String nennt das Leaf, false markiert einen typisierten Datensatz, den kein Leaf modelliert (Wrack, schlichter Asteroid), nil heißt gar kein Datensatz. Nur nil fällt an |family= durch.
  • p.getApiConfigs(): der Identitäts-Endpunkt locations/%s.
  • p.getEditorialManifest(): die kindweiten Lore-Felder discoveredin, 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; getCategories löst die Spektralklasse aus dem Starmap-sub_type, bevor der Anzeigetext drankommt. Radius bevorzugt |radius=, sonst die Starmap-size in 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, da apiData.name der Körper selbst ist. Mond-oder-Planet entscheidet in fünf Schritten (Datensatz-Elterntyp, eigener Typ, |type=, Starmap-Token, Default Planet). Radius liest die size des 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 die Asteroid-Zeilen der Locations-API in-systemische POIs sind, nicht die Formationen der Starmap; jede Seite trägt |family=belt|system=. BELT_TYPES bildet die ARK-sub_types auf die Wiki-Begriffe ab; jeder Eintrag nennt page, weil die Familie eine Konzeptseite hat statt Typindizes. Die Distanz-Zeile ist ARK-distance in 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: apiData resettet auf {} und die Kette rerunt enrich allein aus args — so bekommt auch ein Starmap-only-System seine Brücke.
  • attachStarsystem namespaced den Starmap-Datensatz als apiData.starsystem und merged nie flach: beide Payloads tragen kollidierende name/type/description/affiliation-Schlüssel.
  • attachCelestialObject fragt ?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.
Cookies helfen uns bei der Bereitstellung dieses Wikis. Durch die Nutzung des Star Citizen Wiki erklärst du dich damit einverstanden, dass wir Cookies speichern.