Pin check/removal from global API

[FunDeliveryGames]

Hi
I'd like to integrate MapPinEnhanced with my own addon to set pins to Delves.

There is a global method AddPin which I can use to add new pins.

But I've encountered an issue with the created pin.

1. No clear way to check whether the pin still exists.
   • For now, I just check MapPinEnhancedDB.storedPins and compare pins by title. Not the best solution + I'm not sure about the performance if someone has lots of pins.
   • It'd nice to have pin ID exposed publicly, e.g. as a return value from AddPin. And a method to check whether such a pin is still present in the DB.
2. No way to remove the created pin.
   • I didn't find any way to remove the pin outside of the tracker.
   • Also, it seems that there is no event or callback that a pin has been removed.
   • Am I missing something and a workaround exists?
   • Probably removal can be done using pin ID as well.

Do you plan to add something like that?
Thank you in advance.

[Nercus]

Hey @FunDeliveryGames,
I'm currently working on version 3.1.0, which introduces a new feature called Pin Groups. This allows pins to be grouped together while they are actively in use—unlike sets, which simply store them for later use.

The update also includes an extended API that lets other addons register their own pin group(s) and add, remove, and track pins as needed. Since this involves a core change to the data structure in Map Pin Enhanced, it’s taking some time to get everything right.

When a beta version is out I would love to get some feedback on the API and can keep you updated on that by commenting on this issue if you want that 😃

[FunDeliveryGames]

Hello @Nercus,
Thank you for the information, it sounds awesome!
I'd love to try the updated API when it's out so I'll keep an eye on addon updates.

Do you have any ETA on that? I don't expect like an exact date, just preliminary (August or later this Autumn/this year). It will help me to plan my own updates.

[Nercus]

Even a rough ETA is hard to say as pin groups is just one part of multiple new features added in the new version. Im able to provide preliminary details for the pin group API though:

Two new methods are available on the global namespace: GetGroupsBySource and RegisterPinGroup:

• GetGroupsBySource returns all groups that are registered by an addon (where source == addon name).
• RegisterPinGroup creates a new pin group and returns it. If the group already exists (i.e., was restored by MPH), then the existing pin group is returned.

The name of the addon which registered a pin group has to be provided (just the string to check for a basic IsAddonLoaded(name)).

The following methods are provided on the pin group "object":

• AddPin
• RemovePin
• SetName
• GetName
• SetIcon
• GetIcon
• GetPinCount
• GetPinByID
• GetPins

AddPin, GetPinByID, and GetPins return a pin "object" with the following methods:

• SetPinColor
• SetPinIcon
• SetTooltip
• Track
• GetPinData
• GetPinID

Let me know if there is anything you would like to see added to that list!

[FunDeliveryGames]

It looks huge! I anticipate to check it in action.
At the moment, it seems to cover all features I'd like to have. Thank you for the information.