← Back
honxi1

honxi1/Endfield-Poser

View on GitHub ↗
Stars
43
Forks
9
Watchers
43
Open issues
0
Contributors
3
Language
C++
License
GNU Affero General Public License v3.0
Default branch
main
Created Sep 25, 2026Updated Sep 30, 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

《明日方舟：终末地》的游戏内摆姿插件：把角色冻结在当前姿态，用 3D 旋转盘和参数面板直接摆姿势， 保存 / 载入姿态预设，也可播放 MMD 动作、表情、音乐和镜头。

⚠️ 非官方第三方工具，与游戏厂商无关。使用前请先读文末的用户协议与免责声明。

  • 下载：Releases · latest （项目自 2026-09 起在本仓库维护，版本号沿用；旧链接失效时以这里为准）
  • 使用须知（先看这个）：docs/notice.md —— 安装、首次弹窗、热键、文件位置、卸载
  • 图文教程：docs/tutorial.md　功能与后续计划：docs/roadmap.md
  • 许可：整体按 AGPL-3.0 发布（LICENSE）；第三方来源与依赖见 THIRD_PARTY_NOTICES

快速开始

⚠️ 本仓库是源码，不是安装包。GitHub 页面上 "Source code" 下载的是未编译的代码， 里面没有 DLL、也没有安装脚本。安装请在 Releases 下载 EndfieldPoser-v*.zip。

包内文件 放到
d3dcompiler_47.dll 游戏根目录（先备份游戏自带的那份）
vulkan-1.dll 游戏根目录（同样先备份）
plugin\poser.dll 游戏根目录的 plugin\
plugin\poser_config.txt 游戏根目录的 plugin\
plugin\mmd\character-faces\ 游戏根目录的同名目录（角色表情校准）

📁 是 plugin\（单数，插件目录），不是游戏自带的 plugins\（复数，Qt 插件目录）。 没有这个文件夹就自己新建一个。

ℹ️ 两个代理一起放（安全安装.bat 会自动备份并复制它们）：DX11 走 d3dcompiler_47.dll、 Vulkan 走 vulkan-1.dll，同时放着互不影响。

  1. 解压 → 双击包内 安全安装.bat（或按上面的表手动放置）；
  2. 用官方启动器进入游戏（官方包使用 DComp 覆盖层，不针对第三方渲染注入环境做兼容），游戏用「窗口化 / 无边框全屏」；
  3. 第一次进游戏会弹【用户协议与免责声明】：读完 → 点「同意并继续」；
  4. 按 L 呼出面板，P 冻结 / 解冻；面板点不到就按住 Alt 呼出游戏光标再点。

热键可在面板顶部「快捷键（可改）」里改（自动写回配置，Esc 取消）； 更新前完全退出游戏，再运行新版安装包中的向导。它会备份文件，保留配置、姿态和自定义校准。

完整说明见使用须知，从安装到出片的流程见图文教程。

功能一览

  • 角色冻结：关闭角色动画并抑制其它写骨骼的系统，每帧维持当前姿态；从骨可跟随冻结或保持演算。
  • 摆姿编辑：3D 点选骨骼 + 旋转盘拖动；旋转 / 位置支持滑条、数值输入、± 步进与复位。
  • 从骨控制：头发、裙子、飘带等从骨可单独编辑，编辑结果会同步进冻结基线。
  • 姿态预设：命名保存 / 覆盖 / 载入 / 删除（含从骨数据）；保存位置可配置。
  • 表情：面部 BlendShape + 游戏原生 SMC 表情，以"中性默认脸"为基准；冻结时保持当前表情。
  • MMD 表情模式：按眉毛、眼睛、嘴部和其他分类调节，支持搜索、叠加、整体强度和分组归零。内置角色专属映射，缺失时可选固定映射。用法见教程。
  • MMD 播放器：VMD 动作、表情与眼神，支持逐帧、变速、循环、原地播放、音乐同步和镜头偏移。可选 PMX 骨架参考、手动 IK 与分部位幅度。播放指南。
  • 小队 MMD：最多四人按小队顺序分配动作，也可一键共用动作；共用进度、音乐与镜头，各自保存站位和表情。
  • 自动适配与地形：优先读取角色骨架，无需手动 T 姿；可选坡面、台阶贴地与镜头高度跟随。
  • 手部适配：修正手臂扭转分配与拇指基准，单人和多人播放自动应用。
  • 眼睛朝向：手动调整或按强度锁定摄像机；使用逐角色基准与四向限位，减少方向偏差和过度转动。
  • 衣物补骨与碰撞增强：自动匹配支持的服装，补充可动骨骼与蒙皮，并提供地面碰撞和飘带减振；不匹配时保留原有物理。开关与限制见衣物物理。
  • 多角色：冻结状态按角色记忆，切回冻过的角色会恢复离开时的姿势。
  • WebUI：插件启动后监听 http://127.0.0.1:18923，可在浏览器里辅助操作。
  • 实验性：IK 控制器（默认关，面板里可勾；骨骼跟随尚未完成）。

各功能的细节与后续计划见 docs/roadmap.md。

配置（plugin\poser_config.txt）

gui_toggle_key=L          # 支持 L / CTRL+L / INSERT / 0x2D 这类写法
freeze_key=P              # 冻结 / 解冻（播放中先停止）
mmd_play_key=CTRL+F5
mmd_pause_key=CTRL+F6
mmd_stop_key=CTRL+F7
mmd_reset_key=CTRL+F8
click_through=1           # 1=覆盖层常驻并真穿透（推荐）；0=按住 Alt 才显示面板
ik_enabled=0              # 实验性的 IK 控制器（0=关；面板里也可以勾）
default_pose_dir=plugin\poses

default_pose_dir 支持绝对路径，或相对游戏根目录的路径；面板底部会显示当前保存位置。 默认构建仅使用 DComp 覆盖层；旧配置里残留的 overlay_mode、overlay_fps 会被忽略。

构建

Windows（插件本体，MSVC）

# 安装 MSVC x64 与 Windows SDK 后：
powershell -ExecutionPolicy Bypass -File tools\build_msvc.ps1 -RunTests
# 无系统 SDK 时，可先运行 tools\setup_winsdk.ps1

# 有 cmake + VS 工具链时：
build.bat

两种方式产物都落在 plugin/：poser.dll（插件）、d3dcompiler_47.dll、vulkan-1.dll（代理）。 发布包用 tools\package_release.ps1 -Version x.y.z 组装（会校验 DLL 是否编入layered-window overlay，并做署名检查）。

Linux / 沙箱（数学层单测）

cmake -S . -B build && cmake --build build && ctest --test-dir build

测试覆盖 math/ 层（test_quat / test_ik / test_pose_file）；插件本体只能在 Windows + 游戏内验证。

目录结构

endfield-poser/
├── CMakeLists.txt        # Windows: 插件 DLL + 代理 DLL；tests: 数学单测
├── build.bat             # 有 cmake 时的一键构建（否则回退 build_msvc.ps1）
├── deps/                 # 随源码提供的依赖，许可见 THIRD_PARTY_NOTICES
├── packaging/            # 发布包里的安装说明与默认配置模板
├── tools/                # build_msvc.ps1、package_release.ps1、setup_winsdk.ps1 等
├── src/
│   ├── poser.cpp         # DLL 入口 + 插件宿主协议 + 每帧调度 + 主面板
│   ├── config.h          # poser_config.txt 读写、热键解析
│   ├── core/             # base / il2cpp_api / game_hooks / gui_overlay / web_server / 代理 DLL
│   ├── math/             # quat_math / ik_two_bone / pose_file（纯 C++，可单测）
│   ├── game/             # skeleton / accessory / freeze / cloth / morph / smc_morph
│   └── editor/           # selection / rig_gizmo / panel_*（含实验性 IK 控制器）
├── tests/                # math 层单测（g++ 亦可跑）
└── docs/                 # notice.md（使用须知）、tutorial.md（教程）、roadmap.md（功能与计划）

已知问题

  • 表情不能跨角色通用：面部由 SMC（骨骼变形）驱动，表情权重不写入姿态文件——保存的姿态只含骨骼与 从骨，换角色要重新调表情；强行套用别的角色面部骨会得到错位 / 夸张的脸（面板默认勾选 「不保存 / 不套用表情」，旧文件里带这类数据时载入也会跳过）。
  • MMD 表情参考自茶叶味香皂的模型。材质、贴图等特殊效果不支持，替换模型可能无法使用原角色校准。
  • 第三方渲染注入环境不在支持范围：官方包只走 DComp 覆盖层，装了这类 mod 的环境可能出现黑屏、 面板呼不出或卡顿；请用官方启动器进入游戏。
  • 冻结后骨架有轻微颤抖（老机制遗留：逐帧钉姿势会和游戏侧仍在写的系统轻微打架）。不影响摆姿与保存。
  • IK 控制器是实验性功能、默认关闭：面板里勾 IK 控制器（实验性）（或 ik_enabled=1）才出现。 目前可以选中 / 拖动手柄，骨骼跟随尚未完成。
  • 撤销 / 重做、骨骼层级树、骨骼镜像、外置姿态导出未包含在本版。

交流 / 反馈

非官方粉丝项目与交流群，与 Hypergryph 无关。

  • QQ 群：终末地影棚爱好者（群号 1126684901）
  • 邮箱：king_time@foxmail.com（版权 / 内容下架等问题优先发邮件）
  • 扫码入群：

QQ 群

遇到问题欢迎带上 plugin\poser_log.txt 与复现步骤，在 issue 或群里反馈。

致谢

感谢以下贡献者：

  • White-NX —— XXMI / 3DMigoto 兼容的 layered-window overlay 实现；
  • Nordlicht S —— 安全安装 / 卸载脚本（备份、还原与路径校验）。

用户协议与免责声明

在下载、安装或使用本插件（Endfield Poser）之前，请先读完以下条款；继续使用即表示你已阅读、理解并同意全部条款。

首次启动时，同一份条款会以弹窗形式出现：需要把内容读到末尾、点「同意并继续」之后， 插件才会安装游戏侧 hook 并开始工作；未同意前不加载任何游戏相关功能。 同意之后，面板顶部的「用户协议」按钮可以随时回看（只读窗口）。

1. 开源许可与最终用户权利

  • 本仓库整体按 AGPL-3.0 发布（LICENSE）；src/core/ 含上游开源项目的衍生内容， 出处与第三方依赖见 THIRD_PARTY_NOTICES（含责任边界说明）。
  • 在不修改本插件的前提下，最终用户使用、复制与分发不受额外限制； 公开分发修改版需按 AGPL 提供完整源码，不可改为 MIT / 专有许可发布。

2. 反欺诈声明

  • 本项目在 GitHub 上免费开源。如果你是通过付费渠道获取的，请知悉你可以在 本仓库免费获取。
  • 请勿在任何平台售卖本插件本体、却不提供仓库地址与售后支持。

3. 内容合规与行为约束

  • 本项目是非官方第三方工具，与《明日方舟：终末地》的开发商 / 发行商（Hypergryph、鹰角网络） 没有任何隶属、合作或授权关系，也未获得其认可。
  • 本插件本身不包含任何游戏美术资产。游戏内置的官方动画、场景、模型等资产其版权完全隶属于 鹰角网络，并不适用 AGPL-3.0 协议。
  • 请仅在单人 / 摄影模式下使用；不要在多人联机、竞技或任何会影响他人游戏体验的场景使用。
  • 不得利用本插件或游戏内置的官方动画、场景、模型等资产，制作、播放或传播任何不合适的 动作 / 动画（包括但不限于色情、暴力、政治敏感等违反法律法规或引起社区不适的内容）。
  • 请勿使用本工具修改或传播任何付费内容与游戏资源（模型、贴图、音频等）； 姿态文件只应包含你自己摆出的骨骼数据。

4. 风险与免责声明

  • 本项目以学习、技术研究与交流为目的；作者不提供商业支持，也不对其商业使用负责 （许可条款以 LICENSE 的 AGPL-3.0 为准，该许可本身不限制商业使用）。
  • 本工具通过与游戏客户端同进程运行来提供面板与摆姿功能。这类使用方式可能违反游戏服务条款， 存在账号被限制或封禁的风险；请自行评估风险并承担全部后果，建议在测试账号上运行。
  • 作者不对使用本工具造成的任何损失负责（包括但不限于账号封禁、数据丢失、设备异常）。
  • 如相关权利人、游戏官方或平台认为本仓库 / 发布包中的任何内容不妥，请通过 king_time@foxmail.com（或 issue / 文末交流群）联系作者，收到通知后会第一时间处理（包括删除相关内容、停止分发）。
  • 如果你不接受以上任何一条，请立即停止使用并删除本工具：用包内 安全安装.bat 卸载 （选 2；它会还原备份、移除插件本体，但保留 plugin\ 里的姿态预设与配置）， 要彻底删除就连 plugin\ 文件夹一起删掉。