Dr-hydra/Better-Endfield

简体中文 | English

Better Endfield Next 是面向《明日方舟：终末地》的开源模块化工具，提供第三方角色模型、MMD 播放、相机和界面增强、按角色配音、开屏自定义，以及 PC 战斗统计和寻访记录管理。Windows 和 Android 共用主要原生功能源码；BEM 模型包和 MMD 作品可以跨端使用。

下载正式版 · 更新说明 · Android 使用与构建 · BEM 创作者指南 · E Mod Loader

第三方模块与第一人称已迁移至独立项目 Endfield Mod Loader（E Mod Loader）。 EML 0.1.1-dev Windows 开发预览现已提供 Windows 加载器、Android APK 和独立第一人称模块。下载 EML 与第一人称模块 · 第一人称使用说明。Windows、Android 的创意工坊入口继续保留；BE 的通用 Host、内置模块加载及共享 Hook 链继续维护。游戏及 Android 设备效果尚未实机验证。

当前版本为 4.0.6，独立 BEM Tools 为 1.5.5。本版支持多启动器自动识别与免启动器直接拉起模式，同步安卓 1.6.4 四语种完整短语音运行时索引，并整合昼雪角色创作资料入完整包。详情见 4.0.6 更新记录。

Next 4.0.x 沿用现有安装身份。Next 使用新的安装身份、内部标识和发布签名，与 3.x 旧版独立。从 3.x 升级时，请先卸载旧版（Windows 同时卸载旧 XInput 代理），重新安装并设置；Android 需重新启用模块和游戏作用域。旧设置不迁移，BEM/MMD 文件可手动重新导入。Logo 保留。第一人称功能现由 E Mod Loader 独立模块 提供。实施与构建说明。

「支持」表示有对应实现和入口，不表示每个角色、作品、设备或游戏版本均经过实机验证。

Windows 提供中文/英文界面、明暗主题、运行状态和日志、游戏路径发现、启动参数、快捷方式、更新检查和 XInput 自启动管理。Android 提供自动保存的分类设置、包导入和游戏内可收起控制面板。

从 Releases 下载 Windows 安装包，启动 Better Endfield Next，检查游戏路径并开启需要的功能，然后保存并启动游戏。运行环境为 Windows 10/11 x64。

• 内置注入器：默认方式，由 Better Endfield Next 启动游戏，Host 和模块从软件目录加载，不把 Better Endfield Next 运行文件写入游戏目录。
• XInput 自启动：设置页可安装可选的 xinput1_4.dll 代理，此后从官方启动器或游戏快捷方式启动也能加载。安装与卸载核对归属记录；已有其他工具的同名文件时不会覆盖。

OptiScaler 是独立部署功能，会写入游戏目录并在下次启动时生效。游戏启动参数也会用于一键启动快捷方式。

Android 包是 LSPosed/libxposed API 102 模块，要求 Android 10 及以上、ARM64，以及能注入目标游戏的兼容框架；单独安装 APK 不会启用游戏功能。

安装后在框架中启用模块并选择实际使用的终末地客户端，在模块应用中设置功能，然后彻底停止并重启游戏。游戏内面板通过目标 Activity 显示，无需悬浮窗权限；相机、冻结和 MMD 使用面板控制。详细操作、作用域排查和构建要求见 Android README。

玩家使用 .bem 标准包即可，无需安装 Python、原 Mod 框架、角色数据库或编辑运行配置。一个包对应一个角色，支持固定外观、可组合部件和材质/纹理替换。同一角色可以安装多个包，启用其中一个时停用其他包；更新保留仍有效的外观和参数选择。

PC 和 Android 使用同一 BEM 解析与装配核心，支持 BEM 1.0–1.4；3.5.2 新增 BEM 1.4 资源目标与静态网格能力，可以声明 Windows/Android、LOD、资源路径与 donor 关系，覆盖武器和角色大招形态。旧包继续按 1.0–1.3 规则解析；运行时仍不会执行源 Mod 的热键脚本、GUI 表达式或任意 Shader。

常规选择在重启游戏后生效。实验热切换开启后，包、部件及 1.3 参数变化在切换配队、重新打开详情等正常资源重载时应用；没有每次拖动滑条立即更新当前网格的承诺。导入、更新包文件和删除仍建议在游戏关闭时进行。

游戏内模型悬浮窗支持角色筛选、关闭全部、每角色包互斥启用、外观、组件与形态参数，详细选项按需展开。Windows 默认按主键盘 = 显示或隐藏，无需 Shift，设置位于第三方模型页面；Android 使用悬浮窗左侧的模型入口。两者保存到原有模型库，不额外复制模型或贴图。

热切换与加载优化相互独立，默认关闭。热切换为重建缓存保留原始模型资源，会增加内存占用；加载优化减少的是解析副本及重复资源，不保证所有设备的游戏显存峰值都会下降。

Android 可对贴图异常的包执行「转换手机纹理」；转换成功发布新一代并保留选择，失败或取消保留原包。该操作需要已验证的法线编码信息，模型本身的跨端标准不代表桌面纹理在所有手机 GPU 上均可直接显示。

创作者工具包含独立 GUI、主程序内的“BEM 创作者工具…”入口和 CLI，支持目录、ZIP、RAR、7z 输入，转换报告、结构校验、可保存的 .bemproj.json 导出工程、标准工作区和重复构建。BEM Tools 1.5.4 支持 BEM 1.4，更新昼雪 1.6.3 创作资料，并保留 Blender/EFMI legacy 角色流水线边界；创作者必须显式声明资源目标、LOD、平台和 donor 证据，不会自动还原任意源 GUI 或猜测顶点对应关系。

BetterEndfieldNext.BemConverter.exe new-project editable/project.json --mode pack -o character.bemproj.json
BetterEndfieldNext.BemConverter.exe build character.bemproj.json

两端还提供默认关闭的「实验：关闭模型校验」。该选项放开兼容性和策略限制，仍要求文件能解码且能被当前表示方式读取；不增加新编码支持。用于作者测试时可能出现错误渲染或游戏崩溃。

• 创作者指南：工具、制作流程、导入测试、分发
• 格式规范（1.0–1.4）
• 运行时行为与兼容性
• 其他来源 Mod 转换
• 形态滑条可运行示例
• 实验热切换与加载优化说明

第三方原生模块、模块网页及第一人称功能由 E Mod Loader 提供。前往 EML Release 下载对应平台的加载器，再导入 example.first-person-0.1.0-dev.zip；Windows 默认按减号 - 切换，Android 可在模块配置中设置默认进入。原 BE format 1 / ABI 1 模块包可直接导入 EML，Next 接口不在兼容范围内。BEM 模型包、MMD 作品及双端创意工坊入口继续由 BE 支持。

自由相机支持位置/朝向、滚转和 FOV 调整、鼠标转向、环绕/推拉/升降/平移运镜，以及可保存的关键帧路径和 VMD 镜头。时间冻结独立于自由相机。快捷键可配置，Windows 支持主键盘、小键盘、鼠标和组合键；Android 用游戏内控制面板操作。

3.4.2 新增的全局 FOV 只覆盖普通主相机；自由相机和导入镜头使用自己的 FOV。人物跟随仅平移自由相机，保留镜头朝向与手动偏移，在切人和传送后重新建立参考，并在运镜播放时暂停。实现边界

Android 悬浮窗提供独立全局 FOV 开关与 5–150° 滑条，复用 App 设置并保存；已初始化相机可即时调整，未初始化的相机保留配置并在重启后生效。

MMD 作品库管理动作、表情、镜头和本地音乐，可通过 set.ini 描述作品；支持播放/暂停/停止、跳转、循环、游戏/自由/VMD 镜头切换，最多四名队员同台，以及衣物物理和实验地形贴合。Windows 音轨走本地音乐接口，不要求 OmniMix；Android 使用本地媒体播放，会与游戏 BGM 叠加，可在游戏设置中关闭原背景音乐。双端身体/表情、布料和地形能力依赖实际客户端接口，作品转换或编译通过不能代替实机效果验证。双端整合记录

开屏：替换登录演员，按角色资源选择坐姿链和最终动作，调整缩放、起始角度、转正时间、各阶段速度、原生/强制循环和双 Playable 混合；Logo 与登录色带可独立设置主题色。收录 33 名角色、4,262 条最终动作索引，3.4.2 补齐噗切娜资源。新角色资源修复

配音：在游戏全局语言不变的情况下分别指定角色中文、英语、日语或韩语，可扩展到剧情语音、时长和口型。先在游戏中下载对应语言包，软件从本机资源生成所需目录；发布包不携带 PCK、BNK 或 WEM 音频。语音路由说明

界面与动作：隐藏 UID、通过快捷键/面板切换 HUD；PC 触屏布局搭配鼠标转触控，适用于串流或触控设备，转换默认快捷键为 Ctrl+Alt+T。Android 可启用 PC 风格布局，建议搭配键盘或手柄。布局切换与账号平台声明独立。持续冲刺当前适配洁尔佩塔和梨诺，梨诺另有隐藏机甲与光效选项。动作模块

PC 战斗数据：手动会话和关卡自动会话，伤害数字显隐、悬浮伤害/DPS 排行、技能分类、角色与技能时间轴、历史筛选和网页分析。rDPS 使用随软件更新的已验证 Buff/技能语义，将可确认的队友增益贡献重新归属；无法确认的项不参与贡献转移。数据保存在本机，网页分析由用户主动打开。战斗契约

PC 寻访记录：启用后从游戏连接同步记录，按卡池展示统计、六星、UP/非 UP、保底和免费抽信息，支持 JSON 导入导出及用户主动发起的云端分享。网页功能说明

PC 音乐与显示：OmniMix 集成使用用户现有后端，不复制其程序或曲库；可分别替换登录、主界面/基地、游戏内音乐，流异常时保留或恢复原生音乐。OptiScaler 负责超分、帧生成和锐化，硬件/后端兼容性依实际环境。OmniMix 对接 · 显示管线

Windows 的 Host 加载独立功能 DLL；Android 的游戏内运行时编译共用模块源码并提供平台适配。Host 负责模块发现、生命周期、配置、动态 IL2CPP 解析和 Hook 管理。内置功能按程序集、类型、方法、签名和字段描述解析运行时接口，不依赖一套官服固定地址或 GameAssembly.dll 身份白名单。

这允许不同客户端共用代码，但不保证任意游戏版本自动兼容：方法签名、资源、渲染布局或设备接口变化仍可能要求更新。内置模块的契约缺失会禁用对应能力并记录日志。Android 应将作用域选到实际客户端；世界、详情和开屏以及 PC/手机资源布局也不能互相假定相同。

Windows 主配置位于 %LocalAppData%\BetterEndfieldNext\BetterEndfieldNext.ini，UI 设置为同目录的 ui-settings.json，BEM 包与状态位于 catalog\custom-model。Android 设置通过框架发布，资源复制到游戏自己的私有目录。角色/语音索引随软件分发，原游戏资源按需要从本机读取，不随仓库或安装包分发。

内部运行时协议见 GAME_INTERFACES.md。研究目录和历史记录不代表全部已发布功能。

Windows 需要 Visual Studio 2022 C++ 工具集、CMake、.NET SDK 9 和 PowerShell；构建安装程序另需 Inno Setup 6。BEM 工具构建依赖见 requirements-build.txt。

pwsh -File .\scripts\BuildBetterEndfieldNext.ps1
pwsh -File .\scripts\BuildInstaller.ps1
pwsh -File .\scripts\BuildBemTools.ps1

Android 使用 JDK 17 及以上、SDK、NDK 和 CMake，版本以 android/app/build.gradle.kts 为准；配置好工具链后：

.\android\gradlew.bat -p android :app:assembleRelease --no-daemon

构建脚本使用仓库内已生成的资源索引；游戏更新后需先更新相应资料，不应把本机研究输出或游戏资源载荷打入发布包。

Better Endfield Next 使用 AGPL-3.0-only，是独立的非官方项目，与游戏开发商及发行商无关联。MinHook、Dobby、EIEM、7-Zip 等依赖或引用保留各自许可证和来源说明；创作者应自行确认第三方模型、动作、音频和模块的分发授权。

功能效果取决于客户端、设备和用户导入内容。使用前请了解相关服务规则及账号/客户端风险；游戏更新后遇到契约失败，应关闭受影响功能并等待适配。