A foundry vtt module to view dice stats (Number of each roll in a Chart! See Below)
Currently stats are stored by parsing chat. If the user joins the game late after rolls were made
they will only get data from that point on unless Auto DB Setting is enabled. Original Idea was from Catan Online end-of-game dice stats screen and wanted something similar to let players look at during or the end of a session.
Used Google Charts as a charting library. (MIT License)
Used Roll Tracker Module(MIT License) as a starting point but
Wanted the ability to track multiple dice types. This Basically lead to a full rewrite as I wanted a more OOP appreach for data storage.
- GM's Rolls for player will count as GM Rolls (Unless Midi Qol is active)
- Blind rolls get tracked but do not get added to results screen unless GM Presses "PUSH BLIND ROLLS" button on Global Stats Display
- GM Data Does not get added to global stats by default so Players cant use it to cheat and see any of the GM's rolls
- Database is automatically used by default (auto DB adding and loading). its unclear of the performance impact so for games with lower speced player you might want this disabled
The original design philosophy was a way to view SESSION stats. Rolls will always avg out over long periods of time so personaly I only wanted to look at per session data. Because of this the implementation resets stats when leaving in joining. There is now a DB setting if you would like stats to stay between sessions
socketlib | socketlib Foundry Page Socketlib needs to be active to allow GM to tell other users to push blind rolls.
- Jacobwojo: Lead Developer
- Juan Ferrer: Fix for canvas buttons
- RadicalEd: German translation + Remove some hardcoded items
- Willumz: Added CSV, export by player options
- joonhohw: Allow GM access when canSeePlayerData is false
- d4,d6,d8,d10,d12,d20 Icons By Lonnie Tapscott :: Noun Project
- Any system that doesnt print rolls to chat
- Midi-Qol if Merge Rolls to 1 Card is enabled but have a partial fix.
- Midi-qol.rollComplete hook Doesnt have a way to trace back to the Player that rolled. Only the actor
- I Used actor.owner property to find out who to associate the roll with but that makes the following issues
- If an actor has >1 owner it might not track the roll to the right player.
- If the GM rolls for a player is will count as the players roll Not the GM's where normally this isnt the case
- Checkboxes to limit which dice types are displayed
- Refresh Button To update stats if a new roll is made while screen if open
- Number of each roll
- Total Number of rolls
- Mean
- Median (true-Middle for Odd or left-middle for Even number of rolls)
- Mode
- Streaks (Incrementing die rolls in a row) 4,5,6,7 ect
- Save and Clear Player Data to DB
- Checkboxes to limit which dice types are displayed
- Refresh Button To update stats if a new roll is made while screen if open
- Total Number of each roll
- Global Mean
- Global Median (true-Middle for Odd or left-middle for Even number of rolls)
- Global Mode
- Global Longest Streaks (Player Name and Streak Value)
- Most Min and Most Max values Rolled (Player Name and Number)
- Clear All Players Data (GM Only)
Tracks multiple dice types. Currently supporting types are:
- D2, D3, D4, D6, D8, D10, D12, D20, D100
[Def: XX] = Default value for setting
(Global) & (Local) = setting scope
Global Settings are restricted to GM only by default
- PLAYERS_SEE_PLAYERS --------- If players cant see self they cant see others either -[Def: True] (Global)
- PLAYERS_SEE_GM -------------- If Players can see GM dice roll stats ----------------[Def: False] (Global)
- PLAYERS_SEE_GLOBAL -------- If Players Can Global Dice Stats --------------------[Def: True] (Global)
- PLAYERS_SEE_GM_IN_GLOBAL - If GM roll stats get added into global stats ---------[Def: False] (Global)
- SHOW_BLIND_ROLLS_IMMEDIATE -- let Blind Rolls be added to player stats immediately ---[Def: false] (Global)
- ENABLE_AUTO_DB - Save And Load Info From DB Automatically On Join and On roll respectively -[Def: true] (Global)
- OTHER_ACCESS_BUTTON_ICONS - Setting to add custom icons on Scene Controls buttons - [Def: fas fa-dice-d20] (Local)
If prerelease version is desired the user can add to module folder by hand by placing it in
$/PATH_TO_FOUNDRY_DATA(Prolly AppData foulder on windows)/Sources/Modules- Must be on a scene to see the die button. Pressing the die button allows the user to open global stats or specific player stats
- Icons for Global and Compare buttons are hard coded and cant be changed
- The default value is the d20 icon but users can change the players Icons from the D-20 to anything on the font awesome icon website under the free section
- Where to find Icons
- Users can change the icons but updating the Define Player Icons field in the game settings
- Update the field to a comma seperated list of the ion text from the font awesome website. The order of the text list corresponds to the order of players in the player list from top down.
- EX: Updating the field to
fa-solid fa-book-open-reader, fa-solid fa-dumbbell, fa-solid fa-explosionas sceen in the following image changes the icons to what I have in my photos (Photo doesnt show full string of icons)
- D20 rolls on pf2e get seperated into their different types to specially viewable. The anyone can select ALL STATS or D20 STATS to switch between the different set of graphs
- Different D20 Catagory types include
- Attack
- Damage
- Save
- Skill
- Unknow (All rolls that dont have a label, This includes Flat-Checks)
-
Hideing GM Values from players so they cant cheat to see the GM rolls
-
PLAYERS_SEE_GM = False (Warning is displayed if trying to view GM values with setting sating you cant)
-
Database Interaction
- Automatically use DB setting will allow users roll data save between session, load immediately on joining, autosave every roll but it could negatively impact performance
- If Automatically use DB is Disabled players can still save and load the info between sessions but they need to do it manually. If they forget, leaving and rejoining the session will clear their data
