by derkami » Sun Oct 27, 2024 8:38 pm https://public.hearthworld.com
I've been working on a public mapping backend service, that lets people connect and share their findings.
You can view the map freely at https://map.hearthworld.com
What is it and how does it work?
It's a mapping Backend much like the original Implementation of Andyleaps / APXELOG and the new Service of Dafels, but not selfhosted.
You can freely log in with your Haven and Hearth account via OpenID Connect (Single Singn On) provided directly by Haven and Hearth (Thanks Loftar).
It will upload Map information while you walk.
After Logging in you are able to access you map and marker settings from the dropdown of your account.
In your map settings, you can get your individual Token / Endpoint for the clients:
Don't worry, this token doesn't work anymore...
You can also set your Affiliation / Shared Secret to share your markers and your position with your friends.
Basically it works like a group token, only those with the same token can see you and what you shared! (Except for the Map data ofc. That's free 4 all.)
In your Marker Settings you can enable sharing your makers with your affiliation or make them public.
Your basic view on the map looks like this:
Whenever people discover caves or spawn at different not yet discovered locations they create a new segment.
Segments are getting merged once they connect.
When you turn on the "Auto xyz" settings you basically track your movements while you explore. This is pretty useful for dual monitor setups where you want to track what you discover.
If you are sharing your secret, you'll see a list of all the players who are using the same affiliation under Players. Otherwise it's either empty or has only you inside.
Under markers you can enable and disable what you can see.
The cookbook is currently just a copy of "shublas" frontend. This is still WIP.
Currently the public map will always show the first ever found tile.
Wait we can Login with Haven & Hearth? You trying to steal our data?
Man look. I know that Single Sign On sounds scary, but all it does is redirect you to http://www.havenandhearth.com and authenticates you for me.
It will look like this:
You accept and all I get is your user account id, which is only needed to identify you, and your username.
Nothing more nothing less. No password. No nothing.
What clients are working?
With the new update, only my own client.
I do have the changes commited so whever want's can adapt them. They only add information, it will be ignored on all other mapping tools.
https://github.com/DerKamii/KamiClient/ ... 9b97490f00
https://github.com/DerKamii/KamiClient/ ... 7f7a7ccfc4 <- because i made a writing error..
https://github.com/DerKamii/KamiClient/ ... 88fccc51e4 <- changes after going life because of ... weird issues
https://github.com/DerKamii/KamiClient/ ... 88fccc51e4 <- to not reset settings if you have this kind of implementation aswell.
https://github.com/DerKamii/KamiClient/ ... 3278063fd4 <- food stuff had also problems I didn't notice earlier.
This is completely optional, since it only works on my stuff anyway:
https://github.com/DerKamii/KamiClient/ ... c615a6a58c
If something changes, I'll update it here.
Why no open source?
Because this project wasn't made and designed to be.
There's also no obligation to do that.
But I do have a Roadmap for 2026.
Uh what? Roadmap?
[*] Design MapV5 Endpoint APIs with proper Documentation and Client code.
[*] Create an open source version of my mapping tool in PHP, so that it can be used fucking everywhere.
[*] Have a decentralized API on the open source version so that groups can share data between them even if they self host
[*] Have a centralized Endpoint for people to hook into, if they feel like sharing (You share - I share)
[*] Have all that open sources for the time when I'm not able to be here anymore.
