动画与姿势播放器

动画与姿势播放器

查看 readme 或 Liesmich

==============================================================================
  inZOI 动画播放器 - 自述文件(中文)
==============================================================================

动画播放器可让你在 Zoi(或附近的其他 Zoi)身上播放任意动画或姿势,将其定格以拍摄照片,并通过姿势编辑器弯折单根骨骼。

打开/关闭:F9 键(或游戏命令 animation_player.toggle)
语言:“DE”/“EN”按钮位于标题栏右上角。首次启动时会自动使用游戏语言。


------------------------------------------------------------------------------
0. 安装
------------------------------------------------------------------------------
  1. 将 ZIP 中的文件夹“Animation_Player_4B649335”复制到:
      文档\inZOI\Mods\
  2. 启动游戏,在模组管理器中启用“Animation_Player”。
  3. 在游戏中按 F9。

  从旧版本更新:先删除旧文件夹。你的设置(收藏、姿势)位于 Mods\InGame\... 中,会被保留。


------------------------------------------------------------------------------
1. 目标 ZOI
------------------------------------------------------------------------------
  我的 Zoi        你当前控制的 Zoi(默认)
  视野中的 Zoi    将相机对准一个 Zoi,然后点击
  附近的        你周围的所有 Zoi,点击名字 = 设为目标
  我的家庭      你家庭的所有成员

所有内容(动画和姿势编辑器)始终作用于选定的目标 Zoi。


------------------------------------------------------------------------------
2. “动画”标签页
------------------------------------------------------------------------------
  全部        加载游戏中的所有动画(需要一点时间),随后搜索框会立即过滤列表
  姿势      游戏中的拍照姿势(猫心、自拍、肌肉、靠墙、坐在地上……)+ 你的 pose_anims.cfg
  模组动画  来自其他模组的动画(见第 6 节)
  * 我的      你的收藏
  跳舞、挥手…… 快速搜索分类

  点击条目 = 选中,再次点击 = 播放。
  “仅匹配此 Zoi”会隐藏不符合 Zoi 年龄、性别或体态的动画。

  播放 / 随机 / 停止  顾名思义
  循环        无限重复动画
  调试      播放会取消游戏暂停,停止会暂停游戏
              (便于动作捕捉和视频录制)
  冻结      停止游戏时间,当前姿势保持不变。
              “解冻”(或游戏中的播放)继续运行。
  在结尾保持姿势
              在动画结束前自动冻结,使姿势保持。非常适合拍照。
  速度      0.25 倍到 3 倍
  * 添加到我的 将选中的动画保存为收藏


------------------------------------------------------------------------------
3. “姿势编辑器”标签页
------------------------------------------------------------------------------
  旋转单根骨骼(头、手臂、脊柱、手指……)。

  1. 在列表中点击一根骨骼(分组:身体、头部、躯干、手臂、手指、腿部、已修改、全部 - 或在顶部搜索)。
  2. 使用 Pitch / Yaw / Roll 滑块旋转(-180° 到 +180°)。
    “-” / “+” = 5° 步进,“0” = 将该轴重置为零。
    各轴为每根骨骼的局部轴 - 直接尝试即可。
  3. 模式:
      叠加        旋转会附加到正在运行的动画之上
                (推荐,Zoi 会继续运动)
      替换        旋转会替换该骨骼的动画
  4. 输入名称并点击“保存” - 姿势会出现在下方列表中。
    点击已保存的姿势可再次加载,“x”会删除它。

  拍照专业提示:
    播放姿势 -> “冻结” -> 在姿势编辑器中微调
    (例如将头转向相机)-> 拍照 -> “全部重置”。

  注意:骨骼命令在游戏中被标记为“实验性”。
  如果 Zoi 看起来很奇怪:“全部重置”。


------------------------------------------------------------------------------
4. 设置存储在哪里?
------------------------------------------------------------------------------
  文档\inZOI\Mods\InGame\Animation_Player_4B649335\ui\animation_player\saved\

  custom.cfg      你的“* 我的”列表
  mod_anims.cfg    “模组动画”按钮的列表        (由你创建)
  pose_anims.cfg  “姿势”的额外姿势                (由你创建)
  poses.cfg        姿势编辑器中保存的姿势
  lang.cfg        所选语言(“de”或“en”)
  window.cfg      窗口位置和大小

  所有 .cfg 文件都是纯文本(JSON),可用记事本编辑。
  请先关闭游戏,或之后按 F9 关闭并重新打开播放器。
  如果“saved”文件夹尚不存在:打开播放器一次并移动窗口 - 游戏随后会创建它。


------------------------------------------------------------------------------
5. 示例文件(文件夹“Beispiele_Examples\saved”)
------------------------------------------------------------------------------
  custom.cfg      6 个精美的游戏动画作为初始收藏
  pose_anims.cfg  3 个额外姿势(自信、着迷、加油)
  poses.cfg        2 个现成的骨骼姿势(“好奇”、“骄傲”)
  mod_anims.cfg    模组动画模板(见第 6 节)

  用法:将所需文件复制到第 4 节中的 saved 文件夹。
  警告:现有的 custom.cfg / poses.cfg 会被覆盖 - 如果你已有自己的条目,请先备份!


------------------------------------------------------------------------------
6. 添加模组动画(分步说明)
------------------------------------------------------------------------------
  播放器播放“CharacterAnim”ID。模组添加到游戏中的每个动画都有这样的 ID(例如“MyMod_Dance_01”)。

  步骤 1 - 找到 ID。有三种方法:
    a) 在播放器中点击“全部”,在搜索框中输入模组名称(或其中一部分)。如果动画出现:那就是 ID。
    b) 查看模组的描述(许多模组作者会列出他们的 ID)。
    c) 在模组文件夹中(文档\inZOI\Mods\...\<Mod>\non_ufs\JsonPatch\)
      用记事本打开文件“AnimCharacter_..._patch.json”并搜索
      “Id”: - 其后的文本就是 ID。

  步骤 2 - 创建文件 mod_anims.cfg
    将示例文件“Beispiele_Examples\saved\mod_anims.cfg”复制到:
      文档\inZOI\Mods\InGame\Animation_Player_4B649335\ui\animation_player\saved\

  步骤 3 - 输入 ID
    用记事本打开文件。它包含一个方括号列表,
    每个 ID 用引号括起,以逗号分隔:

      ["MyMod_Dance_01","MyMod_Dance_02","Lover_DeepKiss_MF"]

    将示例 ID“Meine_Mod_Animation_01/02”替换为你真实的 ID。
    (“Lover_DeepKiss_MF”是游戏动画,始终有效 - 适合测试。)

  步骤 4 - 测试
    启动游戏(或按 F9 关闭并重新打开播放器)。“模组动画”按钮不再变灰。点击条目会检查游戏是否认识该动画(“OK ...”或错误)。

  重要:
    - 相关模组必须已安装并处于活动状态。
    - 来自 mod_anims.cfg 的动画仅在“青年”或更年长的 Zoi 上播放(保护儿童/青少年)。
    - 想要额外姿势而不是模组动画?原理相同,使用 pose_anims.cfg - 条目随后会出现在“姿势”下。


------------------------------------------------------------------------------
7. 致模组作者:让你自己的动画可播放
------------------------------------------------------------------------------
  如果模组只提供蒙太奇(AnimMontage 文件)但没有 CharacterAnim 行,播放器就无法找到它们。此时你需要在 ModKit 中添加两个 JsonPatch 条目(示例见文件夹“Beispiele_Examples\modder”):

    AnimCharacter_Interaction_patch.json
        - 每个可播放动画一行(“Id” = 供播放器使用的 ID)
        - 每个性别和年龄组一个 AnimInfoList 条目
          (务必包含 Youth = 青年,否则游戏会报告“wrong age”)
        - “Animation”指向你模组的蒙太奇资源

    Montage_patch.json
        - 每个自定义蒙太奇都需要在此有一个条目(Id = 蒙太奇名称)。
          没有它,游戏会静默取消动画!
        - AnimReferenceName = 动画序列的名称
        - 将“Notifies”留空

  将占位符“MyMod_12345678”(插件文件夹)和“MyMod_Dance_01...”替换为你自己的名称,然后在 ModKit 中打包。


------------------------------------------------------------------------------
8. 常见问题
------------------------------------------------------------------------------
  “模组动画”变灰
      -> mod_anims.cfg 缺失、为空或位于错误的文件夹。拼写错误?每个 ID 都需要引号、之间的逗号、整个列表外围的方括号。

  “此动画仅限成人”
      -> 模组动画仅在青年及更年长的 Zoi 上播放。

  “无结果”/动画不启动
      -> 取消勾选“仅匹配此 Zoi”并重试。某些动画需要特定体态(坐、躺)或某个物体。

“冻结”/“在结尾保持姿势”后游戏停止
      -> 这是故意的:点击“解冻”或在游戏中播放。

  Zoi 在姿势编辑器后看起来扭曲
      -> “姿势编辑器”标签页 -> “全部重置”。

  更改速度会从头重新开始动画
      -> 游戏目前无法在特定点恢复正在运行的动画。最好在播放前设置速度。


------------------------------------------------------------------------------
  玩得开心! - Schrubbi
==============================================================================