| Latest version | 0.5.2 |
|---|---|
| Minimum Core | |
| Compatible Core | |
| Last updated | 4 days ago |
| Created | 2 months ago |
| Authors | |
| Languages |
English |
| Systems | All systems |
| Project source | Project URL |
| Report bugs | Bug tracker URL |
| Read-me | Readme URL |
| Changelog | Changelog URL |
| License | License URL |
Polls, Points & Rewards is a configurable, system-agnostic Foundry VTT module for reusable polls, player point tracking, GM point awards, redeemable rewards, transaction history, and account recovery. Its core logic relies on Foundry Users, Actors, ownership, folders, World settings, sockets, and Chat rather than D&D-specific character data.
A GM-selected Actor Folder is the module's live participant filter. Actors directly inside that folder are the current candidates/participants shown by Polls, Give Points, Redeem, and User/Actor normalization. Changing the selected folder never moves, resets, or deletes stored point data.
Foundry Ownership and the module's Primary User are intentionally separate:
This allows temporary Owner access to an absent player's character without changing the character's identity inside the module.
The module supports multiple reusable Voting Profiles. The GM selects which profile to start from the GM Manager.
Each profile contains 1–8 questions and can mix two question types:
Actor Vote choices are the eligible Actors from the configured folder.
0 points makes the question informational without producing a point commit.Option Vote questions use GM-defined answers instead of Actors, for decisions such as:
Each Option Vote has 2–8 custom answers. Option Votes are informational and use 0 points.
Each question has its own GM resolves ties policy.
Ballot visibility is configured per Voting Profile.
The GM can monitor completion, remind pending voters, finish early after confirmation, resolve configured ties, and finalize the poll. Point awards are committed only during finalization.
Existing pre-v0.2.0 Voting Categories are automatically normalized into a Session Awards Voting Profile.
One shared point balance belongs to each Primary User. All Actors assigned to that User display and spend from the same account.
Changing an Actor's Primary User makes that Actor use the new User's existing shared account. No balance is moved automatically.
Each Actor subaccount has its own independent balance and ledger. Changing Primary User reorganizes the Actor under a different User identity while preserving that Actor's points.
The GM may switch methods with a conversion preview:
The GM Manager supports both single and batch awards.
If no saved reason exists, an editable symbolic Default +1 row is shown until the GM saves a real reason.
Benefits are always preconfigured and are redeemed one Actor at a time.
If no saved benefit exists, an editable symbolic Default / 1 point benefit is shown until the GM saves a real benefit.
Players can see their current balance and the latest 10 point movements.
fa-award icon.Point data is authoritative in hidden World-scoped module data, not in player-editable Actor/User point flags.
FNV-1A-32 fingerprint.fnv1a-* fingerprints from earlier releases are validated in their original format and normalized without discarding valid World data.If an Actor/User disappears, the point account can remain recoverable as an orphan rather than disappearing with the document.
The GM Manager includes a deliberately discreet icon-only Transfer Points tab (⇄). Daily-use tabs retain the 30% / 30% / 30% / 10% layout.
Changing Primary User never performs a balance transfer; explicit balance movement belongs to this Transfer tool.
Settings include a dedicated normalization view showing:
Primary User is the stable identity used by Account-Wide grouping and poll self-vote rules, even when Foundry Ownership is temporarily changed.
Reusable ecosystem configuration can be exported/imported as versioned JSON.
Exportable sections:
Controls are available individually and through Export All / Import All. Imports support Replace or Merge and remain in the Settings window for review until Save Settings is clicked.
v0.2.0 remains backward compatible with v0.1.0 Voting Categories exports by converting them into a Session Awards profile during import.
Portable exports deliberately exclude:
The export routine prefers Foundry's own local-file saver when available and keeps a browser Blob fallback for compatibility. Import behavior remains intentionally conservative because the existing importer is already stable.
The Settings application currently covers:
Buy Me a Coffee: https://buymeacoffee.com/hammer.pvp
To install this package, open your Foundry Setup screen and navigate to your Module tab and click the Install Module button.
From there, you can either search for the package unique name: points-and-rewards or copy its manifest URL:
And paste it to the input box at the bottom of your window.

You can install this package directly to your Forge account.