Better Flashlight Addon

What you get

A full flashlight lifecycle

This isn’t a single “on/off” item. You craft a shell, install batteries, run the light until it dies, eject the dead cell, recharge it, and do it again.

• Flashlight (Empty) — shell with no battery; install a charged battery to use it

• Flashlight OFF / ON — right-click to toggle; the beam follows where you look

• Flashlight DEAD — battery died inside; right-click to eject it (sound → short delay → dead battery out → empty shell again)

Batteries

• Flashlight Battery — charge shown on the durability bar; stacks to 16

• Dead Flashlight Battery — what you get when a flashlight dies; empty bar, same 3D model in hand

• Recharge: Dead Battery + Redstone at a crafting table → full battery

• Hot-swap: Use a charged battery on a powered flashlight; only 1 is taken from a stack; your old battery goes back to inventory, or drops at your feet if you’re inventory is full

Crafting

• Empty flashlight: glass pane, iron, copper, redstone

• Battery: redstone, iron nuggets, coal

• Recharge: dead battery + redstone

• Quick revive: dead flashlight + battery at a table → flashlight OFF (shortcut if you don’t want to eject first)

Gameplay feel

Dynamic light beam
Places light along your view direction — up to ~18 blocks, fading with distance. It stays on while you’re in chat, in your inventory, or standing still (no more beam dying when you pause to read).

Per-flashlight charge
Two flashlights in your inventory keep separate battery levels — swapping items doesn’t sync them.

Battery life
About 3 minutes of runtime per full charge (at normal tick rate).

Low battery tension
As charge drops:

• Warning beeps (volume tuned so they’re noticeable, not ear-splitting)

• One-time tutorial hints per world (won’t spam every time)

• Flicker that gets worse as the battery dies

• At critical levels, the light can stutter off briefly — then come back

• Very rare chance the flashlight breaks on toggle → dead state and the full eject flow

Sound design
Custom audio for toggle on/off, running hum, flicker, low/critical beeps, battery install/eject, and the moment the battery dies.

3D models in hand
Attachable models for the flashlight and both battery types (including dead).

For testers / devs

• /scriptevent fl:flashlight_reset_hints — reset one-time tutorial messages

• Sneak + use an OFF flashlight — sound diagnostic test

• /scriptevent fl:flashlight_sound_debug — verbose sound logging