HS2_VMDPlayPlugin 0.3.4

fudyou

HoneySelect2 VMD Play Plugin （HS2VMDPlayPlugin） （v0.3.4） 播放

/ f3 F$ ]9 R& @
  c) Z: Z# ?/ i% G# W* fMikuMikuDance 运动数据 （.vmd）。
6 @0 E3 l' H! U: L( }7 ^% x并非所有动漫都可以工作，因为骨骼结构和 IK 机制非常不同。
# _+ M& g) ^- Q  q5 r" B
& Y& T7 Z: R2 z: R+ p它仅适用于 StudioNEOV2。

9 U' a& ~9 ~( s& M& G3 l$ g1. 按 “Ctrl” + “Shift” + “V” 切换 GUI 显示（您可以在 BepInEx/config/HS2_VMDPlayPlugin.cfg 文件中更改键）。
* ]4 k4 O7 K  `1 d2 k2. 使用“<”和“>”按钮选择一个角色。
1 w' S/ y* p5 _% M3. 按下“关闭”按钮（它将切换到“打开”）以激活该功能。
- 现有的动漫将被停止。
3 {) g& R: z* k# v- v4 H4. 直接在 VMD 旁边键入文件名，或单击“...” 单击该按钮以选择一个文件。
4 r- \* j0 G6 h6 w如果文件路径包含 “;” 或使用“+”按钮合并来自多个 VMD 文件的动作。
5. （可选）如果有音频，请在 Sound 旁边键入文件名，或按“Load”（加载）按钮加载文件。
; V$ l7 |) s1 y( c' p+ L6. 按下 VMD 上的“加载”按钮以加载 VMD 文件（以及声音文件，如果指定）。 ）
3 S6 T2 u" B" ?7. （可选）如果摄像机运动位于单独的 VMD 文件中，请打开 Camera 选项卡，指定 VMD 文件，然后选择 Load （加载） 以导入它。
  ?3 N( T* t# z8. （可选）如果要指定循环音频等参数，请打开声音选项卡并更改设置。
+ r. F  C: f# V) G: p% R& }' y. d9. 按播放（全部）按钮播放动漫、相机和音频。
10. （可选）更改屏幕底部的控制器选项。
5 G) H' N) w* W3 e( d
如果要将动漫与多个角色同步，请使用 （All Chara） 右侧的 Play/Pause/Stop 按钮。
) y) e& I1 U/ p3 {
5 k; @0 x! v& e1 ]
; P; u6 l4 E& e( V根据 BepInEx/plugins/HS2_VMDPlayPlugin/FaceData.txt 中包含的人脸设置，捕获
& _; P1 F1 [: |: k.vmd 文件中的面部表情操作参数，以进行面部表情操作。
请参阅自定义面部表情。

6 L, c5 a0 y5 x4 F5 w4 `' I
先决条件：
已安装 BepInEx v5.3 （https://github.com/BepInEx/BepInEx）。
4 |. f4 D! e7 R) k( H0 ~+ n0 H如果要写入场景数据，则需要 BepisPlugins 中包含的 ExtensibleSaveFormat 插件。


) Y( C" [# {8 y/ E% d+ g[部署]
将 BepInEx 文件夹复制到 HoneySelect2 部署目录。
文件夹结构应如下所示：

6 v' E% g6 U7 v# M- i# C: q8 u（HoneySelect2 介绍目录） /
StudioNEOV2_Data/
: |  \( G! a9 N- Y' a$ C% j...
...
5 H. v6 E+ G) S9 K$ ]8 q  ^BepInEx/
插件/
HS2_VMDPlayPlugin/
& X$ i; m2 ?9 P9 }5 yHS2_VMDPlayPlugin.dll
& w6 Q, k. `5 ?7 h! oMMD4URuntime.dll
2 X* a4 h3 l+ c/ C6 b" oFaceData_ sample.txt
) f4 F) _4 a0 h; yconfig/
! d. s5 r7 v  v+ ~# dHS2_VMDPlayPlugin.cfg
...。
HoneySelect2.exe
7 R" A/ U& B8 j+ L3 h$ {# L9 ]% |StudioNEOV2.exe
3 h; F+ X/ I* s: \' U. ?
3 M- r9 G% K; B* L0 `, u2 f

0 {$ S% C4 j- v% d1 g8 l6 L卸载 删除
4 C5 i% \: E- A+ P以下目录和文件：
BepInEx/plugins/HS2_VMDPlayPlugin 目录
BepInEx/config/HS2_VMDPlayPlugin.cfg 文件


/ ^( F5 s# ~! {( v  o/ t[自定义面部表情]
可以通过编辑 FaceData.txt 来添加和编辑面部变形。 日语 Morph 名称必须以 UTF-8 编码存储。

（语法）
8 k0 E9 h& G7 F5 @> < 完整 ：= <MORPH NAME> “=” <类型： 眉毛，眼睛，嘴>全部 “，” < 属性值> [“，” < 属性值> “，” <属性值> ....]

: |" e- I# u+ Y1 A4 g4 `< 属性值> ：=
" S& _3 P- _8 v$ w“eyebrow” “：” <眉纹编号> ： < 粗细 0-1.0> - 眉纹，如果指定了多个，则按粗细合并。
“eyeopen” “：” < 体重 0-1.0> - 眼睛张开度
“eye” “：” < 眼型数字> “：” < 体重 0-1.0> - 眼型
“张口” “：” < 体重 0-1.0> - 张口度
; }7 |( n2 }, t' a' N9 j, B& @1 @“mouth” “：” <口型编号> “：” < 体重 0-1.0> - 口型
“tongue” “：” “0” or “1” - 伸出舌头 （1） 不要 （0）
7 N5 t9 D2 _9 C$ l* C
（示例） wink=
EYE，eye：5：1
5 h) y; ^6 U- z0 {% G  T, r9 i( V' vmix=ALL，eyeopen：0.5，eye：12：0.4，eye：10：0.3，mouthopen：0.3，mouth：15：1，tongue：0
; w" A( R1 S5 b1 i* R
你可以指定 _DEFAULT_ 作为
特殊元素。 如果未在 VMD 端指定任何键，则此元素是默认表达式。
（如果 Model > UseDefaultFace 在设置中为 true）
7 }% }1 j6 I! w
写入场景
& _0 v2 H6 Y5 \3 {4 {; Y4 Z
将 VMD 设置信息写入和读取场景文件 （png）。
如果您不想编写它，请在 BepInEx/config/HS2_VMDPlayPlugin.cfg 文件中将以下行更改为 false。
# u( c4 P4 Y  z" \9 c8 S9 q0 {, A0 S; [
4 V7 l4 m1 S0 `  y; e[保存]
- m. l0 [% B( ?+ c% d9 c& LSaveInScene=true #これを 更改为


6 Q  ^; d& H& \: Z5 L! Afalse
[播放控制器]
Show Config / Close Config - 打开（关闭）参数调整配置屏幕。
: D9 u- w* Y; _播放/暂停/停止 - 立即播放/暂停/停止运动/音频/摄像机。
( q6 {) X+ N# ]* f+ n2 q自动隐藏 - 如果选中，则在参数调整配置屏幕未打开且鼠标光标未位于控制器位置（距屏幕底部 40 像素）时自动隐藏控制器。
关闭 - 关闭控制器和参数调整配置屏幕。
1 o4 I6 B" j: l2 S/ B& [
- g. ?7 m' j: m

, \* u2 C' n: q8 E9 `" T5 x' OTuning Parameters （优化参数） -
4 E" T: \4 K' I  ]5 S9 c' @9 m6 y& q模型的优化参数
CenterPos（y）：更改 centerbone 的 Y 位置。 （扩展后添加）
Model Scale（模型缩放）：所有移动骨骼的 x、y 和 z 坐标的缩放（与骨骼的参考位置不同）Move
5 [0 M" o4 Q) R. f9 V, S+ x7 |% q: t（y）Scale（移动（y）Scale）：所有移动骨骼的 y 坐标的缩放（在应用“模型缩放”（Model Scale）后添加）

! W# e; a  F0 j& @% }CenterBasePos：虚拟中心骨的 Y 位置（在 PMX 模型上假定的位置）
' g' [5 l* B: B4 ~9 X( V' T+ W2 SShoulder/UpperArm/LowerArm Tilt：肩部、上臂和手臂的初始倾斜度。 将 T 姿势与 A 姿势 （MMD） 对齐的调整值。

如果要使运动更具动态性，请增加 Model Scale。
" Z, r- O4 [  M+ j: }  I  Z$ w如果您的双腿因 IK 而伸展和颤抖，请减小模型比例。
+ n4 o3 z/ @7 C1 ]; r' G' u如果模型比例增加并且它被埋在地板下，请额外调整 CenterPos（y） 和 Model Scale（y）。

8 L5 S! ?! O1 [' h( ~2 O0 V在多个模型运动的情况下，最好对齐 Model Scale（模型比例）。
! L7 I' y: `. Q1 z
* n& N# y; V5 D3 W- X# G7 `[用于动作调整的参考模型输出]
VMD Load Config（需要重新加载）右侧显示“保存”（用于多个模型的位置调整
  c# L7 n! z, \: F/ f* P. q
8 y9 o, [, I0 U: }# A5 e1 G
） 使用 “PMX” 按钮输出。
按下此按钮将使模型返回到其初始姿势 （A-stance），并以 PMX 文件格式输出骨骼配置。
该文件在 BepInEx/plugins/HS2_VMDPlayPlugin/pmx/ 目录下输出时间戳。
! k2 }+ I* A) T5 H内容仅为骨骼。 它不包含任何网格、纹理、变形等。
7 m# }+ \0 Y8 t它旨在与 VMD 大小调整 （VMD_sizing） 工具一起使用。
' ~; e( S2 S. `# f0 Q$ ~% tShoulder Tilt 等值也使用设置的值。 但是，无论设置如何，模型比例都被视为 1.0。
因此，如果要使用输出模型的调整后的运动，请将 Model Scale 设置为 1.0 并使用它。
% Q6 F( R$ Q# _3 u. j/ P- P  U
对于 Base Scale （基础缩放） 和 Global Scale （全局缩放），请使用配置的值。
  ]3 W+ V6 o2 ~在默认的 BaseScale 0.095 和 Global Scale 10.0 的情况下，游戏中的 Y=10.0（大致是默认角色身体的中心）在 MMD 中大约是 Y=10.6。
: {7 C, ]* c! s/ }" O* Z& ?( K( x（因为动作加载后乘以 0.95）


/ F( M3 s( t# W& w$ p
) ~/ a. p8 R, N9 U[历史]
-0.0.1
初始版本
1 t+ q) G2 D7 [/ P) C: o/ o2 n- 0.0.2 支持读取
0 C. o6 S. }) C5 e9 y. \- a摄像机视角数据
-0.0.3 修复了
GUI 关闭
时，使用鼠标进行正常摄像机操作可能无法工作的问题 -0.0.4
修复了摄像机运动逻辑（旧逻辑是通过将 UnityCameraInterpolation 选项设置为 True 来指定的）将
默认的 Shoulder Tilt 从 12 更改为 8（度）。
4 ?' U- I  {( n-0.0.5
修复了相机计算逻辑（删除了在有一帧差异的键之间禁用完成的逻辑）-
0.0.6 支持
; ]4 C$ }7 Y; A, I: J指定多个 VMD 文件（动作 + 面部表情等）（使用“+”按钮或“;” 带分离的直接输入）相机和角色动作的
动画计算逻辑已完全修改。 从使用 Unity 的 Animation 切换到 DOTween 自己的实现。
1 T1 M: x8 K% [( x# e初始肩部、上臂和臂参数（模型 -> ShoulderTiltDefault、UpperArmTiltDefault、LowerArmTiltDefault）。
设置颈部旋转角度的补充参数 （Model - > NeckRotationScale）。
添加了用于计算摄像机和整个角色位置的缩放选项 （System -> BaseScale。 它以与 GlobalScale 相同的方式应用于整个系统。 ） 修复了
/ \4 T8 M9 M/ Z; I模型初始缩放计算中的错误（修复了始终应用字符高度cf_N_height的问题）
-0.1.0 重构了与其他
插件
共享代码 肩部取消 （Shoulder P/Shoulder C） 骨骼的临时实现
-0.1.1 修复了无法选择
第二个和后续字符的问题。
-0.1.2 修复了快捷键设置中无法使用
大写字母的问题。
IK 目标修复了曲调计算未初始化的问题（在最后一个键之后）修复了在切换
& z" h# T; d- L6 Z7 k. i# |地图或加载场景时 UI 恢复为隐藏的问题。
性能改进
# f; ^6 r2 z1 Z1 p2 n" E  p-0.1.3 为
足部 IK 引入
不同的算法 添加了用于调整加载场景时等待时间的参数 （System > LoadWaitFrames）可选
! y& c: p) C/ J) C( o使用默认表达式 （_DEFAULT_） （Model > UseDefaultFace）。
) }& n* T+ X; h2 I4 v% [0 X  D4 w5 t) i-0.1.4 支持在
! X9 @2 ~) X/ u" N0 `VMD 文件中读取 IK 开/关数据（模型 > UseIKDataInVMD）修复了
循环设置不起作用的问题。修复了
插补曲线计算中的
- x) Y- E. N  g错误 修复了
* X5 M' j& F! ~9 u$ x" X$ {+ b前束 IK 计算中的错误 -0.1.5
修复了即使在关闭 VMD 后也无法更改面部表情的问题 修复了
* Q( h7 ~# j( i5 M2 Y在初始化和加载过程中
; b! _+ Q0 {: |( [- n( ~2 X前束位置等下沉的问题。 修复了导致不包含面部表情数据的 VMD 文件无法加载的问题。修复了脚趾 IK 计算 2 -
0.1.6
中的问题 修复了在保存/读取未设置
-0.1.7 的数据时意外打开 VMD
6 J3 D. F3 j9 a* u' s9 \% h的问题
! n7 F* ]' L7 C修复初始化模型
时腿部/臀部/胸部位置的初始化逻辑 -0.1.8 新增选项 设置
MMD 相关文件参考目录 （MMDData > MMDDataBaseDir） GC
Alloc Memory 的性能调整 扭曲 （x-arm twist/x-hand-twist） 骨骼的临时实现
-0.1.9
, p, R) b; R& n& b手腕角度校正逻辑修复
拇指角度校正逻辑修复
-0.1.10

修复了无法关闭摄像头循环的问题。修复了在没有
+ ~5 k  B7 ^9 Mthumb 0 键的 VMD 文件中拇指角度发生偏移的问题 修复了
; m! b! j0 y- D: G" B% i$ W- g
在未指定 MMDDataBaseDir 的情况下选择文件时初始文件夹设置不正确的问题。 修复面部表情逻辑
-0.1.11 修复扭骨不只在
左手起作用的问题 修复

扭骨的角度计算 -0.1.12 修复

/ X- f, y( }+ c面部表情逻辑 修复了肩部取消角度（肩部 C）未反映的问题。
# X4 x) i2 s+ h/ v; r-0.1.13 修复了
/ e- s# N! z' d. m# x# d' D5 T在保存/加载
% T3 E" e+ J: P0 M0 s# ?0 F数据时，即使角色的 VMD 设置为关闭，面部表情也会被错误重置的问题。修复了扭曲骨骼的角度计算（轴限制）
+ H( k6 p" h& E" l1 t# S7 x- 0.2.0
( V& K1 ?* y5 s1 G修复扭曲骨骼角度计算（平滑）
, Y; |- X9 D2 @9 K-0.2.1 在
2 ^. v& ]/ ~  K4 P( c文件选择对话框（左下角）中添加了排序按钮（名称、修改日期）
1 i# I3 c  k$ x, ~) e# t+ T添加一个按钮，以将摄像机的 ModelScale 反映到所有角色的 ModelScale，或将角色的最小 ModelScale 反映到摄像机的 ModelScale。在
摄像机的 ModelScale 选项下 （>>all chara， <<min chara）
自动计算搜索栏的宽度（如果坐标不可见则拉伸）
$ T+ B0 F. S- V% H+ }UI > AutoControllerAutoAdjustControllerWidth 设置，可以禁用该设置修复了插补曲线计算
0 w6 h$ K) A  w/ t-0.2.3 中的
错误
2 Y" y. m0 j  x5 l' L3 b3 ^用于动态调整的参考模型（仅骨骼）输出（仅当 UseDOTweenAnimation=true 时）有关详细信息
，请参阅 [用于动态调整的参考模型输出]。
-0.2.4 修复了通过指定多个 VMD 文件保存的
场景数据无法正常加载的问题。修复了
& ~* a. l# Q- v% o
% w% }1 ?/ N# I. |8 Z  i! c8 e5 G扭曲的骨骼角度（平滑）没有正确反映的问题。修复了

新增相机
Y 轴旋转调整参数 -0.2.5 新增
. D) o9 w) [/ T6 P. q# N5 V播放、暂停、停止快捷键选项（所有角色、语音、相机）（所有默认值未指定） [
UI] UIKeyPlay， UIKeyPause、UIKeyStop
! M- v# I* i# w4 k仅面部运动应用选项（默认禁用，通过将 beta_EnableFaceOnly 更改为 true 来使用）
-0.3.0 修复了角色在运动过程中
可能无意中模糊的问题。
. e3 O/ b) I1 d$ V3 g! C添加了配置选项以提高性能（UseDirectTransformApply - 默认处于打开状态）
弃用基于 Unity 动画的逻辑并删除
6 M8 h) d) d. G( v相关配置参数 删除了 UseDOTweenAnimation （ 始终为 true） 删除
了 UnityCameraInterpolation（始终为 false）删除
了 UseOldFootIK（始终为 false），从过去的 IK 逻辑中的
UI 中删除了相关参数 逻辑修改，在相机运动中不完成一帧中的关键帧切换（与 MMD 60fps 输出相同）[
0 a4 }4 W7 [( D7 a" |# Z. z$ k8 z系统]通过将 JumpCameraAjacentFrame 选项更改为 false 来加载相机运动时启用完成。 -0.3.0
! ]: Z' |# K6 s-0.3.1 修复了在停止运动时
# {8 }' W8 Y% q2 r执行足部 IK 计算的问题 修复了

& y) {, u/ h2 E: M) s肩部取消骨骼（肩部 C）位置不正确的问题 BepInEx 5.3 / BepisPlugins 15.4 / HoneySelect2 2020.08.14 补丁支持：默认启用
“仅应用面部表情、动作/语音”选项（EnableFaceOnly 选项）
5 X1 B2 z7 D* r/ _  c4 J! }-0.3.3 VMD
文件中的 IK 开/关修复了无法正确加载数据的问题。修复了处理
肩部/肘部/手腕扭曲骨骼平滑时的错误 修复了
" U( Y0 z4 z$ F' @$ g* Y, ?$ q2 G) V; H肢体骨骼被意外拉伸的问题 为
帧更新方法添加了替代选项设置（beta_AltUpdateOption：默认 False = 关闭）
-0.3.4
正确的

2 U8 a8 a5 Q$ X8 g& M4 P比例计算错误
0 w1 j+ @# `+ x6 L4 |+ ~1 ?[无保证]
! N( ?, k. B8 F9 \1 }% j- c/ x本软件按“原样”提供，不提供任何明示或
暗示的保证，
包括但不限于适销性保证，
2 B& i4 X# }1 G6 R0 ^适用于特定目的和非侵权。
在任何情况下，
% G5 x+ p5 ~7 Q) ]6 ~* S作者或版权所有者均不对任何索赔、损害或其他
责任负责。
7 C& `3 L( g, h6 {无论是在合同、侵权行为或其他诉讼中，由软件或
/ H/ C" X; M' m+ s' I- ], e% p软件的使用或其他交易引起或
与之相关。