ARK Live Map
The web half of Shadow Events Notifier. The plugin watches your world, the Discord addon turns that into embeds, and this turns it into a live map your players sit in - your servers, your maps, your markers.

READ THIS FIRST - this is a standalone web app, One executable and a config.json beside it, and thats the whole install. What it needs is the other half: the plugin needs the events_notifier_web licence key before it will send anything over. No plugin, nothing to plot.

Setup - One exe and a config.json next to it. Move the folder anywhere, it reads its config from its own directory
No installer, no database, no web server to set up - it serves the site itself on whatever port you give it
The webToken has to match webLiveApp.secretToken in the plugin config. Until its set every inbound request is refused, so it ships closed instead of sat there open
One token covers the whole cluster, because each server identifies itself with -ServerKey= at runtime
Ten maps ship with it, and the images sit on disk rather than baked into the exe, so you can swap them or add your own without a rebuild
Discord sign in is optional. Without it everyone is a guest and the public layers still work

The Map - Pan, zoom, contour overlay, greyscale terrain and a GPS grid
Markers cluster as you zoom out, so a busy server doesnt turn into a pile of overlapping dots
Live lat and lon under the cursor the whole time, on every tool, so you can read a position straight off the map without placing anything on it
Stacked maps are handled properly - Genesis has a surface and an ocean, each with its own image and its own calibration, and a marker lands on the right one based on how high up it is

Live Markers - Supply drops, orbital drops, element veins, wild fertilized eggs and bosses
Coloured by tier and named the way the plugin names them, with a legend that lists only what has actually turned up rather than everything that could
Click one for the detail. Eggs show creature, level and mutations
Categories the plugin doesnt send yet are tolerated rather than rejected, so a plugin update cant break the setup you already have

Markers Leaving - Three ways one goes, and this is the bit most live maps get wrong
Despawn is the normal one - the plugin reports something ended and the marker goes at once
Restart is the second. A sweep arriving after a quiet spell means the server came back and the world regenerated, so anything the sweep doesnt re confirm gets dropped in about thirty seconds instead of sitting there half an hour advertising loot that isnt there
Expiry is the backstop, configurable per category, for despawns that never arrive. Delivery is deliberately fire and forget, so a lost message is expected rather than exceptional
Every expiry is logged with how long it went unconfirmed and counted per category, so you can tell from your own data whether the backstop is catching anything or whether delivery is good enough that it never fires

Positions - ARK map calibration is a mess and this doesnt pretend otherwise
Where the plugin couldnt convert a position, the raw world coordinates get used to work it out here instead, which recovers spawns a stricter reading would have binned
Anything derived rather than vouched for is drawn with a dashed ring and labelled as such, so you can see which positions to trust at a glance
Four maps ship a calibration that cant be used and fall back to an approximation. Those say approximate rather than being quietly drawn as fact

Your Own Markers - POIs, caves and explorer notes you author yourself, kept in a file you can commit, ship and hand edit
Defined per map, so one definition covers every server running it
Or narrowed to a single server, because two servers on the same map dont always want the same things marked on it - a meeting point, an event site, a base
Paste an in game CCC instead of guessing at coordinates. The CCC is kept afterwards, so if a calibration is ever corrected the placement can be re derived instead of re measured by hand
Explorer notes track collection per player, so collected means collected by that person, not by everyone

Private Notes - Anyone permitted can drop a personal note anywhere on the map
Strictly private - scoped to whoever wrote it, no admin or owner override, and someone elses note comes back not found rather than forbidden, so nobody can go fishing to see whether one exists

Player Tracking - Live positions of everyone online, and the settings are blunt about it because an open feed here hands anyone a wallhack
Five levels - off, staff only, own tribe, any signed in viewer, or public. It defaults to staff
Filtering happens on the server before anything leaves the process, not in the browser where a curious person can go looking
Own tribe resolves through a Discord to EOS link, so a viewer with no link sees nothing rather than a guess
Per player and per tribe switches, so one person can be hidden without hiding their whole tribe
Private notes about a player are keyed to the player, so they follow them across servers instead of being pinned to a spot on a map

Rare Sightings - Rares and super rares show as the grid square they were seen in rather than a pin
Deliberately imprecise, about one percent of the map. Its a hunt, not a delivery
They expire on their own, because a highlight over a creature thats long since wandered off is worse than no highlight at all

Tribe Census - Every structure and tame on the server, clustered into bases and coloured per tribe
Owner only, and deliberately outside the role matrix, because structure positions are a raid map that doesnt log off. Its stricter than player tracking on purpose
Members can be granted their own tribe only, filtered on the server, so that permission cant be turned round and pointed at a rivals base
Tens of thousands of records draw to canvas rather than page elements, so the map still pans at full speed with a census loaded

Access Control - Discord sign in, roles read from your guild - guest, member, admin, owner
Per role grants layered on top, so a role can be given explorer notes and nothing else without being promoted a tier
Grants only ever add. No deny rules, because deny rules are where a permission system stops being something you can reason about
Owner is by user id and cant be locked out of your own dashboard, and a gated cluster refuses its permalinks rather than just hiding the tile

Reports - Anyone permitted can report a wrong or missing location and it lands in a Discord channel your admins read. Rate limited per person, so it cant be used to flood the channel

One Windows executable. No database, no runtime to install, no other addon required
Map images sit beside it rather than inside it, so you can swap or add maps without a rebuild

The same key works from the plugin host and from the web host, which are usually different machines
Nothing is served until it validates - it fails closed rather than open
If the licence server cant be reached it keeps serving and retries, because a five minute outage at 4am shouldnt take your map offline. A licence thats genuinely rejected does stop it

NEEDS THE SHADOW EVENTS NOTIFIER PLUGIN
The plugin needs events_notifier_web before it will send anything over