LocalFlashlight

A Lethal Company mod which adds a flashlight that has a recharging battery, with visual indicators, custom colors, multiple recharge options for the battery, and more.

Mod capabilities

The mod adds a flashlight that uses a battery system which can be recharged in different ways.

It also adds an indicator for the battery that has multiple styles and settings.

The mod also has a plethora of settings, so you can modify almost everything that it can do.

Installation and configuration

The mod can be installed using the mod manager of your choice, or it can be installed manually by installing BepInEx for the game, downloading the mod manually from the Thunderstore page of the mod or from the Releases tab in the Github repository (which also needs you to download the dependencies for the mod, which are InputUtils, LethalConfig and TerminalAPI), then extracting the zip file inside the BepInEx/plugins folder after starting the game once with BepInEx installed.

Configuration of the mod can be done after starting up the game with the mod enabled through the Config editor (Thunderstore Mod Manager or r2modman) or by opening the command.LocalFlashlight.cfg file made by the mod in the BepInEx/config folder.

Alternatively, you could edit the settings with LethalConfig in the game, as it is now one of the mod's dependencies (besides networking, that needs to be set through the config itself, not through LethalConfig).

Mod settings

-Intensity, range and spot angle of the light can be set to your liking

-Some battery settings can also be modified

-The indicator has six different styles (Low battery warning, Bar, Percentage, Circular Bar, Vertical Bar, All) and four different text info styles (Percentage, Accurate percentage, Time, All)

-Custom colors can be set for the light and indicator with hex codes

-The light can be set to have shadows (or not)

-Option to prioritize in-game flashlights before the local flashlight (when they're in the inventory, or when a helmet light is active) when trying to toggle them. (unfortunately, laser pointers also count as flashlights)

-Multiple recharge options for the flashlight (with some being a little too good, but they all have their upsides and downsides depending on how you set up the mod)

-Multiple options for the flashlight's sounds!

-Networking can be used to play with other people that also have networking enabled, while also being able to see their lights alongside their colors and the sounds they set

Indicator config styles

Battery recharge options

[!IMPORTANT] Good news! the mod has networking now! it's still experimental but I actually managed to unlocal the flashlight.

Bad news. If you do have networking enabled, expect bugs, and if you do encounter them, please report it on the github page or on the modding server. Another issue is that you won't be able to join people without the mod (or with the mod but without networking enabled), so it's best to use this when playing with friends or with a dedicated modpack!

Back to the good news, I didn't have to cut the mod in the local half and the networking half so that's awesome.

The mod's keybinds are in Settings -> Change keybinds, as this mod uses LCInputUtils to add mouse and controller binds.

If you found a bug, error or encountered something that shouldn't have happened with the mod, then feel free to open a new issue on the Github page or the LC modding discord server to report it.

V1.4.1.3

• Fixed Ambient light intensity multiplier not working as intended
• Added audio occlusion to other players' lights when using networking (so you can't fully hear flashlight sounds through walls)
• Fixed noises audible to the world sometimes not working properly when inside the ship while its doors are closed

V1.4.1.2

• Fixed networking not working at all, alongside the two changes.
• Also added TerminalApi as a dependency. It will be used in future updates.

V1.4.1.1

• Fixed the flickering when the battery ran out not occuring due to an oversight in the sound playing part of the mod, where it would forget to check for networking before calling the server rpc

V1.4.1

• really quick hotfix because i messed up while trying to clean up part of the code related to the Time recharge method (forgot to cap the battery time so it would go over the max battery time for other recharge options)

V1.4

• Added LethalConfig as a dependency to make setting configs easier for the player (and also other things besides that)
• Changed color configs to a hex code instead of three separate configs for red, green and blue values (for the flashlight and the indicator)
• Fixed pretty much all the bugs related to the Prioritize in-game flashlights setting
• Reworked the Apparatice recharge method to function based on the power inside the facility (and renamed it accordingly to FacilityPowered)
• Made some adjustments to the Dynamo recharge method (higher total recharge power, though it requires a little time to ramp up)
• Made the sound played when recharging the flashlight using the Dynamo recharge method ramp up and back down instead of abruptly playing and stopping
• Added option to adjust the in-game's natural "dark area light" intensity percentage to make seeing in dark areas dependent on the flashlight (set to 50% of the normal ambient light intensity by default)
• Added setting to choose if the flashlight should be fully charged when you enter orbit (default: true)
• Fixed some scraps held by player blocking the light if the Enable shadows config was enabled
• The flashlight no longer needs to be turned on to change its position and rotation (from left to right and vice-versa)
• Changed some existing sounds in some of the sound options
• Fixed vertical rotation inconsistencies when switching flashlight positions for the first time after joining a game
• Reworked how sounds are loaded to account for other players using different sound options
• Removed config related to enemies hearing sound, and with this change some sounds were changed to no longer be heard by enemies
• Added a way for all players to see eachother's lights using networking. This is still something that's worked on, so it's still an experimental feature.
• Overall code improvements, which should solve some issues with lag (if there were any that I wasn't aware of).
• Made some configs even clearer, and added a few caps to their values

! make sure to remake the config file (deleting and generating it again by opening the game), as i'm pretty sure some configs will no longer apply any changes because they've either had their name changed or have been outright deleted.

V1.3.1

• Added flashlight dimming (with config to set at what battery percentage the light should stop dimming)
• Added flashlight flickering when the battery runs out or when ghost girl changes behavior state and flickers every other light (default is set to true)
• Hopefully fixed some bugs related to the "Prioritize flashlights in player inventory" config
• Changed the way the mod's assetbundle is loaded to prevent using up RAM while loading it
• Added 5 frames of leniency before the mod sends an error message if it has errors while trying to find the local player controller

V1.3

• Added config option for various battery recharge methods, each with their upsides and downsides (and some with configs).
• Added full recharge sounds to the flashlight when using the time recharge config
• Added config option for sounds to be heard by enemies (default is set to true)
• Cleaned up code for optimization
• Made most logs debug logs to avoid log spam
• Made it so the error caused by the mod not finding the local player only gets sent once instead of every time per frame
• The HUD no longer shows up if the light doesn't work
• Made InGameFlashlight the default sound option for the mod to use
• Made configs look cleaner (at least when looking at them with LethalConfig)
• Changed some names for the sound options
• Added keybind to change light position from left to right, and vice versa to prevent the light from being covered by any items currently held (default key: H)
• Added keybind to recharge the flashlight (used for Shake and Dynamo recharge methods) (default key: Q)

V1.2.21

• Fixed light not turning on anymore (with the "Prioritize in-game flashlights" config set to true) if the player dies until they pick up and drop another flashlight
• Changed some position and rotation values of the light

V1.2.2

• Added config option to prioritize flashlights in the player's inventory until their battery is depleted
• Added a third sound option (InGameFlashlight)
• Added more logs
• Changed some config descriptions to be more clear about what they do (i recommend deleting the config file as it might cause some issues if the new configs overlap the old ones)

V1.2.1

• Added LCInputUtils as dependency for easier keybind configuration
• Added sound options (currently only two of them, Default and ActualFlashlight)
• Updated README file to add installation and configuration, and a small note about the new keybind configurations

V1.2

• Added separate config options for light color and HUD color
• Some settings can now be changed without having to rejoin a lobby (specifically the ones that aren't important, like colors or intensity)
• Added configs for indicator position on the screen (IndicatorPositionX and IndicatorPositionY)
• Added config for battery text options (Percentage, AccuratePercentage, Time, All)
• Added an experimental config to enable light shadows
• Fixed indicator not fading in when using the flashlight at abnormally high battery times
• Fixed bugs related to player death not turning off the flashlight, which resulted in battery loss when dead
• More overall code changes
• Added more logs in case something goes wrong
• Updated README

V1.1

• Made changes to the code so set configs can apply when entering a lobby
• Added two HUD styles (CircularBar, VerticalBar)
• Added some debug logs (LightController made, light toggle)
• Fixed flashlight toggling when pressing the toggle key in the pause menu
• Added battery regen cooldown config
• Volume now updates immediately after config change