GrabRecharge

版本 v2.0.0·更新於 2025-06-18

A BepInEx plugin that allows players to recharge grabbed items manually using customizable mod power.

模組介紹 作者原文

Player Grab Recharge

A BepInEx plugin for Unity-based games that allows players to recharge grabbed battery items manually using customizable mod power. Built with Harmony patching and Photon networking support.

Features

  • Manual Battery Recharge: Recharge grabbed batteries using a configurable key.
  • Toggle/Hold Mode: Use toggle or hold input to control recharging.
  • Mod Power System: Recharging consumes mod power and regenerates over time.
  • Visual UI: Optional in-game UI shows current mod power level and cooldowns.
  • Multiplayer Support: Proper PhotonView ownership handling in multiplayer environments.
  • Debug Logging: Toggleable detailed logs for troubleshooting.

Requirements

  • BepInEx 5.x
  • HarmonyLib
  • Photon Unity Networking (PUN2) enabled project
  • TMPro (TextMeshPro) used for in-game UI

Installation

  • Install BepInEx in your game directory.
  • Place the compiled PlayerGrabRecharge.dll into the BepInEx/plugins folder.
  • Launch the game once to generate the configuration file.
  • Customize settings in BepInEx/config/modx.playergrabrecharge.cfg.

Configuration Options

| Setting | Description | Default |

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

| Recharge Key | Key to activate recharge | Z |

| Toggle Mode | Recharge mode: true = toggle, false = hold | false |

| Recharge Rate | Battery charge per second (1-30) | 10 |

| Enable Debug Logging | Enables verbose logs in console | false |

| Show Charge Bar | Show mod power UI on screen | true |

How It Works

  • When you grab a battery item, a mod power gauge is displayed (if enabled).
  • Hold or toggle the recharge key (Z by default) to charge the battery:
  • Recharge drains mod power.
  • Mod power regenerates over time when idle.
  • If mod power depletes, a cooldown starts before it begins to regen.

Debugging

Enable "Enable Debug Logging" in the config to log:

  • Ownership requests
  • Recharge start/stop triggers
  • Battery life and mod power changes
  • Cooldown and regeneration steps

Compatibility & Multiplayer

  • Fully compatible with Photon Multiplayer.
  • Master client (Host) can only rechrage items.
  • Automatically syncs recharge behavior across clients.

Credits

Developed by modx

Powered by BepInEx, Harmony, and Photon PUN2

安裝與使用 安裝：BepInEx 外掛

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

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

前置依賴

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

BepInEx-BepInExPack

檔案與校驗

檔案名稱
GrabRecharge-2.0.0.zip
檔案大小
20.5 KiB