FlashlightPlus

Improve your flashlights

This mod introduces additional mechanics to flashlights on your DayZ server, enhancing upon base vanilla immersion.

What it does:

• Brightness scales with the battery’s remaining energy (quantity).
• Condition (battery condition) increases “severity” — more chaotic bursts, dropouts and flicker.
• Random flicker bursts with configurable period + duration (with optional min/max random ranges).
• Random dropouts inside bursts (light toggles off/on for short intervals).
• Optional chance to shut down after a burst (configurable per battery condition).
• Server config auto-syncs to clients (no client config needed).

Installation

On first start, the mod creates: FlashlightPlus\FlashlightPlus.json

Configuration

The JSON below is the default schema (values are examples / defaults). Feel free to experiment with it to try different ways to approach the enhanced flashlight experience!

{
  "TickSec": 0.5,

  "LightMinCoef": 0.18,
  "LightPow": 0.9,

  "WornSeverity": 0.2,
  "DamagedSeverity": 0.55,
  "BadlyDamagedSeverity": 0.85,

  "BurstPeriodSec": 45.0,
  "BurstPeriodMinSec": 0.0,
  "BurstPeriodMaxSec": 0.0,

  "BurstDurationSec": 4.0,
  "BurstDurationMinSec": 0.0,
  "BurstDurationMaxSec": 0.0,

  "BurstPeriodMaxMul": 3.0,
  "BurstDurationMinMul": 0.4,

  "FlickerAmp": 0.75,
  "FlickerSpeed": 24.0,
  "FlickerAmpMinMul": 0.35,
  "FlickerSpeedMinMul": 0.65,

  "DropOffMinMs": 500,
  "DropOffMaxMs": 1100,
  "DropOnMinMs": 500,
  "DropOnMaxMs": 1200,
  "DropMsMaxMul": 2.0,

  "ShutdownChance": 0.45,
  "ShutdownChanceWornMul": 0.0,
  "ShutdownChanceDamagedMul": 0.25,
  "ShutdownChanceBadlyDamagedMul": 0.75
}

Notes:

• TickSec – how often the mod updates (lower = smoother but more CPU).
• LightMinCoef / LightPow – curve that maps battery energy (0..1) to intensity.
• *Severity – severity factor based on the BATTERY health state (pristine/worn/damaged/badly damaged).
• BurstPeriodSec – base time between bursts. Set to -1 to disable bursts entirely.
• BurstPeriodMinSec/MaxSec – if both > 0, period is randomized from this range (instead of BurstPeriodSec).
• BurstDurationSec – base burst length (how long the “event” lasts).
• BurstDurationMinSec/MaxSec – if both > 0, duration is randomized from this range.
• FlickerAmp / FlickerSpeed – flicker feel during bursts.
• Drop*Ms – random on/off dropout timings during bursts.
• ShutdownChance – chance (0..1) to shut down after a burst, multiplied by the condition multipliers.

Usage

Just use flashlights normally.

• The less energy in the battery, the dimmer the light.
• The worse the battery condition, the more unstable the light behavior becomes.
• Replace the battery to restore stability/brightness.

Compatibility

This mod overrides/mods the vanilla light entities listed above. If you run other mods that also heavily override Flashlight / Headtorch / UniversalLight / TLRLight scripts, you may need to merge changes.

Monetization

As long as you follow Bohemia Interactive’s server monetization rules, you are free to use this mod on your monetized server.

Repack

You are NOT allowed to repack any part of this mod, unless given my explicit consent.