REPO_JP-HideFlashlightHand icon

HideFlashlightHand

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

By REPO_JP
Last updated 2 weeks ago
Total downloads 5203
Total rating 8 
Categories Mods Client-side AI Generated
Dependency string REPO_JP-HideFlashlightHand-4.0.0
Dependants 3 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

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

  1. Install BepInEx 5.
  2. Place HideFlashlightHand.dll in the BepInEx/plugins folder.
  3. Start the game once to generate the config file.
  4. 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サーバーあります! 参加は以下のリンクから! https://discord.gg/h5ATY4m5bZ

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

概要

HideFlashlightHand は、自分の一人称視点に表示される懐中電灯モデルを非表示にします。 実際の懐中電灯機能は変更しません。 照射Light、LightActive状態、影用メッシュ、三人称表示は無効化しません。

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

主な機能

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

導入方法

  1. BepInEx 5 を導入します。
  2. HideFlashlightHand.dllBepInEx/plugins フォルダに配置します。
  3. ゲームを一度起動してConfigファイルを生成します。
  4. 必要に応じて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.StartFlashlightController.Update をPatchします。 バニラ処理の実行後、懐中電灯がローカルプレイヤーのものか、一人称の手元モデルとして描画されているかを確認します。 条件に一致した場合のみ、FlashlightController.mesh.enabledfalse にします。

以下のオブジェクトや状態は意図的に変更しません。

  • spotlight
  • LightActive
  • meshShadows
  • 三人称懐中電灯メッシュ状態
  • 懐中電灯のState遷移

これにより、実際の照射挙動や他プレイヤーからの表示を壊さないようにしています。

※AI生成MOD