BrackenAngerMeter
This mod displays Bracken's internal angermeter and AI systems in real time via the UI. It features a UI that represents the angermeter, UI text providing detailed information, and various additional functions, making it particularly useful for researching Bracken, learning about them, and practicing how to defeat them.
Features
The UI and features function when Bracken is active.
Bracken Anger Meter UI
The internal "anger meter" system is displayed visually via the UI. It also visually represents the current anger level. The design uses different colors to indicate the level of anger.
Green → Yellow → Orange → Red
Bracken Detailed information Text UI
Detailed information about Bracken is displayed as text in the UI. The following information is displayed.
DETAILED INFORMATION
BRACKEN ID: The unique network ID of the currently selected Bracken.
- This is primarily useful when multiple Brackens are present, allowing you to identify and track a specific individual while switching between targets.
ANGER: The Bracken's current internal anger value.
- This is one of the most important values in the Bracken AI system. Anger increases when the Bracken is repeatedly threatened or observed by players and decreases over time under certain conditions.
- A higher anger value generally means the Bracken is closer to entering aggressive behavior patterns.
- The meter is internally set from 0 – 12, but it also supports percentage display.
- The internal range is typically 0 – 12, although values may temporarily exceed expected thresholds depending on gameplay events.
- Outside ANGRY mode, it acts as an anger accumulation meter used for aggression checks.
- During ANGRY mode, it becomes the remaining duration timer before the Bracken returns to normal behavior.
ANGER CHANCE: An estimated probability derived from the current anger value.
- This percentage represents how likely the Bracken is to enter its anger-related behavior routines based on its current anger level.
- As anger rises, the chance increases proportionally.
ANGER TIME LEFT: This indicates the remaining duration of the Bracken's active anger period before it returns to normal behavior.
- Only displayed while the Bracken is currently in the ANGRY state.
STATE: The Bracken's current behavior state.
SNEAKING: The Bracken is operating normally, stalking players and attempting to remain unseen.EVADING: The Bracken has recently been observed and is attempting to retreat, reposition, or avoid direct exposure.ANGRY: The Bracken has entered an aggressive state and may behave much more dangerously than usual.
ANGER STACKS: The Bracken's internal threat counter.
- This value does not increase every time a player looks at the Bracken. Instead, it increases when the Bracken successfully enters ANGRY mode while its anger level is still relatively low.
- Higher stack counts increase the duration of future ANGRY states by granting additional anger time when ANGRY mode begins.
- This value directly reflects the internal
timesThreatened variable used by the game.
ANGER BONUS: The additional anger time granted by the current threat stack count.
- When the Bracken successfully enters ANGRY mode, the game adds
timesThreatened / 1.75 to the current anger value.
- Because anger is used as the ANGRY state timer, higher bonus values cause the Bracken to remain aggressive for longer periods.
- This value does not directly increase anger accumulation speed. Instead, it extends the duration of future ANGRY states.
TARGET: The player currently targeted by the selected Bracken.
- When a target exists, the player's username will be displayed.
- A target of NONE means the Bracken currently has no active target or is not actively tracking a specific player.
DISTANCE: The real-time distance between the Bracken and its current target.
- This value is measured in meters.
- Distance calculations are based on straight line distance, not navigational mesh distance.
The following considerations have also been taken into account.
- Hide the UI when Bracken is inactive.
- Support in Config.
- Support for multiple Brackens.
- Functionality to adjust the anger Value.
- Multiplayer compatible.
- Vanilla compatible.
Config
You can change the settings in the config file.
Edit the config if desired. We recommend editing the file using LethalConfig by AinaVT.
UI
You can enable or disable the display of each UI element.
| Setting |
Default |
| Show Meter |
True |
| Show Info Text |
True |
Controls
You can optional set a key to toggle between the anger meter UI and the detailed information UI when there are multiple Brackens.
| Setting |
Default |
| Next Bracken Key |
PageUp |
| Prev Bracken Key |
PageDow |
General
| Setting |
Default |
Consideration |
| Enable Initial Anger |
False |
Host only. |
| Initial Anger Meter Value |
0.0 |
Min: 0.0 / Max: 12.0 |
- The Initial Anger Meter Value option only affects newly detected Brackens when you are the host.
- To make it easier to transition immediately to the Angry state, we've set the Anger Meter and Threat Stack (timesThreatened) to the same value. However, as a result, the duration of the Angry state has been extended.
- Higher values do not instantly force the Bracken into the ANGRY state, but they significantly increase the probability of anger activation once additional anger is accumulated. Set this value to 0 for vanilla-equivalent behavior.
- Bracken anger meter applied when Anger builds up or detected.
Installation
In addition to installing and managing mods through the Thunder Store, if you wish to install this mod directly via the mod manager linked to the Thunder Store, please follow the steps below.
-
Access the profile in the Thunder Store's local files.
Thunderstore Mod Manager/DataFolder/LethalCompany/profiles/(Optional profiles)
-
Place Bracken.dll in the BepInEx directory.
BepInEx/plugins/BrackenAngerMeter/BrackenAngerMeter.dll
-
In the Thunder Store, click Modded on the relevant profile to launch the game.
Notes
- This mod relies on internal game fields and AI variables accessed through reflection. Future game updates may change these internal structures, which could cause some information to become inaccurate or stop working entirely until the mod is updated.
- Values displayed by this mod are based on observed and interpreted internal AI data. Certain values, labels, or behavioral explanations may not perfectly represent the exact logic used by the game.
- With the exception of certain features, the UI typically functions normally even in online environments; however, it reveals information powerful enough to affect gameplay. Therefore, please use this mod responsibly. Please refrain from using it as much as possible during gameplay with other players.
- While I designed this mod based on my internal analysis and information gathering regarding LethalCompany to the best of my ability, please be aware that there may be discrepancies in my understanding of Bracken’s structure or instances where the design does not strictly adhere to the original.
- This mod has not been tested on versions prior to v81.
