武昌之山

步云鹿 · 独立坐骑 Mod v0.4.0（L3+A 切换版）

介绍

为《明末：渊虚之羽》添加可召唤和骑乘的步云鹿。使用主角原生移动与碰撞，配合坐骑行走、奔跑动画、骑姿和骑乘镜头，方便探索地图。 本版为独立坐骑，不需要宠物、化身或其他自制 Mod。

操作

• 键盘 H：召唤并骑乘；骑乘中再次按 H 收起。
• 手柄 L3+A：召唤并骑乘；骑乘中再次按相同组合收起。
• Shift+H：紧急收起并尝试恢复主角状态，同时取消自动恢复骑乘。
• 骑乘时按住 L3 并向前推摇杆：加速。
• 手柄使用 Xbox 按键命名，L3 指按下左摇杆。L3+B 不再用于收起坐骑。

主要功能

• 原生奔跑速度的 1.3 倍骑乘速度；手柄加速时再乘 1.3，合计约 1.69 倍。
• 骑乘时默认减免 70% 的普通受击伤害，不代表无敌，也不保证减免坠落或其他特殊伤害。
• 自动切换骑姿、移动动画及镜头，退出时恢复相关输入、速度与外观。
• 记住主动选择的骑乘状态；重启、死亡、换图或传送后，在角色和地面条件允许时尝试恢复骑乘。
• 主动收起或紧急恢复会取消上述自动恢复；初始化故障会停止重复尝试，可按 H 重试。
• 纯骑乘功能，没有主动冲撞或接触伤害，不提供飞行和穿墙。

前置要求

PC 版游戏，以及已正确安装并支持 LoopInGameThreadWithDelay 的 UE4SS。 本包不包含 UE4SS、其他 Mod 或游戏存档。

安装

1. 完整退出游戏。
2. 将压缩包中的 Project_Plague 文件夹合并复制到游戏根目录（已有 Project_Plague 的目录）。
3. 确认存在： Project_Plague\Binaries\Win64\ue4ss\Mods\BuyunDeer\Scripts\main.lua Project_Plague\Content\Paks~mods\BuyunDeer_P.pak
4. 保留 BuyunDeer\enabled.txt。若 mods.txt 明确将 BuyunDeer 禁用，请改为 1。
5. 重启游戏，进入存档，在安全、开阔的地面上按 H 或 L3+A 测试。

脚本与 PAK 都必须安装。旧版用户先备份原 BuyunDeer 文件夹再覆盖，不要同时加载改名副本。 本包未携带作者本机 ride-state.ini、备份或指令文件，新安装默认不自动骑乘。运行后会在 Mod 文件夹生成自己的骑乘偏好文件。

配置

退出游戏后编辑 BuyunDeer\Scripts\BuyunConfig.lua： Scale = 0.28：坐骑模型缩放。 SpeedMultiplier = 1.3：普通骑乘速度倍率。 SprintMultiplier = 1.3：额外加速倍率。 MountedDamageReduction = 0.70：普通受击减伤比例。 CameraDistance = 600：骑乘镜头距离，厘米。 CameraHeight = 80：骑乘镜头高度参数，厘米。 Debug = false：调试日志默认关闭。 修改后完整重启游戏生效。

兼容与卸载

请避免其他 Mod 同时占用 H、Shift+H 或 L3+A。影响移动、角色外观、镜头或输入映射的 Mod 可能发生冲突。 退出游戏后移走 BuyunDeer 文件夹及 BuyunDeer_P.pak 即可卸载。

验证与反馈

本包保留当前安装的坐骑逻辑和 L3+A 召唤/收起修改。已检查 Lua 语法、独立模块依赖、文件一致性与 ZIP 完整性；未重新完成全场景实机测试。 若遇问题，请记录所在场景、操作步骤，并提供 UE4SS.log 中 [BuyunDeer] 的相关记录。

========================================

Buyun Deer — Standalone Mount Mod v0.4.0 (L3+A Toggle Edition)

Description

Adds a summonable, rideable deer to WUCHANG: Fallen Feathers, with walking and running animations, a rider pose, and a mounted camera. Uses the player's native movement and collision for map exploration. This is a standalone mount; no pet, avatar-transformation, or other custom mod is required.

Controls

• H: summon and mount; press again while riding to dismiss.
• L3+A: summon and mount; press the same combination again while riding to dismiss.
• Shift+H: emergency dismissal and attempted player-state restoration; also cancels automatic remounting.
• While riding, hold L3 and push the left stick forward to accelerate.
• Xbox button names are used. L3 means clicking the left stick. L3+B is no longer used to dismiss the mount.

Main Features

• Normal riding speed is 1.3 times the game's native running speed. Controller acceleration adds another 1.3 multiplier, for approximately 1.69 times the baseline.
• Defaults to 70% damage reduction for ordinary incoming hits while mounted. This is not invulnerability and does not guarantee protection against falls or other special damage.
• Mounted pose, movement animations, and camera adjustments, with related input, speed, and appearance restoration on dismount.
• Remembers your riding preference and attempts to remount after restarting, death, map changes, or teleportation once the player and terrain are ready.
• Manual dismissal or emergency restoration cancels automatic remounting. Initialization faults suspend repeated attempts; press H to retry.
• Traversal only: no active charge attack, contact damage, flight, or wall clipping.

Requirements

The PC game and a working UE4SS installation supporting LoopInGameThreadWithDelay. UE4SS, other mods, and save files are not included.

Installation

1. Fully close the game.
2. Merge the archive's Project_Plague folder into the game root directory, which already contains Project_Plague.
3. Confirm both paths exist: Project_Plague\Binaries\Win64\ue4ss\Mods\BuyunDeer\Scripts\main.lua Project_Plague\Content\Paks~mods\BuyunDeer_P.pak
4. Keep BuyunDeer\enabled.txt. If mods.txt explicitly disables BuyunDeer, change that entry to 1.
5. Restart, load your save, and test H or L3+A on safe, open ground.

Both scripts and the PAK are required. Back up older installations before replacing them; do not load renamed duplicate copies. The author's ride-state.ini, backups, and command files are excluded. A fresh installation does not automatically mount. Your own riding preference file is created in the mod folder during use.

Configuration

With the game closed, edit BuyunDeer\Scripts\BuyunConfig.lua: Scale = 0.28: mount model scale. SpeedMultiplier = 1.3: normal riding speed multiplier. SprintMultiplier = 1.3: additional acceleration multiplier. MountedDamageReduction = 0.70: ordinary incoming-hit damage reduction. CameraDistance = 600: mounted camera distance in centimeters. CameraHeight = 80: mounted camera height parameter in centimeters. Debug = false: diagnostic logging is off by default. Restart the game after changing settings.

Compatibility and Uninstallation

Avoid conflicting bindings for H, Shift+H, and L3+A. Mods affecting movement, appearance, camera behavior, or input mappings may conflict. To uninstall, close the game and remove the BuyunDeer folder and BuyunDeer_P.pak.

Validation and Support

This package preserves the currently installed mount logic and the L3+A summon/dismiss change. Lua syntax, standalone module dependencies, file consistency, and ZIP integrity were checked. Comprehensive in-game testing has not been repeated for this share package. For support, describe your location and actions and include the [BuyunDeer] entries from UE4SS.log.