← Back
OedoSoldier

OedoSoldier/Endfield-Poser

View on GitHub ↗
Stars
119
Forks
15
Watchers
119
Open issues
0
Contributors
6
Language
C++
License
GNU Affero General Public License v3.0
Default branch
master
Created Sep 24, 2026Updated Oct 1, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

Endfield Poser

《明日方舟:终末地》的摄影摆姿与 MMD 播放工具。可调整角色姿态、保存姿态、播放动作与表情,并搭配音乐和镜头使用。播放 MMD 无需 Blender。

当前预发布版:0.5.2 Hotfix。修正 MMD 播放时拇指张开过大、弯曲方向异常的问题,统一 37 个角色的拇指手型与动作参考。保留 0.5.0 的动作校准、关节 XYZ 偏移、滑条数值输入及界面缩放功能。

下载安装包 · 快速教程 · MMD 播放指南 · 问题反馈

安装、更新与卸载

需要 Windows x64。

  1. 下载 Endfield-Poser-v0.5.2-win64.zip 安装包。
  2. 完全退出游戏,将安装包完整解压到游戏目录之外的文件夹。
  3. 双击 安全安装.bat,选择能直接看到 Endfield.exe 和 GameAssembly.dll 的游戏目录,再选择 安装或更新。
  4. 启动游戏,阅读并确认使用协议。进入角色场景后按 L 打开面板,需要光标时按住 Alt。

更新时下载并解压新版安装包,运行新版包内的向导;它不会自动下载更新。无需先卸载,向导会备份原文件并保留配置和姿态。卸载时退出游戏,运行同一向导并选择 卸载;用户数据和备份保留。建议使用窗口化或无边框模式,可按原有方式从鹰角启动器、EFMI 或游戏程序启动。

从 0.4.91 或更早版本升级,会备份旧身体/手指校准,播放时重新自动校准。0.4.92 及之后生成的校准、表情校准与姿态库保留。

开始使用

想做什么 操作
手工摆姿 按 P 冻结,选择骨骼并调整,在姿态库保存
播放动作 勾选 MMD 播放器,打开 VMD 后播放,自动适配当前角色
手动适配动作 动作 → 动作校准… 调整四肢伸展、手脚落点、关节比例及 XYZ 角度偏移;多人可按第 1–4 位独立设置、保存预设,无需源 PMX
小队同步播放 在独立的 MMD 多人播放器 按第 1–4 位分配动作,支持一键共用动作,以当前操控角色的起点为共同原点
手动调整表情 在 表情 面板切换 MMD 模式,冻结角色后调节中文滑条
控制眼睛朝向 在 表情 → 眼睛朝向 调整方向,或开启 MMD 播放时锁定摄像机
坡面和台阶播放 开启播放器的 地形跟随,按需调整贴地强度
调整动作中的表情 在播放器 表情 → 角色表情与强度 中选择映射和强度
配合音乐、镜头 在播放器 镜头与音乐 页选择文件和调整构图
调整衣物物理 在播放器 动作 → 衣物物理 开关碰撞增强;飘带抖动时可在停止后调整 飘带减振
隐藏面板拍摄 按 L;动作和音乐继续播放

播放快捷键、窗口拖动和姿态保存见快速教程。动作幅度、IK、衣物物理和特殊骨骼适配见MMD 播放指南。需要在 Blender 中摆姿时,可使用可选桥接插件。

当前版本使用角色专属表情校准,替代旧通用模板;缺失时可选择固定映射,并支持各部位独立强度。安装包附带 37 份角色表情校准,安装时自动复制,更新时保留用户修改过的校准和个人设置。

多人衣物增强独立默认开启,准标准骨补全默认全开;已有适配预设保留原选择。拇指 PMX 校准开关位于 高级 → 角色校准,单人、多人共用。详见 0.5.2 Hotfix 更新说明。

常见问题

问题 处理方法
面板过小或过大 在主面板 界面缩放 调整手动倍率,默认按 1080p 基准自动适配分辨率
更新提示游戏仍在运行 完全退出游戏;若窗口已关闭,在任务管理器确认 Endfield.exe 已退出后重试
面板无法点击或拖动 按住 Alt;取消 锁定窗口,或点击 重排窗口
换人后不能播放 播放器会等待新角色和衣物就绪;若持续提示恢复中,可先停止并关闭衣物增强重试
播放时不能手动摆姿 先点 停止并恢复;暂停时仍由播放器控制
腿部僵硬、动作夸张 手动对照 IK 开关,调整动作幅度;见适配方法
衣服或脚底穿模 调整衣物物理与高度,效果取决于角色和动作
安装包没有 assets/cloth 衣物资源已内嵌 DLL,无需另行复制;源码包保留此目录

遇到异常时先确认版本,再提供复现步骤和 plugin/poser_log.txt 中的相关片段。发送日志前请移除个人路径等信息。

数据保存位置

以下路径均相对于游戏目录:

内容 路径
设置、快捷键 / 窗口布局 plugin/poser_config.txt / plugin/poser_layout.ini
姿态库 plugin/poses/
角色表情校准 plugin/mmd/character-faces/
身体校准、表情设置、适配预设 plugin/mmd/
动作校准预设 plugin/mmd/motion-presets/
角色与镜头构图预设 plugin/mmd/camera-settings.json
逐角色眼神校正与限位 plugin/mmd/eye-gaze.json
安装备份 plugin/poser-backups/

从源码构建

安装 Visual Studio 或 Build Tools 的 MSVC x64 C++ 工具和 Windows SDK,运行 build.bat,成功后运行 安全安装.bat。普通用户直接下载安装包即可。

XXMI 联动仅供单独构建:运行 build.bat -EnableXxmiBridge,产物输出到 build/xxmi/plugin/。默认构建和 Release 包不包含联动;见单独构建与使用。

需要制作安装包时,构建后运行 powershell -NoProfile -ExecutionPolicy Bypass -File tools/package.ps1。ZIP 输出到 dist/,自动包含内置表情校准、安装向导和使用说明。

免责声明

本项目为非官方工具,与鹰角网络无隶属、合作或授权关系。使用可能带来账号受限、崩溃或数据损坏等风险,不保证兼容性、稳定性或账号安全。

不得使用本工具制作、修改、播放、发布或传播违反鹰角官方创作限制的产物。用户自行承担使用及相关创作、传播的一切后果;在适用法律允许的最大范围内,作者、维护者及贡献者不承担相应责任,依法不得免责的情形除外。 使用前请阅读用户协议与免责声明,并确认所用动作、模型参考、镜头和音乐的授权。

项目与许可

MMD 表情参考自茶叶味香皂制作的《明日方舟:终末地》MMD 模型,感谢其模型制作与分享。模型及游戏资产的权利归各自权利人所有,使用相关素材请遵守原作者的使用规则。

本仓库是 honxi1/Endfield-Poser 的功能分支,按 AGPL-3.0 提供。依赖许可证保存在 licenses 中。

本分支问题请提交 Issues。上游交流群:终末地影棚爱好者(1126684901);上游联系邮箱:king_time@foxmail.com。