Skip to content

Non-official plugin for importing characters from Hephaistos.online to Obsidian.md

License

Notifications You must be signed in to change notification settings

Skallaturi/hephaistos-importer

Repository files navigation

Hephaistos Importer for Obsidian.md

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.

Features

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.

Hyperlinks

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.

Initiative Tracker compatibility

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

Fantasy Statblocks compatibility

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.

Installation

Install via the Obsidian Community Plug-ins.

Manual installation

Create a folder in your obsidian vault's .obsidian/plugins/ folder and download the main.jsand 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.

Limitations

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.

Known issues

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.

Future

I want to keep this plugin compatible with other relevant Starfinder projects and Obsidian plugins or templates/styles. Please bring any to my knowledge.

Contact

Bug reports and feature requests are very welcome. How do you use the plugin? Can I make it better for you?

Github

E-mail

Or tag @Skallaturi on the Obsidian Discord, Obsidian TTRPG Discord, or Starfinder Discord

About

Non-official plugin for importing characters from Hephaistos.online to Obsidian.md

Resources

License

Stars

Watchers

Forks

Packages

No packages published