Troubleshooting
When something does not behave the way you expect, Hero Mancer gives you two tools for gathering information. The Troubleshooter builds a report you can attach to a bug ticket. The Logging Level setting controls how much detail Hero Mancer writes to the browser console.
The Troubleshooter
Section titled “The Troubleshooter”The Troubleshooter collects details about your world, active modules, and Hero Mancer settings into a single diagnostic report.
Open it from either of these places:
- Foundry’s Configure Settings dialog, in the Hero Mancer module’s section. Click Open Troubleshooter.
- The Hero Mancer settings dashboard, under the Advanced tab, in the Tools group.
The window shows a read-only Diagnostic report. The footer has four buttons:
- Save to File downloads the report as a text file you can attach to a ticket.
- Copy to Clipboard copies the full report.
- Join the Discord opens the Hero Mancer Discord server.
- GitHub opens the Hero Mancer issue tracker.
Logging Level
Section titled “Logging Level”The Logging Level setting decides how much Hero Mancer prints to your browser’s developer console. This is a per-user setting. Each person sets their own level without affecting anyone else.
| Level | What it shows |
|---|---|
| Off | Nothing. |
| Errors | Only failures. |
| Warnings | Failures plus warnings about questionable configuration. |
| Verbose | Everything, including step-by-step activity. |
If you are about to report a bug, set this to Verbose, reproduce the problem, then copy the relevant console lines into your report alongside the Troubleshooter output.
You can find Logging Level under the Advanced tab in the Hero Mancer settings dashboard, and it also appears in Foundry’s own module settings list.
Common issues
Section titled “Common issues”Advancement automation is disabled
Section titled “Advancement automation is disabled”If the system’s advancement automation is turned off, Hero Mancer cannot apply class and species features correctly. When this happens, the Gamemaster receives a private chat message titled Enable D&D5e Advancement Automation with an Enable Automation button. Clicking it switches the system setting on for the world. See D&D 5e integration for the full explanation.
Options are missing from the dropdowns
Section titled “Options are missing from the dropdowns”If a species, background, class, subclass, or item you expected does not appear during character creation, two things are worth checking:
- The item may be on the exclusion list. You can review and clear exclusions per category. See Exclusions.
- The compendium that holds the item may not be an enabled source for that category. See Settings for how sources are chosen.
Submissions are not creating actors
Section titled “Submissions are not creating actors”If a player finishes character creation but no actor appears, GM approval is probably on. With Require GM Approval enabled, player characters are queued for you to review instead of being created right away. Check the pending queue and approve the submission. See GM approval.
Spells were not prompted
Section titled “Spells were not prompted”Hero Mancer does not pick spells during creation. After the character is created, spell selection is handed off to the Spell Book module. If a spellcaster never got a spell prompt, confirm Spell Book is installed and active, and that you have enabled at least one spell compendium for it. See Integrations.
Tokenizer or Dice So Nice is not detected
Section titled “Tokenizer or Dice So Nice is not detected”Hero Mancer only shows the controls for these modules when the module itself is installed and active in your world.
- The Tokenizer compatibility toggle (and the in-creation art handoff) appears only when Tokenizer 2 is active.
- The 3D dice option for ability rolls appears only when Dice So Nice is active.
If you have one of these modules but its Hero Mancer option is missing, check that the module is both installed and enabled in Module Management, then reload. See Integrations.
Still stuck?
Section titled “Still stuck?”If the Troubleshooter and logs have not pointed you to a fix, reach out:
- File a bug at the Hero Mancer issue tracker. Attach your diagnostic report.
- Ask on the Discord server.