HostReviveMod

By sakurakite

简介 / Overview

• 仅房主需要安装 / Host only: 只有房主需要安装本模组；房客可不装。/ Only the host needs to install this mod; clients can play without it.
• 长按复活队友 / Hold-to-revive teammate: 对准倒地队友并长按按键（默认 G，默认 5 秒）即可复活。/ Aim at a downed teammate and hold the key (default G, default 5 seconds) to revive.
• 全体复活 / Revive all: 房主可按一键（默认 Y）复活所有倒地队友。/ Host can press one key (default Y) to revive all downed teammates.
• 复活位置可选 / Revive position mode: 全体复活可选“房主位置”或“原地复活”。/ Revive-all can use either host position or original position.
• 中英提示切换 / Bilingual notifications: 运行时提示可在中文与英文之间切换。/ Runtime notifications can switch between Chinese and English.

功能 / Features

• 房主单端生效，房客不需要安装。/ Host-side only; clients do not need the mod installed.
• 长按复活队友（默认按键 G，默认时长 5 秒）。/ Hold-to-revive teammate (default key G, default duration 5 seconds).
• 一键全体复活（默认按键 Y）。/ One-key revive-all (default key Y).
• 全体复活位置模式：HostPosition（房主位置，默认）或 OriginalPosition（原地）。/ Revive-all position mode: HostPosition (default) or OriginalPosition.
• 可选“全体复活包含房主”（便于单人测试）。/ Optional “include host in revive-all” (useful for solo testing).
• 复活提示：你复活了谁、谁复活了你、房主复活了所有人。/ Notifications include who you revived, who revived you, and host revive-all event.
• 提示语言支持中文/英文切换。/ Notification language supports Chinese/English toggle.

兼容性 / Compatibility

• 房客不装本模组也可以被房主复活（通过网络 RPC 同步）。/ Clients without this mod can still be revived by host (via network RPC).
• 不装本模组的房客无法使用本模组快捷键。/ Clients without this mod cannot use this mod's hotkeys.

安装 / Install

1. 安装 BepInEx-BepInExPack_PEAK。/ Install BepInEx-BepInExPack_PEAK.
2. 推荐安装 PEAKModding-ModConfig 以使用游戏内配置界面。/ Recommended: install PEAKModding-ModConfig for in-game config UI.
3. 将 DLL 放入 BepInEx/plugins/。/ Put the DLL into BepInEx/plugins/.

配置 / Config

首次启动后会生成配置文件。/ Config file is generated after first launch. BepInEx/config/com.sakurakite.revivemod.cfg

主要配置项（ModConfig 内可调）/ Main options (editable in ModConfig):

• 界面 / UI -> 语言 / Language (ZhCn / EnUs)
• 输入 / Input -> 长按复活按键 / Hold Revive Key
• 输入 / Input -> 全体复活按键 / Revive All Key
• 复活 / Revive -> 长按时长秒数 / Hold Duration (Seconds)
• 复活 / Revive -> 复活检测距离 / Revive Distance
• 复活 / Revive -> 全体复活包含房主 / Include Host In Revive All
• 复活 / Revive -> 全体复活位置 / Revive All Position (HostPosition / OriginalPosition)
• 界面 / UI -> 启用复活提示 / Enable Notifications

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog: https://keepachangelog.com/en/1.1.0/

[1.5.2] - 2026-03-13

Changed

• Bumped plugin/package version to 1.5.2.
• Fix the bug that causes the mod function to not work properly.

[1.5.1] - 2026-03-13

Changed

• Bumped plugin/package version to 1.5.1.
• Added bilingual issue reporting section in README with GitHub Issues link:
  • https://github.com/naizaniao/HostReviveMod/issues

[1.5.0] - 2026-03-13

Added

• Added revive progress UI for hold-revive and dance-revive.
• Added optional progress broadcast messages via in-game message API.
• Added Instant Dance Revive fallback option.
• Added revive-all position mode CheckpointPosition (revive at target checkpoint when available).
• Added Dance Active Window (Seconds) to improve multiplayer dance detection reliability.

Changed

• Revive-all now supports 3 modes:
  • OriginalPosition
  • HostPosition
  • CheckpointPosition
• Revive execution switched back to RPCA_ReviveAtPosition(position, applyStatus, -1) for better consistency.

Fixed

• Fixed hold-revive and dance-revive reliability issues reported in host-only multiplayer tests.
• Improved dead target acquisition for hold-revive with front-cone fallback detection.

[1.4.0] - 2026-03-11

Added

• Added separate vanilla penalty toggles for revive methods:
  • Host Revive Uses Vanilla Penalty
  • Dance Revive Uses Vanilla Penalty
• Host can now independently control whether revive applies vanilla hunger+curse penalty for:
  • Hold-revive / revive-all
  • Dance-revive

Changed

• Updated README config documentation with the new penalty options.
• Bumped plugin/package versions to 1.4.0.

[1.3.0] - 2026-03-11

Added

• Added host-side dance revive system:
  • Players can revive a downed/dead teammate by dancing near them.
  • Default settings: 5m range, 3s required dancing time.
• Added dance revive configuration options:
  • Enable Dance Revive
  • Dance Revive Distance
  • Dance Revive Duration (Seconds)
• Added bilingual config and notification support (ZhCn / EnUs).
• Added revive-all position mode:
  • HostPosition (default)
  • OriginalPosition

Changed

• Optimized dance detection logic using emote flow:
  • Hooked CharacterAnimations.RPCA_PlayRemove to record emote names.
  • Use known dance emote names (A_Scout_Emote_Dance1, A_Scout_Emote_Dance2) and emote-state checks.
• Updated README and manifest metadata to match actual gameplay behavior.

Fixed

• Fixed single-host/solo testing scenario by supporting optional host inclusion in revive-all.
• Fixed outdated package description (removed old campfire auto-respawn wording).

[1.2.0] - 2026-03-09

Added

• Added host-only hold-to-revive teammate feature.
• Added host revive-all hotkey.
• Added ModConfig dependency and in-game configurable options.