Immersive Custom Flashlight

Progress update

Sorry I haven't been working on updates, life is getting in the way. I promise soon I'll address some of the issues I keep noticing. For example, I keep seeing people say the mod stays installed after deletion. Far as I'm aware this isn't due to my mod, but it's hard to say. I cannot replicate this issue, it uninstalls fine. Just make sure you're playing the 64 bit branch of Gmod as that is what this mod supports. Besides that, general mod conflicts and servers hosting my mod may be the culprit. I'll keep an eye on the issue!

Can't find the right flashlight mod? Flashlight feeling too stiff, flat, or glued to your camera? Well, I bring you ICFL, the ultimate flashlight customizability mod.

Immersive Custom Flashlight replaces the default GMod flashlight with a customizable clientside projected flashlight built for horror, exploration, bodycam, cinematic gameplay, and immersive first-person experiences.

The goal is simple:

Make the flashlight feel like something your character is actually holding!

Features

• Replaces the default GMod flashlight with a fully customizable projected flashlight

• Works with the normal flashlight key, custom keybinds, Mouse 4 / Mouse 5, and other weapons

• Adjustable brightness, FOV, range, color, shadows, position, textures, and Lightspill

• Spring smoothing, inertia, sway, breathing, sprint bob, fear shake, and bodycam / free-aim movement

• Optional battery system with drain, reloads, low-power effects, HUD, and pickup entity

• Optional VManip, WebKnight, third-person, vehicle, and experimental multiplayer support

• Wall detection, startup flicker, toggle sounds, keep-on-death, and stock flashlight blocking

• Presets, category reset buttons, cleaner menus, and Cy's Recommended Settings

• Compatibility fixes for menus, typing, Wiremod keyboards, VManip hooks, and other edge cases

• I promise you there won't be much you can't customize about your flashlight!

New In v1.2.5

• Compressed alternate flashlight textures, thanks to fran

• Full Lightspill support using textures from fran

• Separate Lightspill settings category

• Lightspill texture preset dropdown

• Lightspill size, brightness, FOV, range, color, and offset controls

• Updated Cy's Recommended Settings preset

• Improved menu layout for a cleaner user experience

• Typing / Wiremod keyboard input compatibility fix

• Stronger VManip compatibility guard for addons that accidentally restore the default VManip flashlight

• Additional bug fixes and compatibility improvements

Batteries

v1.2 adds an optional battery system for players who want a more survival-horror style flashlight. When enabled, the flashlight can drain over time, dim or flicker when weak, and be refilled with spare batteries.

Reloading can briefly cut the light out and bring it back with a small flicker, giving it more of a physical flashlight feel. The system also includes an optional HUD, reload key support, reload sound support, and a battery pickup entity. The battery system is optional and disabled by default.

VManip Flashlight Support & Hand Follow

v1.2 adds optional VManip flashlight animation support. This lets Immersive Custom Flashlight use VManip animations while still keeping this addon's custom projected light, smoothing, bodycam behavior, color, brightness, FOV, range, texture, and other settings. Supported modes include [VManip] Default Flashlight and [VManip] Flashlight by WebKnight.

WebKnight support also includes an experimental held-flashlight follow system. After the animation finishes, the flashlight model attempts to follow Immersive Custom Flashlight's custom beam direction so the hand and light feel closer together. This is a Lua bone-manipulation fake, not a fully custom compiled animation rig, but it allows wrist-style left/right and up/down movement that feels much more natural with bodycam/free-aim mode. VManip support is optional and disabled by default.

Experimental Multiplayer Visibility

Immersive Custom Flashlight is mainly clientside, but v1.2 includes optional experimental multiplayer visibility. If the server has the addon installed, players can optionally send simplified flashlight state to other players.

Other players will see a simplified third-person flashlight beam using your on/off state, aim direction, color, brightness, FOV, and range. VManip hand animations remain local-only. This feature is experimental, disabled by default, and safely does nothing if the server does not support it.

Bodycam / Free-Aim Mode

Bodycam mode lets the flashlight move independently from the center of your camera before the view catches up. Instead of being perfectly glued to your crosshair, the beam can drift, lag, and feel more like something your character is physically holding.

Great for horror maps, bodycam-style gameplay, exploration, found-footage setups, cinematic scenes, and immersive first-person roleplay.

Settings Location

Q Menu > Utilities > User > Immersive Custom Flashlight

Notes

This addon is designed mainly for singleplayer and clientside use.

Experimental multiplayer visibility requires the server to have the addon installed.

This addon may conflict with other flashlight replacement addons, weapon flashlight systems, projected-light addons, or VManip flashlight addons.

VManip compatibility, WebKnight support, multiplayer visibility, battery systems, and the empty-hands bridge are optional and disabled by default.

Reuploads / Code Changes

Please do not reupload this addon or upload edited versions without asking for permission first.

You are welcome to modify the addon for personal use, but if you want to release a changed version, use parts of the code, or include it in another project, please contact me first and give proper credit.

Recommended Pairings

• Smooth Mouse Look / Minecraft Cinematic Camera by TiberiumFusion

• Cinematic Camera by Nakotuhin

• Realistic VHS Effect2 by Adon1111222

• [VManip] Default Flashlight

• [VManip] Flashlight by WebKnight

Credits

Credit to Flashlights with Lightspill by fran and Defrektif for the original alternate flashlight textures and lightspill texture work: https://steamcommunity.com/sharedfiles/filedetails/?id=2958768384

Additional credit to fran for the compressed flashlight textures used in v1.2.5.

Additional credit to fran for the Lightspill textures used by ICFL's Lightspill system.

Credit to Dynamic Flashlight Fix by Asrial for the idea to add extra flashlight polish features: https://steamcommunity.com/sharedfiles/filedetails/?id=3421175916

Credit to [VManip] Default Flashlight for the VManip flashlight animation compatibility target: https://steamcommunity.com/sharedfiles/filedetails/?id=3667006901

Credit to [VManip] Flashlight by WebKnight for the WebKnight VManip flashlight support target: https://steamcommunity.com/sharedfiles/filedetails/?id=2778699319

Credit to Chen's VManip Patch for VManip compatibility fixes and testing support: https://steamcommunity.com/workshop/filedetails/?id=3262499127

PLEASE RATE!

If you like ICFL and want to help people see it, give it a rating!

Search Tags / Keywords

Smooth flashlight, custom flashlight, immersive flashlight, realistic flashlight, horror flashlight, bodycam flashlight, free aim flashlight, flashlight replacement, GMod flashlight replacement, Garry's Mod flashlight, GMod horror, horror addon, exploration flashlight, flashlight sway, flashlight bob, flashlight inertia, flashlight smoothing