About this mod
A HUD display that shows damage done by player and dynamic changes to SPECIAL, currencies, and other stats.
- Requirements
- Permissions and credits
- Changelogs
This mod provides a simple but very customizable display of some player stats and emphasizes any changes that occur. This can help players know when some buffs start and stop.
Details
This mod works by tying into UI events. Due to this, there may be some lag before a change in stats is displayed. Also, weapon damage may not update until a shot is fired.
The amount of time that a change in stats is displayed can be configured.
One of the stats I was frequently asked to add was AP regen but I have not found a way to get any useful numbers for that.
Update
I am pleased to finally be able to release StatsMeter version 3.0!
This version includes a number of highly requested features (and a few that weren't requested).
- Multiple windows, each completely configurable.
- Horizontal windows.
- New stats (name, level, critical meter, game time, supplies).
- Incorporation of Simple DPS Meter functionality.
- With the increased complexity, I have attempted to limit how often the display gets updated. This may help some people that were having lag while in radiation zones (I never experienced this myself so I can't test it).
- Fixed hunger and thirst. (You dare to challenge me, Bethesda?!)
- Fixed overlay issue when used with Text Chat.
- Additional options added to the "showcustom" command to allow for a lot more flexibility when counting items in inventory.
If you have been using both Simple Stats Meter and Simple DPS Meter, please remove DPSMeter.ba2 from your Fallout76Custom.ini.
If you want only the DPS or only the previous StatsMeter display, then please edit the .ini or download the optional .ini examples.
Now that I have completed this major update, I'll be going back through the requests and seeing what other stats I can add.
As usual, please let me know if you find a bug.
Planned Changes
- Localization.
- Adrenaline meter/timer.
Installation
Manual Installation
Extract StatsMeter.ba2, StatsMeter.ini, and hudmodloader.ini to Fallout 76's data folder (default: \Program Files (x86)\Steam\SteamApps\common\Fallout76\Data)
Note: do not edit hudmoloader.ini unless you are certain you know what you are doing. List of mods being loaded is in Fallout76Custom.ini.
Navigate to Fallout 76's settings folder (default: My Documents\My Games\Fallout 76)
Create or edit the file "Fallout76Custom.ini" in this directory.
Add StatsMeter.ba2 to the sResourceArchive2List line in the .ini file. Use commas between any mods on this line.
[Archive]
sResourceArchive2List=StatsMeter.ba2
Compatibility
Simple Stats Meter is currently compatible with:
- Vendor Log
- Perk Loadout Manager*
- Improved Health Bars*
- HUDEditor*
- Compatible Show Health Redux*
- BuffsMeter
- Text Chat
* place StatsMeter.ba2 after this mod in Fallout76Custom.ini if not using Text Chat.
It is not compatible with any other mod that changes HudMenu.
The controls and in-game time via the Pip-Boy will not be compatible with any other mod that changes Pipboy_Datapage.
With SFE installed, a simple report of damage can be written to a file ("dpsmeter.txt" in Fallout 76's data directory).
If you are the author or maintainer of a mod that does modify HudMenu and want to make it compatible with Simple Stats Meter, send me a message.
About DPS
This mod works by tying into UI events. The Damage Numbers option in Fallout 76 settings must be turned on for this mod to work. This mod does pick up numbers that cannot be seen on-screen. Unfortunately, it is not currently able to get any information from damage-over-time effects.
This does mean that the numbers can be affected by lag and such. But the general purpose of this mod is to compare weapons, which should work well with a good sample size, and potentially track how much damage you have done during a boss encounter.
To calculate Damage Per Second, the biggest question is when do you stop? At some point a cutoff needs to be reached so that the damage you have done can be divided by how long you took to do the damage. Fallout 76 does not provide a built-in method of knowing when a fight has ended and many of the longer fights have lulls. So this mod checks how much time has passed between hits and pauses the calculations after a certain (configurable) amount of
time has passed.
In regards to the high damage targets, I cannot tell what kind of creature you are damaging. There is currently no way to distinguish a Radroach from a Scorchbeast Queen. The mod tracks the 100 most recent creatures you have hit and how much damage you do to each. When the damage passes a certain (configurable) threshold, the amount of damage done to that creature will appear.
Configuration
Simple Stats Meter has a large number of options available by adjusting values in StatsMeter.ini. These change either how the display looks.
With the release of version 3.0, multiple windows can now be displayed. Some of the settings apply to all windows but many are now specific to an individual window. To start a new window, place a [tag] on a line. The text within the [tag] does not currently matter. This is most easily done at the bottom of the .ini file. Make sure to set x and y for the new window. Any Window Settings will use what was set at the top of the .ini file but you can override but putting the option after the [tag]. See how the DPS Meter window was customized as an example.
Global Settings
24 Hour Time Format - Use to configure showing time whether AM/PM format or 24-hour format.
time24format true/false [default false]
24 Hour Time Format for In-Game Time - Use to configure showing game time whether AM/PM format or 24-hour format.
gametime24format true/false [default false]
Window Settings
Window Location - Top left corner of the window. With an ultra-wide monitor, negative numbers can be used for x.
x [default 0]
y [default 475]
Horizontal Format - Display stats in window horizontally instead of vertically
horz true/false [default false]
Text Color
red 0-255 [default 255]
green 0-255 [default 255]
blue 0-255 [default 255]
Text Size
textsize 4-40 [default 21]
Background Frame Color
backgroundred 0-255 [default 61]
backgroundgreen 0-255 [default 61]
backgroundblue 0-255 [default 61]
Background Frame Opacity - Set this to 0 for an invisible background or 1 for a fully opaque background.
backgroundalpha 0.0-1.0 [default 0.5]
Up Arrow Color
upred 0-255 [default 200]
upgreen 0-255 [default 200]
upblue 0-255 [default 255]
Down Arrow Color
downred 0-255 [default 255]
downgreen 0-255 [default 200]
downblue 0-255 [default 200]
Reset Time - How long you want stat changes to be displayed, in seconds.
resettime 0.0-360.0 [default 15]
Shrink-to-Fit Weapon Name - Make text smaller to display entire weapon name instead of clipping.
shrinkweapon true/false [default true]
Shrink-to-Fit Ammo Name - Make text smaller to display entire ammo name instead of clipping.
shrinkammo true/false [default true]
Abbreviations - Use abbreviated text labels to save screen space (not much different for this mod).
abbreviations true/false [default false]
Show Changes - Whether or not to show changes to stats when detected.
showchanges true/false [default true]
DPS Settings
High Damage Targets - You can control how many of these will be shown (set to 0 for none) and how much damage is required for it to appear on the list.
dpshighcount 0-9 [default 3]
dpshighdamage 100-100000 [default 1000]
Combat Time - How many seconds to wait after last hit to consider "combat" to be over. If the time between hits exceeds this, it will not be counted as part of the combat time for calculation purposes.
dpscombattime 1.0-60.0 [default 5.0]
Combat Clear - When a round of combat is detected as over, the display will either darken the Current DPS and Current Damage numbers
shown or remove them entirely.
dpscombatclear true/false [default false]
DPS Reset Time - You can configure the mod to automatically reset all calculations after a number of seconds of no damage occurring. This is for users who would want the DPS meter to automatically reset if no combat is happening. When set to 0 (which is the default), the meter will never automatically reset.
dpsresettime 0.0-360.0 [default 0]
Localization
These will be moved to a separate file once I get a full localization system in place.
Treasury Notes Name - Text of treasury note item name.
treasuryname [default Treasury Note]
Fusion Core Name - Text of fusion core item name.
fusionname [default Fusion Core]
Plasma Core Name - Text of plasma core item name.
plasmaname [default Plasma Core]
Ultracite Fusion Core Name - Text of ultracite fusion core item name.
ultrafusionname [default Ultracite Fusion Core]
Ultracite Plasma Core Name - Text of ultracite plasma core item name.
ultraplasmaname [default Ultracite Plasma Core]
Basic Stats
Show Name - Name of the currently played character.
showname true/false
Show Level - Level of the currently played character.
showlevel true/false
Show Health - Your current health (percentage only).
showhp true/false
Show Rads - Your current radiation level (percentage only).
showrads true/false
Show Action Points - Your current action points (percentage only).
showap true/false
Show Hunger - Your current hunger fullness (percentage only).
showhunger true/false
Show Thirst - Your current thirst fullness (percentage only).
showthirst true/false
Show Critical - Your current critical meter fullness (percentage only).
showcrit true/false
Show Feral - Your current feral meter fullness (percentage only). Note: I have not yet tested this.
showferal true/false
Weapon Stats
Show Damage - Your current weapon damage.
showdamage true/false
Show Weapon - Your currently equipped weapon. Will combine with damage or condition lines if it directly follows and abbreviations are not enabled.
showweapon true/false
Show Weapon Condition - The repair condition of currently equipped weapon.
showcondition true/false
Show Ammo Count - The quantity of currently equipped ammo. (Will be total number of cores being carried in case of fusion and plasma cores.)
showammocount true/false
Show Ammo Name - The name of currently equipped ammo. Will combine with ammo count line if it directly follows and abbreviations are not enabled.
showammoname true/false
DPS Stats
Show Current DPS - DPS for the current round of combat.
showcurrentdps true/false
Show Current Damage - Damage done during the current round of combat.
showcurrentdamage true/false
Show Average DPS - DPS for all rounds of combat.
showaveragedps true/false
Show Total Damage - Damage done during all rounds of combat.
showtotaldamage true/false
Show Weapon Current DPS - DPS for the current round of combat per weapon.
showweaponcurrentdps true/false
Show Weapon Current Damage - Damage done during the current round of combat per weapon.
showweaponcurrentdamage true/false
Show Weapon Average DPS - DPS for all rounds of combat per weapon.
showweaponaveragedps true/false
Show Weapon Total Damage - Damage done during all rounds of combat per weapon.
showweapontotaldamage true/false
Show High Damage - A list of damage done to targets that is higher than the dpshighdamage setting. Number shown can be controlled on this line or via the dpshighcount setting.
showhighdamage true/false/0-9
SPECIAL Stats
Show Strength - The Strength stat.
showstr true/false
Show Perception - The Perception stat.
showper true/false
Show Endurance - The Endurance stat.
showend true/false
Show Charisma - The Charisma stat.
showcha true/false
Show Intelligence - The Intelligence stat.
showint true/false
Show Agility - The Agility stat.
showagi true/false
Show Luck - Whether or not to show the Luck stat.
showlck true/false
Weight Stats
Show Carry Weight - Your current maximum carry weight.
showcarry true/false
Show Inventory Weight - Your current inventory weight.
showweight true/false
Show Inventory Weight (Percent) - Your current inventory weight as a percentage of the maximum.
showweightpercent true/false
Currency Stats
Show Caps - How many Caps currency you have.
showcaps true/false
Show Legendary Scrip - How many Legendary Scrip (L.S. when abbreviations used) currency you have.
showscrip true/false
Show Gold Bullion - How many Gold Bullion (G.B. when abbreviations used) currency you have.
showbullion true/false
Show Treasury Notes - How many treasury notes (T.N. when abbreviations used) your have in inventory.
showtreasurynotes true/false
Show Expedition Stamps - How many Expedition Stamps (EX.S. when abbreviations used) currency you have.
showstamps true/false
Show Supplies - How many Milestone Zero Supplies (M0.S. when abbreviations used) currency you have.
showsupplies true/false
Show Perk Coins - How many Perk Coins (P.C. when abbreviations used) currency you have.
showperkcoins true/false
Show Tadpole Badges - How many Tadpole Badges (T.B. when abbreviations used) currency you have.
showtadpole true/false
Show Possum Badges - How many Possum Badges (P.B. when abbreviations used) currency you have.
showpossum true/false
Show Atoms - How many Atomic Shop Atoms (A.S. when abbreviations used) currency you have (account-wide).
showatoms true/false
Show Caps Limit - Your current "daily" caps limit ($.L. when abbreviations used). You must interact with a vendor for the mod to get this data.
showcapslimit true/false
Show Legendary Scrip Limit - Your current "daily" scrip limit (LS.L. when abbreviations used). You must interact with a legendary exchange machine for the mod to get this data.
showscriplimit true/false
Show Gold Bullion Limit - Your current "daily" bullion limit (GB.L. when abbreviations used). You must interact with a gold press machine for the mod to get this data.
showbullionlimit true/false
Fusion & Plasma Cores
Show Core Percent - Condition of currently equipped core (fusion/plasma/ultracite). Supplement to ammo count which will show number of cores of equipped type. Does not show anything when a non-core type of ammo is equipped. (CC.%. when abbreviations are used)
showcorepercent true/false
Show Core Percent Total - Total condition of all cores of the same type as your currently equipped one. Supplement to ammo count which will show the number of cores of the equipped type. Does not show anything when a non-core type of ammo is equipped. (Labeled as Core %%. CC.%% when abbreviations are used)
showcorepercenttotal true/false
Show Fusion Cores Count - Number of Fusion Cores in inventory, regardless of whether equipped or not. (Fu.C. when abbreviations are used)
showfusioncount true/false
Show Fusion Core Percent Total - Total condition of all Fusion Cores in inventory, regardless of whether equipped or not. (Labeled as Fusion %%. Fu.%% when abbreviations are used)
showfusionpercenttotal true/false
Show Ultracite Fusion Cores Count - Number of Ultracite Fusion Cores in inventory, regardless of whether equipped or not. (Labeled as Ul.Fus Cores. UF.C. when abbreviations are used)
showultrafusioncount true/false
Show Ultracite Fusion Core Percent Total - Total condition of all Ultracite Fusion Cores in inventory, regardless of whether equipped or not. (Labeled as Ul.Fus %%. UF.%% when abbreviations are used)
showultrafusionpercenttotal true/false
Show Plasma Cores Count - Number of Plasma Cores in inventory, regardless of whether equipped or not. (Pl.C. when abbreviations are used)
showplasmacount true/false
Show Plasma Core Percent Total - Total condition of all Plasma Cores in inventory, regardless of whether equipped or not. (Labeled as Plasma %%. Pl.%% when abbreviations are used)
showplasmapercenttotal true/false
Show Ultracite Plasma Cores Count - Number of Ultracite Plasma Cores in inventory, regardless of whether equipped or not. (Labeled as Ul.Pla Cores. UP.C. when abbreviations are used)
showultraplasmacount true/false
Show Ultracite Plasma Core Percent Total - Total condition of all Ultracite Plasma Cores in inventory, regardless of whether equipped or not. (Labeled as Ul.Pla %%. UP.%% when abbreviations are used)
showultraplasmapercenttotal true/false
Season Stats
Show Season Tickets - How many unspent Tickets you have in the current Season (SS.T. when abbreviations are used).
showseasontickets true/false
Show Season Rank - Your numeric rank in the current Season (SS.R. when abbreviations are used).
showseasonrank true/false
Show Season Points - How many points toward the next rank in the current Season do you have (SS.P. when abbreviations are used).
showseasonpoints true/false
Show Season Points Percentage - How far toward the next rank in the current Season you are as a percentage (SS.P. when abbreviations are used).
showseasonpointspercent true/false
Misc
Show Time - Display current time. Use a number in place of true to adjust time zone relative to your computer's local time. You can use fractional numbers (e.g. 1.5) if needed.
showtime true/false/-24 to 24
Show Game Time - Display current in-game time. Note: this will not be able to show anything until you have opened the Pip-Boy Data page.
showgametime true/false
Show Space - Add a blank vertical/horizontal space between other elements.
showline 2-20
Show Line - Add a line between other elements. Number represents how much vertical/horizontal space to give line, but line thickness will not change.
showline 2-20
Custom
Custom Inventory Item Tracking - How many of a particular item you currently have in inventory. Now allows for multiple matches and pattern matching and is case insensitive. If using a pattern-matching flag, you must also specify the category of the item. These can be entered at any position and there is no limit on tracking different items.
As of version 3.1, you can also specify a label that will be used when displaying instead of the first text in the pattern. The label currently will be displayed in all lower case.
showcustom=<item name>
Flags:
*text will match anywhere in item name
&text will only match at end of item name
!negative match, will not match if text found in item name
@used in front of item category, one of the following:
Weapons, Armor, Apparel, FoodWater, Aid, Books, Misc, Junk, Mods, Ammo, Holo
#following text will be used as a label
Exact Matching Examples:
showcustom=Nuka-Cola
showcustom=Stimpak
showcustom=Legendary Module
Multiple Matching Examples:
showcustom=Nuka-Cola,Nuka-Cherry
showcustom=Stimpak,Stimpak: Super
Pattern-Matching Examples:
showcustom=*Cola,@FoodWaterwould match Nuka-Cola, Nuka-Cola Orange, etc. but not Nuka-Cherry or Nuka-Grape
showcustom=*Cola,!Candy,@FoodWatersame as above but excludes Nuka-Cola candy and Nuka-Cola Quantum candy
Thanks
Thanks to Belickade, CaliforniaOne, FirstKnight3, G1RLOFW4R, Hazard15301, kevikev, MsZelia, qq2583246850, Venjalinin, and everyone else who has made suggestions and pointed out bugs.
And special thanks to Keretus for SFE.