Home Creators Posts Import Register Favorites Logout

Content

Something I've always wanted is a way to represent relationships between NPCs. But every solution I found was always lacking or it was overly hard-coded.

Many of you will have seen the current version in the Patreon Vault. It works... but it's hard-coded, no flexibility and requires knowledge of js to modify.

Introducing Relations

Relations is a relationship visualiser for Obsidian. You declare connections in frontmatter using whatever vocabulary you want — ally, enemy, spouse, parent, mentor, rival, secret-lover — and it draws them as a graph with portraits, colour-coded edges, and configurable line styles. Symmetric or one-way. Solid, dashed, dotted, or double. Whatever fits.

A few things it does that I think you'll like:

Embed graphs in any note. Drop a fenced code block and you've got a live graph showing that character's direct relationships, or three hops out, or the whole vault.

Auto-mini mode in callouts. Inside an ITS infobox or any callout, the graph automatically shrinks, drops its border, and integrates with the surrounding chrome. Perfect for character sheets.

Family-tree layout. Mark relationship types as "genealogy" (default: parent) and the layout switches to proper top-down generations, with spouses paired side-by-side and children sitting under their parents' midpoint. Targaryen-chart energy.

Note-driven, not database-driven. Every entity is just a regular Obsidian note. Nothing locked into the plugin. If you uninstall, your worldbuilding is still there.

Useful for TTRPG NPC webs, fiction casts, worldbuilding factions, family trees, historical research, or just any project where seeing how things connect matters.

It's open source, MIT licensed, and free.Can now be installed via the Obsidian Community: https://community.obsidian.md/plugins/relations

Install via BRAT (the standard sideload route for plugins not yet in the official catalogue):

Install Obsidian42 - BRAT from Community Plugins

Add Beta Plugin → paste https://github.com/Obsidian-TTRPG-Community/Relations

Enable Relations in Community Plugins

Repo, example notes, screenshots, and full docs: https://github.com/Obsidian-TTRPG-Community/Relations

If you find a bug or want a feature, open an issue. If you're already using it, I'd love to see screenshots of your campaigns — drop them in the Discord.

Files