HideFlashlightHand

版本 v4.0.0·更新於 2026-05-11

【Client MOD】Hides only the local first-person flashlight hand model while keeping the beam intact.ローカル一人稱の手元懐中電燈モデルだけ非表示にし、照射挙動は維持

模組介紹 作者原文

COMPATIBLE WITH COSMETICS UPDATE V0.4.0.

This mod is a client-only mod that hides only the local first-person flashlight hand model while keeping the flashlight beam and lighting behavior intact.

Overview

HideFlashlightHand removes the visible flashlight model from your own first-person view.

The actual flashlight function remains unchanged.

The spotlight, light state, shadow mesh, and third-person visibility are not disabled.

This is useful when the first-person flashlight model blocks visibility, but you still want normal flashlight lighting.

Main Features

  • Hides only the local first-person flashlight hand model
  • Keeps the flashlight beam active
  • Keeps the spotlight and LightActive state untouched
  • Keeps third-person flashlight visibility intact
  • Keeps the shadow mesh untouched
  • Optional halo/flare hiding for the local first-person view
  • Automatic restoration when the flashlight is not being rendered as the local first-person hand model

Installation

  • Install BepInEx 5.
  • Place HideFlashlightHand.dll in the BepInEx/plugins folder.
  • Start the game once to generate the config file.
  • Edit the config file if needed.

Config

| Section | Setting | Description | Default | Minimum | Maximum |

| --- | --- | --- | --- | --- | --- |

| General | EnableMod | Enables or disables this mod | true | false | true |

| Visual | HideFirstPersonHalo | Also hides the local first-person halo/flare visual. The spotlight and flashlight lighting behavior are not disabled | false | false | true |

| Visual | RestoreWhenNotFirstPerson | Restores the local flashlight mesh when it is not being rendered as the local first-person hand model | true | false | true |

| Debug | ShowDebugLog | Shows debug logs in the BepInEx console | false | false | true |

Notes

This mod is client-only.

Other players do not need to install it.

It only changes your own local visual display.

It does not change flashlight power, brightness, range, hit detection, or network behavior.

Technical Details

The mod patches FlashlightController.Start and FlashlightController.Update with Harmony postfix patches.

After the vanilla update runs, it checks whether the flashlight belongs to the local player and whether the mesh is being used as the local first-person hand model.

When the condition matches, only FlashlightController.mesh.enabled is set to false.

The following objects and states are intentionally not modified:

  • spotlight
  • LightActive
  • meshShadows
  • third-person flashlight mesh state
  • flashlight state transitions

This avoids breaking the actual beam behavior or visibility for other players.

※Mod created by AI

COSMETICS UPDATE V0.4.0対応済み.

REPOが好きな日本人のための日本人のみのREPOのDiscordサーバーあります!

參加は以下のリンクから!

このMODは、クライアント専用の、ローカル一人稱の手元懐中電燈モデルだけを非表示にし、懐中電燈の照射挙動を維持するMODです。

概要

HideFlashlightHand は、自分の一人稱視點に表示される懐中電燈モデルを非表示にします。

実際の懐中電燈機能は変更しません。

照射Light、LightActive狀態、影用メッシュ、三人稱表示は無効化しません。

一人稱の懐中電燈モデルが視界を邪魔する場合でも、通常通り照射だけは使いたい場合に便利です。

主な機能

  • ローカル一人稱の手元懐中電燈モデルだけを非表示
  • 懐中電燈の照射を維持
  • spotlight と LightActive 狀態は未変更
  • 三人稱の懐中電燈表示を維持
  • 影用メッシュは未変更
  • ローカル一人稱表示の halo/flare を任意で非表示可能
  • 一人稱手元表示ではない場合に懐中電燈メッシュを自動復元

導入方法

  • BepInEx 5 を導入します。
  • HideFlashlightHand.dll を BepInEx/plugins フォルダに配置します。
  • ゲームを一度起動してConfigファイルを生成します。
  • 必要に応じてConfigを編集します。

設定項目

| セクション | 設定値名 | 設定內容説明 | 初期値 | 設定可能最小値 | 設定可能最大値 |

| --- | --- | --- | --- | --- | --- |

| General | EnableMod | MODを有効化または無効化 | true | false | true |

| Visual | HideFirstPersonHalo | ローカル一人稱のhalo/flare表示も非表示。照射Lightと懐中電燈の照射挙動は無効化しない | false | false | true |

| Visual | RestoreWhenNotFirstPerson | ローカル一人稱の手元モデルとして描畫されていない場合にローカル懐中電燈メッシュを復元 | true | false | true |

| Debug | ShowDebugLog | BepInExコンソールにデバッグログを表示 | false | false | true |

補足

このMODはクライアント専用です。

他プレイヤーが導入する必要はありません。

自分のローカル表示だけを変更します。

懐中電燈の電力、明るさ、射程、當たり判定、通信処理は変更しません。

技術詳細

このMODは Harmony postfix patch で FlashlightController.Start と FlashlightController.Update をPatchします。

バニラ処理の実行後、懐中電燈がローカルプレイヤーのものか、一人稱の手元モデルとして描畫されているかを確認します。

條件に一致した場合のみ、F

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

BepInEx-BepInExPack

檔案與校驗

檔案名稱
HideFlashlightHand-4.0.0.zip
檔案大小
78.8 KiB