For the Starfinder RPG.
A plugin for Obsidian allowing for import of characters from Hephaistos.
It is completely unaffiliated with either program and all thanks go to the dedicated programmers of those.
Given the public ID for a number of Hephaistos characters (the number at the end of the public share link), clicking on the anvil icon will populate the selected Obsidian folder with a note for each character, filling the frontmatter with data from Hephaistos, such as:
name: Mila Imarin
hephaistos link: https://hephaistos.online/character/779575002
abilities:
- strength: 10
- dexterity: 14
- constitution: 12
- intelligence: 15
- wisdom: 10
- charisma: 21
race: Human
classes:
- Witchwarper: 5
etc.
If there is already a note with a character's name, the plugin wil update the frontmatter while leaving the rest of the note untouched.
Frontmatter will only be updated, not replaced. If you have other frontmatter entries, such as cssclasses
, those will remain unaffected by the plugin.
Enabled in settings.
Some fields, such as spell names, can be created either as plain text or Obsidian hyperlinks.
The links are based on the Community SRD vault's structure, but since the vault is very complex, the plugin may guess wrong when trying to create a link path.
Enabled in settings.
The importer can generate fields compatible with Javalent's Initiative Tracker. These are:
- level: total level
- hp: sum of current health, current stamina, and temporary hp
- ac text with
EAC X, KAC Y
- modifier: initiative modifier
Enabled in settings.
The importer can format fields to work with Javalent's Fantasy Statblocks.
A simple statblock file, modified from TheNightMayor's Starfinder bestiary layout, can be found here.
Install via the Obsidian Community Plug-ins.
Create a folder in your obsidian vault's .obsidian/plugins/
folder and download the main.js
and manifest.json
files from the latest github release into it. You can find the latest Github release under Releases
to the right on the plugin's github page.
This plugin is not intended to replace Hephaistos in any way. It is merely importing the most important data for convenience's sake -- probably most useful for Game Masters.
The plugin utilizes a feature implemented in Hephaistos on the 3rd of February 2025. It will fail to import characters who haven't been saved since then. To update a character, simply appply a point of damage and remove it again.
I want to keep this plugin compatible with other relevant Starfinder projects and Obsidian plugins or templates/styles. Please bring any to my knowledge.
Bug reports and feature requests are very welcome. How do you use the plugin? Can I make it better for you?
Or tag @Skallaturi on the Obsidian Discord, Obsidian TTRPG Discord, or Starfinder Discord