the mount of WuChang

步云鹿 · 独立坐骑 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 或游戏存档。

2. 将压缩包中的 Project_Plague 文件夹合并复制到游戏根目录（已有 Project_Plague 的目录）。

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 中 的相关记录。

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

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.

• 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: