Skip to content

The world graph

Your world’s wiki pages, actors and entities form a graph: nodes joined by mentions and relationships. You see it in two places. The Links tab in the world hub draws the whole world, with every control on this page. Nearby, in the Companion, draws just the thing in focus and what’s immediately around it.

Three kinds of node, each in its own colour:

  • Wiki pages — purple.
  • Actors — rose.
  • Entities — violet.

Two kinds of edge:

  • Mention edges — every wiki link counts as a mention. Drawn as thin grey lines.
  • Relationship edges — the structured edges you’ve added on the Relationships tab. Drawn in a stronger colour, optionally labelled.

Cross-world links (a page in another world that mentions one of yours) appear in amber.

In the Links tab, the graph has the same view controls as every other canvas in the app — boards, World Maps, the Map Foundry and the VTT — in the bottom-right corner.

The tall column is always about the view: Zoom in, the current zoom as a percentage, Zoom out, Zoom to fit, and Centre the graph. The chevron at its foot folds the whole cluster away, and brings it back.

Above it sits the mini map: the whole graph at a glance, with your communities as soft shaded blobs and every node as a dot. The part you’re looking at is the bright window in the dimmed miniature. Click or drag on it to move the graph under you.

The strip under the mini map holds the graph’s own controls — Settings, Export image, and Focus current page, which snaps the view to the selected node — the one you picked in the Nodes list, or arrived on through Open in Links.

The gear icon on the graph opens settings:

  • Show entities / actors / cross-world links — toggle the node classes individually.
  • Show relationships — turn structured rel edges on/off.
  • Show relationship labels — render the rel-type text mid-edge (“parent of”, “member of”) for visible labels at all times.
  • Search — type a query to dim everything that doesn’t match.
  • Hover an edge — a small native tooltip appears with the edge’s meaning (mentions, parent_of, actor mention, mentions (cross-world), etc.). Tooltips work whether or not the persistent rel-label toggle is on.
  • Hover a node — its connections highlight while everything else dims. Disconnected node titles disappear so the focus is clear. Move off to restore.

Open the Companion on a wiki page, entity or actor, and Nearby — under its connections — draws that thing with what’s immediately around it, rather than your whole world, which at that size would be an unreadable knot. As you follow connections it re-centres on whatever the Companion is looking at, and clicking a node moves the Companion there.

It’s there to give you your bearings: you can pan and zoom, but the view controls, settings and mini map belong to the Links tab, and nothing you do in Nearby changes the layout you’ve arranged there. Boards and scenes aren’t on the graph, so it doesn’t appear for them. See Following connections.

The expand icon beside the Nearby heading — Open in Links — opens the Links tab centred on the thing in focus. The ⋯ menu on the Companion’s focus card has the same Open in Links. The bigger surface makes long chains, dense clusters, and cross-world spans easier to read.