HostReviveMod

By sakurakite Version: 1.5.2

简介 / 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.
• 跳舞复活 / Dance revive: 玩家在倒地队友附近跳舞达到时长后可复活队友（默认 5 米、3 秒）。/ Players can revive nearby downed teammates by dancing near them for a duration (default 5m, 3s).
• 复活位置可选 / Revive position mode: 全体复活可选“原地复活 / 房主位置复活 / 存档点复活”。/ Revive-all supports original position / host position / checkpoint 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).
• 跳舞复活：在倒地队友附近使用游戏表情轮盘中的跳舞动作，持续达到设定时长后复活目标（默认 5 米、3 秒）。/ Dance revive: use a dance emote near a downed teammate to revive after the configured duration (default 5m, 3s).
• 全体复活位置模式：OriginalPosition（原地）/ HostPosition（房主位置，默认）/ CheckpointPosition（存档点）。/ Revive-all position mode: OriginalPosition / HostPosition (default) / CheckpointPosition.
• 可选“全体复活包含房主”（便于单人测试）。/ Optional “include host in revive-all” (useful for solo testing).
• 可开关“启用跳舞复活”。/ Toggleable “Enable Dance Revive” option.
• 可开关“跳舞即刻复活”（检测到附近跳舞就立即复活）。/ Optional “Instant Dance Revive” mode.
• 可分别设置“房主复活惩罚”和“跳舞复活惩罚”（原版饥饿+诅咒）。/ Separate toggles for vanilla penalty on host revive and dance revive (hunger + curse).
• 显示复活进度条（长按与跳舞）并可尝试广播进度提示到游戏消息。/ Shows revive progress bars and can broadcast progress messages through game chat/UI.
• 复活提示：你复活了谁、谁复活了你、房主复活了所有人。/ 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.
• 房客不装本模组也可以通过游戏原生跳舞动作参与“跳舞复活”（由房主端判定并执行复活）。/ Clients without this mod can still participate in dance-revive using vanilla dance emotes (host performs validation and revive).

安装 / 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 (OriginalPosition / HostPosition / CheckpointPosition)
• 复活 / Revive -> 房主复活使用原版惩罚 / Host Revive Uses Vanilla Penalty
• 复活 / Revive -> 启用跳舞复活 / Enable Dance Revive
• 复活 / Revive -> 跳舞复活距离 / Dance Revive Distance
• 复活 / Revive -> 跳舞复活时长秒数 / Dance Revive Duration (Seconds)
• 复活 / Revive -> 跳舞判定持续秒数 / Dance Active Window (Seconds)
• 复活 / Revive -> 跳舞即刻复活 / Instant Dance Revive
• 复活 / Revive -> 跳舞复活使用原版惩罚 / Dance Revive Uses Vanilla Penalty
• 界面 / UI -> 启用复活提示 / Enable Notifications
• 界面 / UI -> 显示复活进度条 / Show Revive Progress Bar
• 界面 / UI -> 广播复活进度提示 / Broadcast Revive Progress Message

问题反馈 / Issue Reporting

• 如果你遇到 BUG 或有功能建议，请在这里反馈：
• If you encounter bugs or have feature suggestions, please report them here https://github.com/naizaniao/HostReviveMod/issues

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.