XBFR Title Screen Animation (UE4SS)

XBFR Title Screen Animation / XBFR 标题界面动作 — 1. 0. 0

Important / 重要： The screenshots use a separate optional character-appearance mod. This download contains only the title animation Lua script and README; the outfit/body shown in the images is NOT included. / 展示图使用了另一款可选外观 Mod。本下载只有标题动作 Lua 脚本与说明，不包含图中的衣着和体型。

English

What it does

On the Wuchang: Fallen Feathers title screen, XBFR loops XBFR_Loop_N_01 before input. Once the title input is accepted, XBFR_Transition_N_01 plays once (about 7. 8 seconds), followed by the XBFR_Loop_N_02 standing loop. The chair and foreground wooden board are hidden. This mod references assets already in the game. No game pak, model, animation, UE4SS binary or appearance replacement is bundled.

Requirements and installation

1. Install a working UE4SS for the PC game separately. Close the game before installing.

2. Extract the TitleXBFRTransitionMod folder into <game>/Project_Plague/Binaries/Win64/ue4ss/Mods/. The script must end at .../Mods/TitleXBFRTransitionMod/Scripts/main.lua.

3. Back up ue4ss/Mods/mods.txt, then add or enable: TitleXBFRTransitionMod : 1. Keep all other mod entries.

4. Disable older title-screen test pak files and other title-animation mods that could conflict. Restart the game.

5. Wait until the title scene and “点击任何按键” prompt are visible, then press a keyboard/controller button or click the mouse. The transition should play once, then the standing loop.

This animation download does not require a title pak or the separate Burgundy appearance pak.

Known issues

• Confirmed: clicking during the black startup screen or startup logo can start the transition before the title is visible. XBFR may already be standing when the title appears. Workaround: wait for the visible title prompt before input.

• An intermittent “Fatal world leaks detected” crash was seen in earlier testing. Cleanup logic was added, but repeated title → gameplay → title regression testing has not established that the crash is fully resolved.

• Mods changing Lobby_02, BP_WuChangeLobby or other title-screen behavior may conflict. A clean installation without the author's other mods has not been independently validated.

• The character's appearance may differ from these screenshots without the separate appearance mod.

Uninstall and troubleshooting

Disable the entry in Mods/mods.txt (TitleXBFRTransitionMod : 0), then remove only Mods/TitleXBFRTransitionMod if desired. For diagnostics, search ue4ss/UE4SS.log for . Redact usernames and local paths before sharing logs publicly.

中文说明

功能

在《明末：渊虚之羽》标题画面中，XBFR 在接受输入前循环 XBFR_Loop_N_01；接受标题按键后播放一次约 7. 8 秒的 XBFR_Transition_N_01；随后循环站立动作 XBFR_Loop_N_02。当前隐藏座椅和前景木板。本 Mod 调用游戏自带资源；不附带游戏 pak、模型、动画、UE4SS 程序或外观替换。

前置要求与安装

1. PC 版游戏需另行安装可正常运行的 UE4SS。安装前完整退出游戏。

2. 将 TitleXBFRTransitionMod 文件夹解压到 <游戏目录>/Project_Plague/Binaries/Win64/ue4ss/Mods/，确认脚本路径为 .../Mods/TitleXBFRTransitionMod/Scripts/main.lua。

3. 备份 ue4ss/Mods/mods.txt，新增或启用 TitleXBFRTransitionMod : 1，不要覆盖其他 Mod 条目。

4. 禁用旧标题界面测试 pak 及可能冲突的其他标题动作 Mod，重新启动游戏。

5. 等标题画面和“点击任何按键”提示真正出现后，再按键盘、手柄按键或点击鼠标。随后应播放起立过渡和站立循环。

单独使用标题动作不需要标题 pak，也不需要 Burgundy 外观 pak。

已知问题

• 已确认：黑屏或启动 Logo 阶段提前点击鼠标，可能使动画在标题可见前开始，进入标题时角色已站立。请等到标题提示出现后再输入。

• 早期测试中偶发“Fatal world leaks detected”崩溃。已加入清理逻辑，但尚未通过反复“标题 → 游戏 → 标题”回归测试确认彻底解决。

• 修改 Lobby_02、BP_WuChangeLobby 或其他标题流程的 Mod 可能冲突；尚未在完全不装作者其他 Mod 的纯净环境独立验证。

• 不安装独立外观 Mod 时，角色外观可能与展示图不同。

卸载与排错

在 Mods/mods.txt 中将条目改为 TitleXBFRTransitionMod : 0；如需彻底移除，只删除 Mods/TitleXBFRTransitionMod 文件夹。排错可在 ue4ss/UE4SS.log 搜索 。公开日志前请删除用户名、本地路径等隐私信息。

AI disclosure / AI 使用说明： The Lua code and page text were developed with AI assistance. / Lua 代码和页面文案在开发过程中使用了 AI 辅助。