Sablon:Entity/Ports/doc
More actions
Renders an entity's port loadout as a vertical stack of collapsible category cards (Weapons, Manned Turrets, Coolers, Quantum Drives, Life Support, and so on). Designed to sit as body content on an entity page, separate from the Template:Entity infobox at the top. Reads the same upstream API data via Module:Entity/Data, so the cache is shared with any other Entity-family template on the page.
Works identically for items and vehicles. Each card holds aggregated rows (count + size pill + equipped item link); turret, missile-rack, and quantum-drive parents render an indented L-tree of their children below the row.
Usage
Explicit UUID:
{{Entity/Ports|uuid=80ee3b95-5665-4548-9e2d-d2067895c0ac}}
When Template:Entity has been invoked earlier on the page, the UUID can be omitted. It falls back to the value stored in SMW on the current page:
{{Entity}}
== Ports ==
{{Entity/Ports}}
Parameters
Renders an entity's port loadout as a vertical stack of collapsible category cards. Works for both items and vehicles. Reads upstream API data via Module:Entity/Data and shares cache with the Entity infobox and other Entity-family templates on the page.
| Paraméter | Leírás | Típus | Állapot | |
|---|---|---|---|---|
| UUID | uuid | UUID of the entity to render. If omitted, defaults to the UUID stored in SMW (set by Template:Entity on a prior parse). Required if Template:Entity hasn't been invoked.
| Karakterlánc | nem kötelező |
Behavior
- Renders one Module:CollapsibleCard per category, sorted by an ordering defined in Module:Entity/Ports/categories.json (Weapons before Turrets before Coolers, and so on). Primary categories open by default.
- Sibling ports with identical loadouts collapse into one aggregated row with a count prefix (
04×,13×). Mixed loadouts naturally produce multiple separate rows. M4A-style attachment ports (BAR, MEC, POW, VEN) stay distinct because they accept differentsub_types. - Size pills show the equipped item's size when something is installed, falling back to the port's accepted range when empty (e.g.
S1–5for a flex fuel mount). - Parent ports whose category opts into expansion render an indented L-tree of their children: turrets expose their mounted gun, missile racks expose their missiles, quantum drives expose their jump drive.
- Engine, cockpit, and animation hardpoints (Controllers, Crew Stations, Doors & Hatches, Thrusters, Fuel, and so on) collapse into a single closed-by-default Other card at the bottom of the stack, sub-grouped by their original category label so the reader can still see what's where.
- Hardware-locked ports get a diagonal stripe overlay on their size pill.
Empty and error states
| Condition | Output |
|---|---|
| Apiunto error or unreachable | Muted-italic "Port data unavailable." notice |
apiData.ports missing or empty
|
Muted-italic "No ports." notice |
See also
- Template:Entity — the main entity infobox; sets the SMW UUID this template falls back to.
- Template:Entity/Availability — sibling renderer for where an entity can be acquired.
- Template:Entity/Description — sibling renderer for the in-game description.
- Module:Entity/Ports — implementation.