Collector release notes
Collector is how the community map data behind Mapster gets filled in. In Dungeon Helper 4 the collecting was part of Dungeon Helper itself. In Dungeon Helper 5 it is a separate plugin that you choose to install, with a window that shows you everything it sends.
Installing and switching it on
- Collector does not come with the Dungeon Helper installer. Nothing is collected or sent unless you download Collector, install it and toggle it on. See Getting started.
- There is no separate consent prompt and no settings screen. Installing it is the opt-in, and the toggle on the Plugins tab is the only switch.
- To stop, toggle it off or remove it.
What it collects
The user guide has the full description under What it collects. At launch that is:
- Placed objects in quests and adventure areas: chests, traps and control boxes, levers, rest and resurrection shrines, collectibles, keys, crests and crest sockets, waypoints, journals, and crafting and barter devices.
- Chests also carry the loot tables they draw from. Chests and collectibles carry the level of the run they were seen in.
- Bosses and raid bosses, recorded where they stand before they have noticed anyone. Once a boss has a target it is no longer recorded, so the pin marks where it spawns and not where the fight ended up.
- Named NPCs: quest givers, trainers, vendors and others whose name you can see.
- Explorer points, at the spot where you were standing when you discovered one.
- Arrival points: the spot where you appear when you enter a quest or an adventure area.
- Quest information from the experience report: the quest’s base experience and the bonus tiers reached for kills, traps, secret doors and breakables. These are recorded as the game reports them, including on a run you don’t finish.
- Run results, once, when you complete a quest: difficulty and reaper level, how long it took, experience earned with the bonuses and penalties behind it, optional objectives, and the totals for kills, traps, secret doors, breakables, deaths and re-entries.
Each sighting carries the area, the quest, the position, and the level and difficulty of the instance you were in.
What it never collects
- Your account, your characters’ names or IDs, your server, your inventory or your chat. See What it sends and the privacy policy.
- Other players. Their characters are never recorded, and the per-player breakdown in the experience report is left out, so a run result holds the totals only.
- Hirelings and pets.
- Ordinary monsters. Only bosses and raid bosses are recorded.
- Anything sitting in a player’s inventory.
- Things that drop in a different place every time, which would never settle on one spot on a map: Mysterious Remnants, Treasure of Crystal Cove and Treasure of the Night Revels.
- A few objects the game treats as NPCs but nobody would look for, such as Lost Souls and posted journal pages and proclamations.
Lamannia is recognised and kept apart from the live servers. Collector checks whether you are on Lamannia for that reason only. The server you play on is not sent.
When it stays quiet
- In public areas Collector records only named NPCs and crafting and barter devices. Everything else is collected inside quests and adventure areas.
- While you change area nothing is collected, and Collector waits a few seconds after you arrive before it starts again. Anything it was reading when the change began is thrown away, so a sighting is never filed under the wrong area.
- An explorer point discovered in those first seconds is not recorded. The next person to discover it records it.
- Until you are logged in to a character, nothing is sent.
- Repeat sightings are sent once per visit to an area. Collector also remembers, between sessions, the fixed things it has already had accepted, and holds them back the next time you pass. Chests, collectibles and quest results are the exception: they are sent on every run, because what they hold changes with the level and difficulty.
- An NPC or boss that moves around stops being reported once enough of its positions are on record.
When it sends
- Sightings are grouped into batches. A batch goes out about every five minutes, when it reaches 200 observations, when you leave an area, and as soon as you complete a quest.
- A batch that fails to send is not retried. Those sightings are picked up again the next time someone running Collector passes the same spot.
- Nothing is sent as the game closes, so sightings still waiting at that moment are lost in the same way.
- Batches go to
collect.dungeonhelper.com. Each one carries the random ID Collector made for itself, the Collector version and the game client version, as described under What it sends. - When it starts, Collector downloads its collection settings from
data.dungeonhelper.com: which kinds of things are wanted and how often to send. That lets us switch a kind of sighting off without a new release. If the download fails, Collector falls back to a smaller set (chests, bosses, raid bosses, quest information and run results), never a larger one.
The Collector window
The user guide describes it under The Collector window.
- This session shows batches accepted out of batches attempted, observations sent, how many are waiting, the result of the last send and how long ago it was. It also shows the area, difficulty and quest that Collector is currently filing sightings under.
- Submissions lists the batches sent this session, newest first, each with its time, its size and whether it was accepted. Pick one to see every observation in it: type, name, area and quest, position, and any extra details when you hover over the last column. Copy JSON copies the batch exactly as it was sent.
- Deduplicated lists the sightings Collector held back and why: already stored, or enough positions are already on record for something that moves around.
The window is a view of the current session. Submissions keeps the last 50 batches and Deduplicated the last 200 sightings, and both start empty each time you start the game.
Coming from Dungeon Helper 4
- It was automatic before. It is opt-in now. Dungeon Helper 4 included a collector of its own, listed as DH Crowd Source Collector, and it was switched on by default. Dungeon Helper 5 itself sends no game data. Collection happens only if you install Collector.
- How to get it. Collector is not in the installer. Download it from the Collector page, use Install from zip in the Dungeon Helper app, then toggle it on in game. The steps are under Getting started.
- Nothing carries over. There are no Dungeon Helper 4 settings to bring across. Collector creates a new random ID the first time it runs, and it contributes to the Dungeon Helper 5 map dataset, which is separate from the data Dungeon Helper 4 gathered.
- You can now see what is sent. The Dungeon Helper 4 collector had no window. Collector shows every batch and every observation in it.
- It collects more kinds of things. Dungeon Helper 4 gathered placed objects, bosses and explorer points. Collector adds named NPCs (including those in public areas), crafting and barter devices, arrival points, and the quest information and run results from the experience report.
- It sends in batches. Dungeon Helper 4 sent each sighting on its own as it was found. Collector groups them and skips what it has already had accepted.
- Version details. Both attach the game client version. Dungeon Helper 4 also attached the Dungeon Helper version. Collector attaches its own version in its place.
Collector guide and download · ← Dungeon Helper 5 release notes