About Foundry Hiscores

Foundry Hiscores publishes character records from campaigns played in Foundry VTT. Every character has a public page with its ranks, and every player and game master has a page listing the characters they play or run.

Anyone can browse and search the boards without signing in.

A game master connects a Foundry world with the Foundry Hiscores module and a campaign connection key. During play the module sends events: kills, deaths, wealth totals, and counters such as natural 20s.

Some events wait for the game master before they count: kills the module cannot attribute with confidence, every Pirate Borg kill, and anything stamped more than ten minutes in the future or more than 30 days in the past.

Accepted events are folded into the boards every two minutes, and public pages refresh within a minute after that.

Each board ranks characters by one score, highest first. Equal scores are ordered by character name, and ranks are sequential, so two characters never share a rank.

A character page shows its rank across the whole game and inside its own campaign. A game only lists boards that have at least one character.

Fifth Edition and Pirate Borg have separate boards, search, and campaign lists. A score from one game never appears on, or counts toward, the other.

A campaign that plays both games appears in each, showing only that game's characters.

Sign in with Google, create a campaign with its public name and game systems, then issue a connection key. Paste the key into Foundry under Module Settings, Foundry Hiscores. The key is shown once; you can rotate or revoke it from the dashboard.

Character, player, and game master names are published exactly as Foundry sends them, and they are searchable. Deleting a campaign removes its public pages and revokes every key.

Demo mode shows sample campaigns whose names start with "Demo:". Demo records never appear on the real boards.