Stationpedia

Vanilla game class at Assets.Scripts.UI.Stationpedia. Singleton controller of the in-game Stationpedia window. Exposes Register, SetPage, OnPageChanged, and owns the row prefab inventory used by page rendering.

Core classes and line references

Source: F0200.

Class	Line	Purpose
Stationpedia : ResizableWindow, IModal	230120	Singleton controller of the pedia window
StationpediaPage	233507	Data model for one page
StationpediaCategory : UserInterfaceBase	233199	UI for one collapsible category
UniversalPage : UserInterfaceBase	233792	Whole-page renderer
SPDALogic : UserInterfaceBase	233092	One logic-row prefab (two TMP fields)
StationLogicInsert	233362	Data model for one logic row
HelpLinkHandler : UserInterfaceBase, IPointerClickHandler, ...	221638	Vanilla TMP link-click handler (uses WorldManager.IsGamePaused in LateUpdate)
SPDAEntryType (enum)	233007-233017	Members: Undefined, Guides, Lore, Maximum

Register semantics and fallback modes

Source: F0203.

Stationpedia.Register(StationpediaPage page, bool fallback = false) at game.cs:230948-230969:

public static void Register(StationpediaPage page, bool fallback = false)
{
    _linkIdLookup.TryGetValue(page.Key, out var value);
    if (!fallback || value == null)
    {
        if (value != null)
        {
            _linkIdLookup.Remove(value.Key);
            StationpediaPages.Remove(value);
        }
        if (page.DisplayFilter == SPDAEntryType.Guides) GuidesPages.Add(page.Key);
        else if (page.DisplayFilter == SPDAEntryType.Lore) LorePages.Add(page.Key);
        StationpediaPages.Add(page);
        _linkIdLookup.Add(page.Key, page);
    }
}

• fallback:false (default): always replaces existing entry.
• fallback:true: inserts only if key is missing.

Both StationpediaPages (public list) and _linkIdLookup (private dict) are kept consistent on replace. The page object reference is shared; mutation via one is visible via the other.

Row prefab inventory

Source: F0217.

Row prefabs visible as public fields on Stationpedia.Instance (game.cs:230122-230150):

public SPDAListItem ListInsertPrefab;
public SPDAListItem ListSearchPrefab;
public SPDACombustionItem CombustionItemPrefab;
public StationpediaCategory CategoryPrefab;          // what we clone
public SPDASlot SlotInsertPrefab;
public SPDAManufacturer ManufactureInsertPrefab;
public SPDAVersion MachineTierInsertPrefab;
public SPDALogic LogicInsertPrefab;                  // logic row prefab
public SPDAGeneric GenericPrefab;
public SPDAFoundIn FoundInInsertPrefab;
public SPDAFoundIn FermentationInsertPrefab;
public SPDAGeneric InfoBoxPrefab;
public SPDALifeRequirement LifeRequirementPrefab;
public SPDAHomePageCategory HomePageButtonPrefab;

Our helper uses CategoryPrefab (for cloning collapsible sections). The LogicInsertPrefab would be used if we ever needed to inject SPDALogic rows manually (Decision 11A says we don't).

OnPageChanged public event

Source: F0219d.

Stationpedia.OnPageChanged at game.cs:230434 is a public static event Event fired from SetPage (line 230781) whenever navigation changes. Stable, public, no reflection needed. Available as an alternative to Harmony patching for mods that want to react to page navigation without intercepting the render.

Register leak on re-register

Source: F0219e.

Register appends to GuidesPages or LorePages based on page.DisplayFilter (lines 230958-230965) but NEVER removes stale entries. If a mod re-registers a page with a different DisplayFilter, the old entry leaks. Not relevant to StationpediaPlus because reference pages use SPDAEntryType.Undefined and LogicType pages are re-registered with same filter.

Page navigation back-stack

Source: F0219k (back-stack portion).

Stationpedia maintains a private _pageHistory list for the back-button navigation state. Our SixFive7LinkHandler routes clicks to SetPage, so cross-page navigation participates normally in the back stack.

SPDADataHandler and HandleThingPageOverrides (HideInStationpedia application)

Source: decompiled Assembly-CSharp.dll, game version 0.2.6228.27061.

Stationpedia owns a public static SPDADataHandler DataHandler = new SPDADataHandler(); field (game.cs:230341). SPDADataHandler is a global-namespace class (no namespace block in the decompile, unlike Stationpedia which is in Assets.Scripts.UI); Stationpedia.DataHandler is the static instance. Relevant members (game.cs:47678-47744):

public class SPDADataHandler
{
    public Dictionary<string, Dictionary<string, List<StationCategoryInsert>>> _listDictionary = ...;
    public List<string> ListOfAllListOfObjects = ...;
    public Dictionary<string, List<SPDAThingOverideData>> ThingOverrideData = ...;
    public Dictionary<string, bool> HiddenInPedia = ...;

    public void HandleThingPageOverrides()
    {
        foreach (List<SPDAThingOverideData> value in ThingOverrideData.Values)
        {
            foreach (SPDAThingOverideData item in value)
            {
                Thing thing = Prefab.Find(item.ThingName);
                if ((bool)thing)
                {
                    HiddenInPedia[thing.PrefabName] = item.HideInSPDA;
                    thing.HideInStationpedia = item.HideInSPDA;
                }
            }
        }
    }
    // ClearAll(), AddToAllLists(string), AddNewListItem(string, string, StationCategoryInsert) ...
}

HandleThingPageOverrides() is a parameterless public void instance method, called once from Stationpedia.PopulateLists() (game.cs:231991), immediately after a long block of GetPage(...) template lookups and immediately before the foreach (Thing allPrefab in Prefab.AllPrefabs) loop that builds one StationpediaPage per prefab. That per-prefab loop skips a prefab when allPrefab.HideInStationpedia || value is true, where value is DataHandler.HiddenInPedia.TryGetValue(allPrefab.PrefabName, out var value) (game.cs:231995-231998). So a prefab is hidden from the Stationpedia if EITHER Thing.HideInStationpedia is set OR SPDADataHandler.HiddenInPedia[prefabName] is true.

ThingOverrideData is populated from loaded XML page-overrides earlier in the load (game.cs:193982-193990 fills it from SPDAThingOverideData entries; SPDAThingOverideData carries ThingName, ParentListKey, HideInSPDA). Vanilla ships overrides only for a small set; the practical implication for a mod that sets Thing.HideInStationpedia = true on a prefab during prefab-load is that a later-loading mod's page-override for the same prefab with HideInSPDA = false would clear the flag when HandleThingPageOverrides() runs (it does an unconditional thing.HideInStationpedia = item.HideInSPDA). A Harmony postfix on HandleThingPageOverrides is the place to re-assert the flag (and re-write HiddenInPedia[prefabName] = true, since PopulateLists consults both) after that pass and before the per-prefab page build. Used by NetworkPuristPlus (HideLongVariantsStationpediaPatch) as belt-and-suspenders over its imperative HideInStationpedia writes.

Verification history

• 2026-04-20: page created from the Research migration; verbatim content lifted from F0200, F0203, F0217, F0219d, F0219e, F0219k. No conflicts.
• 2026-05-12: added "SPDADataHandler and HandleThingPageOverrides" section. Verified against decompiled Assembly-CSharp.dll in game version 0.2.6228.27061: Stationpedia.DataHandler is a static SPDADataHandler field (game.cs:230341), SPDADataHandler is a global-namespace class (game.cs:47678), HandleThingPageOverrides() is a parameterless public void instance method (game.cs:47693) called from Stationpedia.PopulateLists (game.cs:231991) right before the per-prefab page-build loop; the loop skips a prefab when HideInStationpedia || HiddenInPedia[name]. Additive (the page did not previously mention SPDADataHandler); no conflict, no fresh validator needed.

Open questions

None at creation.