CustomFlashlights 2.0
The Ultimate Realistic Lighting Solution
Ray-Tracing | Batteries | Colored Lenses | ⚔️ Tactical Mechanics
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Overview
Forget standard Night Vision or boring torch spam. CustomFlashlights introduces a revolutionary Ray-Tracing Light System to your server.
With Version 2.0, we've taken immersion to the next level. Equip your players with battery-powered flashlights that project actual light blocks exactly where they aim. Whether you are running a Zombie Apocalypse, Hardcore Survival, or RPG Server, this plugin adds a layer of depth and strategy that vanilla Minecraft simply cannot match.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
✨ Key Features (v2.0)
Dynamic Ray-Tracing Lighting
✨ Key Features (v2.0)
- Real-Time Illumination: The light beam follows your crosshair instantly with zero lag.
- Realistic Beams: Optional particle effects create a visible cone of light cutting through the fog.
- Dual Wielding: Hold a flashlight in your Off-Hand while fighting with a Sword in your Main Hand.
- Smart Physics: Light interacts with the environment—it won't pass through solid walls!
- Tiered Progression: Create "Basic", "Advanced", and "Professional" flashlights with different battery lives and brightness levels.
- Hot-Swappable Batteries: Flashlights die. Players must scavenge or craft batteries to stay alive.
- Solar Charging: Stand in direct sunlight to slowly recharge solar-compatible units.
- Live HUD: A beautiful Action Bar display shows exactly how much power you have left.
Tactical gameplay is here. Equip different lenses (Shift+Left Click) to adapt to the situation:
- Green Lens (Ore Finder): High-contrast light that highlights valuable ores (Diamond, Gold, Ancient Debris) in the dark.
- Red Lens (Stealth): Dimmer light that doesn't alert monsters. Perfect for sneaking past enemies.
- UV Lens (Revealer): Reveals hidden entities or invisible players.
⚔️ Tactical & Survival Mechanics
- Monster Fear: Undead mobs (Zombies, Skeletons) are terrified of bright light and will flee from your beam!
- Strobe Mode: Disorient enemies with a rapid-flashing tactical strobe (increases heat generation).
- Blindness: Shine a high-tier flashlight into a player's eyes to temporarily blind them.
- Overheating: Don't leave it on forever! Flashlights heat up and will force-shutdown if they get too hot.
- Control exactly where flashlights can be used.
- Flag:
(Allow/Deny flashlight usage in specific regions).Code (Text):flashlight-allow
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
How to: Custom Texture Setup
(CustomModelData Guide)
CustomFlashlights 2.0 supports CustomModelData, allowing you to have different textures for when the flashlight is ON, OFF, or has LOW BATTERY.
How to: Custom Texture Setup
(CustomModelData Guide)
Step 1: Configure the Plugin
In
Code (Text):
config.yml
Code (Text):
flashlights:
advanced:
model_data:
on: 2001 # Texture when flashlight is ON
off: 2000 # Texture when flashlight is OFF
low_battery: 2002 # Texture when battery is < 20%
In your resource pack's item model file (e.g.,
Code (Text):
assets/minecraft/models/item/carrot_on_a_stick.json
Code (Text):
{
"parent": "item/handheld",
"textures": { "layer0": "item/carrot_on_a_stick" },
"overrides": [
{ "predicate": { "custom_model_data": 2000 }, "model": "item/flashlight_off" },
{ "predicate": { "custom_model_data": 2001 }, "model": "item/flashlight_on" },
{ "predicate": { "custom_model_data": 2002 }, "model": "item/flashlight_low" }
]
}
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Roadmap & Future Plans
We are constantly pushing the boundaries of what Spigot can do. Here is what is coming next:
Roadmap & Future Plans
- ️ Thermal Vision Lens: A new lens type that highlights mobs and players through walls (heat signatures).
- Immersive Sound Pack: Custom sound effects for toggling switches, battery reloading, and overheating sizzles.
- Vehicle Support: Mountable searchlights for Boats and Minecarts.
- Redstone Integration (API): Advanced API for developers to trigger events when light hits specific blocks.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Commands & Permissions
Player Commands
Commands & Permissions
Code (Text):
/recharge - Opens the GUI to add batteries to your device.
/checkbattery - Check exact battery percentage.
Code (Text):
customflashlights.recharge
Code (Text):
customflashlights.checkbattery
Code (Text):
/giveflashlight <type> [player] - Give a specific flashlight tier.
/givebattery <type> [player] - Give a specific battery type.
/cf reload - Reload configuration files.
Code (Text):
customflashlights.admin
Code (Text):
customflashlights.giveflashlight
Code (Text):
customflashlights.givebattery
-
(e.g., customflashlights.use.flashlight.professional)Code (Text):customflashlights.use.flashlight.<id>
-
(e.g., customflashlights.use.battery.small)Code (Text):customflashlights.use.battery.<id>
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
⚙️ Configuration
The plugin is 100% Configurable. Every message, light range, battery life, and lens color can be tweaked.
⚙️ Configuration
Spoiler: View Config Snippet
(Paste your config.yml content here)
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Installation
Installation
- Download CustomFlashlights.jar.
- Drop it into your server's
folder.Code (Text):plugins/
- (Optional) Install WorldGuard for region control.
- Restart your server.
- Enjoy the light!
Anonymous usage statistics are collected via bStats.
⭐ Love the plugin? Please leave a 5-star review! ⭐
⭐ Love the plugin? Please leave a 5-star review! ⭐
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.19, 1.20, 1.20.6
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
CustomFlashlights | Realistic Lighting, Batteries & Tactics is a free Minecraft Java mod. Compatible with Minecraft 1.19, 1.20, 1.20.6, 1.21. Downloaded 41 times (via Spigot). Download it and open it directly in the game.