HLO Public API Debuts
It's been a long time coming, but the HLO Public API has finally been released. It's now possible to extract character data on a one-time basis, as-needed via infrequent polling, or even through real-time notifications that provide a constant feed of every change made to a character.
At the moment, all of this yummy goodness is only available for Starfinder. We have one big piece left to complete for PF2, which we're working to have in place by the end of October. SR6 will take us a healthy amount of additional time, so there's no timetable on that yet. There are two major components to the Public API. The first is the Export Format, and the second is the API itself. The Export Format is a standardized, structured representation of HLO characters, which is consistent across all game systems. The specifics for each game system are obviously distinct, but the data model is identical, and the only differences are at the lowest level of the data (the actual properties and their values). So setting up a basic conduit from HLO to another tool need only be done once. The character details are game-specific, but everything else is the same. The API itself is a web-based protocol that can be consumed in many different ways by a diverse array of tools. Single characters, multiple characters, and even campaigns can all be accessed. That access can be accomplished via explicit requests when needed or through continuous, live updates over websockets. This should make it possible to setup everything from one-time import feeds to dynamic integration with external tools. The character data surfaced by the API is in the Export Format. Detailed documentation for the Public API will be found at the links below: Public API Documentation @ https://docs.herolab.online/HLO-Public-API-Documentation.pdf Export Format Documentation @ https://docs.herolab.online/HLO-Export-Format-Documentation.pdf I'm sure there will be additional capabilities that will be wanted. And I'm sure there will be questions we overlooked in the documentation. So please use this thread as an initial place to submit those requests and ask those questions. I hope this initial API gives everybody the core functionality to get started integrating HLO with your favorite tools. If there's something important we haven't included, we'll get it added. Thanks! |
Really excited for this going forward!
|
So this allows developers of the online tabletop apps to access HLO? Any word of any of those developers doing that?
|
Quote:
From looking at the API doc, it also looks like it would also be pretty straightforward to make desktop apps, or client-side web apps, that use the API to provide whatever functionality using the character data. |
Quote:
Quote:
Quote:
|
Quote:
I guess I was wrong. Edit: That all said I am not part of your company so I don't know what it would take to get something like that done. |
Quote:
|
To the best of my knowledge, the VTT companies are small outfits like us. As such, they primarily rely on tech-savvy fans for doing this sort of stuff, just like we do. So this is equal parts an announcement for the VTT companies and for the tech-savvy fans that are most likely to dive in with this stuff. In other threads, key contributors to at least two VTTs have said they were anxiously waiting for the availability of the API to get started, and another has emailed me directly about it. We just need to give them the chance to get that work underway. :)
|
According to Foundry Starfinder discord, someone is working on something.
|
I've started a converter for Fantasy Grounds. It takes the JSON of a character and creates the XML that can then be imported into FG. It only does basic things right now. Skills, Abilities, personal information (homeworld, name, gender, etc.)
You can find my code here: https://github.com/BoomerET/hlosf2fg At this moment, I'm thinking of moving over to the API. Looking at docs. Dave |
Any news on this for pathfinder?
|
Quote:
EDIT: Apologies, I missed the line that said it wasn't finished for PF2. |
Quote:
|
Quote:
|
Which VTT?
Quote:
|
PF2 is now accessible via the public API
|
Will the above code BoomerEt made, also work with Pathfinder 2e for Fantasy Grounds?
|
API code written for one VTT will not work directly for others, although having written it might make it easier to write another for a different VTT later. The import modules are for specific VTTs and other viewers.
|
Quote:
|
Rob or Zimrathon (or anyone),
Can you share the code tags for Perception, Heritage, and Key Ability Score in the export file? Haven't been able to locate them... Or have these not been implemented yet? |
Rob, I'm developing a converter for Foundry VTT, and here's what I've come across so far:
More to come as I discover them |
Please send any missing items in the export to us through the normal bug reporting options in HLO (the icon at the top right that looks like a gear - one of the options in that is bug reports).
|
will do! thanks
|
Bugs submitted for armor and weapon proficiency
As far as I can tell, in v1 of the export armor and weapon proficiencies are not explicitly exported as a group (e.g. light armor, simple weapons), but are only given on a per-equipped-item basis. So if the exported character is wearing leather armor, in the properties description for that item it will give the character's proficiency level for leather armor, but there is no listing for light, medium, heavy armor proficiencies that I can find. Same for weapons.
I reported these as bugs as requested in HLO. |
Quote:
I'm running 5e btw if that matters I'm not a dev, just a user and I have dozens of chars I'd love to import Thanks! |
Quote:
|
Any chance to get that to work for Fantasy Grounds?
|
I don't use nor plan to use FG. You'd want someone with intimate knowledge of the FG data to be able to write a converter. I suggest you check out FVTT at some point. It's cheaper than FG, the game systems and mods are worked on by the community, so I expect it'll be more powerful/extendable than most other commercial closed systems. Plus, single charge for GM and no cost for players makes it have a low cost of entry.
|
Is there any news, or even a plan, on fixing the missing items in the exports?
|
Fantasy grounds is working on this - https://www.fantasygrounds.com/forum...l-APIs-for-FGU
Will this work for HLO? |
1 Attachment(s)
Quote:
|
Quote:
|
Is there a timeline for when Pathfinder 1e will come to the API?
|
Quote:
I REALLY would like to use Hero Lab as my character- and NPC-Adminstration Tool. That way, I can do all the character (and encounter-)building and adminsitration in one single app. But that only works well, if you have any kind of interface (API) with common VTTs. More an more gamers use VTTs, so this should be a market. With a propper interface I could administrate my PCs in Hero Lab and send rolls to Roll20 and Foundry, for example. That would be awsome. Pathfinder 1E, Pathfinder 2E and Starfinder should all be supported by that API. Maybe you could lunch a crowdfunding-campaign to get this done. Best scenario: We have alle the Pathfinder 1E adventurepath-material in Hero Lab and can send rolls oder character sheets to a Roll20 game. No more tiring setup in Roll20. Just set up maps and lighting and "roll for it" :-) Thanks! |
Quote:
I honestly think Paizo forced a non-disclosure so Lone Wolf can't technically say (hence the LONG silences on any question to PF1 support), but PF1 integration is never going to happen. PF2E is the premier official integration for Foundry VTT, and honestly is really smooth. Supporting two systems is twice the cost. Adding new features amplifies this. Why would they help enable essentially a competitor to their own flagship product? I think the only reason we even have PF1 in Hero Lab Online today is timing of it and since it was already in there and working, no sense in ripping it out to backlash, but if Paizo had its way, it would be gone from here. I'd love to be wrong, but the more I've learned about Paizo and the people running that show, the less I respect them and their practices. |
Quote:
https://paizo.com/community/blog/v57...-PrintonDemand Seems like they are still supporting it. Right there is no new content besides third party stuff but that is to be expected. |
Quote:
Buying the books is exactly the same as today with their PDFs anyway. No impact. Making it easy to adopt PF1 in Foundry equal-to-or-over PF2 in Foundry? That could have an adoption impact to PF2. Apples and Oranges, really. Paizo is always happy to take your money when it doesn't eat its own lunch, as any business does. |
Pathfinder 1e API
It's been 2.5 years since the public api launched. Any idea on when it will get pf1e support? I would like to build an integration into foundryvtt but can't do anything without the API.
|
All times are GMT -8. The time now is 09:29 PM. |
Powered by vBulletin® - Copyright ©2000 - 2024, vBulletin Solutions, Inc.
wolflair.com copyright ©1998-2016 Lone Wolf Development, Inc. View our Privacy Policy here.