File information

Last updated

Original upload

Created by

dtim

Uploaded by

dtim

Virus scan

Safe to use

Tags for this mod

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
Description

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:


* 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.