🤔 About

Flickering Flashlight adds random flashlight flickering at low battery levels, enhancing tension and realism during gameplay. Possible configuration.

The script is based on the following YouTube video: https://www.youtube.com/watch?v=jfgUotZXiBM&ab_channel=GameDevBox

🔨 How it works

The flickering flashlight will start when:

• The battery goes below specific level
• The player's fear level jumps to the required level
• The insanity level goes above a specific threshold

📁 Configuration

• Energy Threshold
  • Low Energy Threshold - The battery level (%) below which the flashlight starts flickering. <0,1> [default 0.3]
  • Critical Energy Threshold - The battery level (%) at which the flashlight enters critical mode (heavy flickering). <0,1> [default 0.1]
• Duration
  • Flicker Duration - Duration (in seconds) of flashlight flickering. <0.2,15> [default 1.5]
  • Min Flicker Delay - Minimum delay (in seconds) between flickers. <0.01,2> [default 0.05]
  • Max Flicker Delay - Maximum delay (in seconds) between flickers. <2,8> [default 0.2]
  • Next Low Flick - Minimum delay (in seconds) between flashlight flickers when battery is low. <0,60> [default 10]
  • Next Critical Flick - Delay (in seconds) between flashlight flickers when battery is critically low. <0,30> [default 3]
• Chance
  • Low Energy Flicker Chance - Chance (%) that the flashlight will flicker when battery is low. <0.01,10> [default 0.01]
  • Minimal Fear Level - Flashlight start flickering when player fear goes above this percentage. <0,1> [default 0.4]
  • Minimal Insanity Level - Flashlight starts flickering when player insanity goes above this percentage (You gain insanity by being alone). <0,1> [default 0.9]
• Frequency
  • Low Energy Flicker Multiplier - Multiplier applied to flicker frequency when battery is at low level. <1,20> [default 10]
  • Critical Energy Flicker Multiplier - Multiplier applied to flicker frequency when battery is at critical level. <1,20> [default 2]
• Other
  • Infinity Critical Energy - Prevents the flashlight battery from dropping below 5% (infinity critical energy). [default false]
• Debug
  • Enable Logs - Show debug messages in the console about flashlight flickering. [default false]

🔥 Preview

Mods were used at the preview: ShyHUD, EladsHUD, Full Darkness

📝 Feedback

If you have any Feedback or questions, please contact me at [email protected] or Github.

Changelog

The documentation of all notable changes to this project will be stored in this file.

[1.0.1] - 11.07.2025

Changed

• The flashlight flickers much faster on low batteries
• New configuration variable: Low Energy Flicker Multiplier

[1.0.0] - 08.07.2025

Added

• Initial implementation