🔦 FlashLight

Realistic flashlights for Minecraft, with dynamic lighting, batteries, shadows and multiplayer effects. No client mods required.

FlashLight brings a proper handheld flashlight to Minecraft. The beam follows your movements, lights up the environment around you and can be seen by other players.

Whether you're exploring caves, building a horror map or just playing survival with friends, FlashLight adds a different way to experience darkness.

Everything runs through a Paper plugin and a custom resource pack. No Forge, Fabric or external shaderpacks needed.

✨ Features

🔦 Dynamic Flashlight Lighting

• Directional light beam that follows where you're aiming.
• Illuminates walls, floors, entities and other visible surfaces.
• Preserves Minecraft's original textures and details.
• Smooth camera tracking for more natural flashlight movement.
• Works in both first-person and third-person views.
• Main-hand and off-hand support.

👥 Multiplayer Effects

Flashlights aren't just visible to the person holding them.

• See other players' flashlight beams.
• Player bodies can partially block the light and cast approximate shadows.
• Looking directly into another player's flashlight creates a glare effect.
• Effects react to distance, direction and obstacles.

🔋 Batteries & Electrical Faults

Your flashlight won't stay on forever.

• Configurable battery duration (15 minutes by default).
• Craftable replacement batteries.
• Low-battery visual effects.
• Random flickering and temporary blackouts.
• Customizable fault frequency, duration and intensity.
• Battery charge is saved directly to the item.

You can also control flickering and light intensity through commands, making it useful for scripted events and horror maps.

🛠️ Customization

FlashLight includes a configuration file where you can adjust:

• Beam range, brightness and lighting behaviour.
• Battery consumption and replacement settings.
• Flickering and electrical faults.
• Player shadows and glare.
• Sounds and crafting recipes.
• Resource pack delivery.

You can keep the default settings or adapt everything to your server.

🎮 How to Use

Action	Control
Turn flashlight ON/OFF	Right-click
Replace battery	Shift + Right-click
Get a flashlight	/flashlight give
Reload configuration	/flashlight reload

Flashlights and batteries can also be crafted in survival mode.

Administrators have additional commands for controlling flashlight behaviour, including timed effects and targeting multiple players.

📥 Installation

1. Download the JAR matching your Minecraft version.
2. Place it inside your server's plugins folder.
3. Start or restart your Paper server.
4. Configure resource pack delivery.
5. Join the server, accept the resource pack and use /flashlight give.

Important: The resource pack is required to display the flashlight model and lighting effects. The plugin automatically exports the pack, but you must configure how players receive it.

FlashLight supports external resource pack hosting, a built-in HTTP server and optional integrations with other pack providers.

🔧 Compatibility

Minecraft version	Java	Platform
1.21.4 – 1.21.11	Java 21	Paper
26.1.1 – 26.1.2	Java 25	Paper
26.2	Java 25	Paper
26.3	Java 25	Paper

Optional integrations:

• Nexo
• TRP Server Edition
• StrobeLights

FlashLight can run independently. These integrations are not required.

Please download the correct plugin file for your server version.

⚠️ Good to Know

FlashLight uses visual lighting rather than Minecraft's built-in block lighting system.

This means it doesn't place invisible light blocks, change mob spawning or permanently modify your world. The lighting is rendered on the client through the resource pack.

Some external shaderpacks and rendering mods may interfere with the effects.

Developed by MrDino

Made for Minecraft servers, adventures and horror experiences.

Licensed under CC BY-NC-ND 4.0.