PalCinema - 开源动画框架

展示 🎥PalCinema!🎥

什么是 PalCinema？
PalCinema 是我为社区创建的开源动画框架！
PalCinema 旨在成为一个可在其上构建的健壮动画框架，因此，它仅有极少的 NSFW 功能，以便外部模组可以使用 PalCinema 来为任何类型的情境、玩法等播放动画

PalCinema 功能
  
[list]
[]从专门的 JSON 配置文件播放动画[/]
[]动画兼容性查找[/]
[]动态角色动画播放[/]
[]自由相机[/]
[]生成 Niagara System 道具，以将任何类型的道具纳入动画中[/]
[]在动画期间为帕鲁自定义面部表情[/]
[]在动画期间动态随机化面部表情[/]
[]动画后给予物品奖励[/]
[]动画后施加状态效果[/]
[]带有丰富功能的 UI[/]
[]控制器支持[/]
[]多项设置，可开启或关闭 PalCinema 的若干功能[/]
[]可链接到 PalMagic 或 DynamicPals 以读取特殊模型标记，从而实现更精细的动画匹配
[list]
[]如果两者都不存在，仍然可以播放动画，只是没有额外的精细匹配[/]
[/list][/]
[]供模组与 PalCinema 交互的调度器和互操作性[/]
[]一个 Lua 脚本辅助工具，用于在运行时枚举 JSON 文件，这意味着不需要 ManifestList 或 .bat 文件！[/]
[/list]
安装
[spoiler]要安装，只需将 "Pal" 文件夹拖入你的 Palworld 安装文件夹
[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393396-1323179652.png[/img]

或者按以下步骤手动安装各个组件
将 PalCinema.pak 放入 LogicMods 文件夹，如果你使用 PalMagic，你还需要将 PalMagic 更新到 0.2.4
[list]
[]PalCinema 可以在没有 PalMagic/DynamicPals 的情况下工作，但除少数自动项之外的 SpecialFlags 要求将被忽略[/]
[/list][img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393224-1694614220.png[/img]

PalCinema 动画 JSON 文件放入 mods 文件夹中新的 MovieJSON 文件夹

[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393243-2089990210.png[/img]

将附带的 JsonFileLister 放入 UE4SS Mods 文件夹
这个 Lua 辅助脚本允许 PalCinema 和较新版本的 PalMagic 不需要 _ManifestList.json 文件，也不需要用于创建它的 .bat 脚本！只需将 JSON 文件放入各自的文件夹即可！

[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393331-239110029.png[/img][/spoiler]

PalCinema UI 和控制
[spoiler]主 UI
[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393430-1502407816.png[/img]
这是 PalCinema 的主 UI，它具有以下功能：
[list]
[]按 Numpad * 或 Shift + ` 打开菜单[/]
[]你可以点击 Exit 按钮或点击菜单外部来退出此菜单[/]
[]左侧的按钮横幅显示用于在 MovieData 部分和 Settings 部分之间切换的按钮[/]
[/list]
MovieData 部分
[list]
[]Selected Actors：此部分显示已从 Select Actors 按钮菜单中选择了哪些角色，点击 Select Actors 按钮后，会出现以下窗口，供你选择想要参与动画的角色
[list]
[]注意：包含多个相同角色和/或动态动画的动画需要按正确顺序选择才能播放，此问题目前正在处理中[/]
[/list][/]
[/list]
[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393472-1846416349.png[/img]

点击角色名称将选择他们参与动画，完成后；点击 Select Actors 按钮返回主 UI
[list]
[]你可以点击此菜单外部来关闭它[/]
[/list]
[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393497-1736435192.png[/img]

[list]
[]你可以点击 Available Movies，如果动画兼容，则通过点击 Play Movie 按钮从列表中选择要播放的动画！
[list]
[]你可以随时按 Tab 或 Escape 停止动画[/]
[/list][/]
[/list] 
[list]
[]你可能会看到一些动画被标记为 [Locked]，这些是未通过兼容性检查的动画，但它们是所选角色“可播放”的动画[/]
[/list][img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393547-33500510.png[/img]

点击任何这些 [Locked] 动画将显示哪些条件未通过，以便让你知道需要什么才能播放该动画

[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393522-1969866913.png[/img]


MovieTags 可点击，点击后会被添加到黑名单，被加入黑名单的动画将显示为 [Locked]，且不会出现在 QuickMovie UI 中

[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393579-276271090.png[/img]

Settings 部分
此部分用于设置 PalCinema 的配置设置，并提供一些关于版本以及已加载多少影片的反馈

[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393604-1939831919.png[/img]

[list]
[]PalCinema Version：一个简单字符串，用于标识正在运行的是哪个版本的 PalCinema[/]
[]MovieCount：可以从 JSON 中读取并加载多少动画[/]
[]NSFW Allowed：此复选框启用和禁用 NSFW 动画，这不会影响 SFW 动画的播放[/]
[]Item Rewards Active：此复选框启用和禁用动画给予的物品[/]
[]Status Effects Active：此复选框启用和禁用动画施加的状态效果[/]
[]Override Compat Checker：启用此项将禁用次级兼容性检查，即如果角色匹配，则不论其他条件如何都将允许播放[/]
[]Manual Loop Advance：如果玩家处于动画中且此复选框已启用，PalCinema 将播放循环部分，直到按下空格键/Xbox X 按钮[/]
[]Movie Loop Count：每个循环部分应播放多少次循环，如果 Manual Loop Advance 已禁用，则适用于所有动画；即使 Manual Loop Advance 已启用，也仍将适用于玩家未参与的动画[/]
[]Movie Time Limit：动画播放时长的硬性上限，以秒计，这主要是一项保护措施，以防动画未正确结束，从而使参与者不会卡在动画中[/]
[]Blacklist Tags：所有被列入黑名单的标签列表，点击其中一个标签会将其从黑名单中移除[/]
[]Reload JSONs 按钮：此功能用于让 JSON 编辑和调整更容易，你可以在世界中编辑 JSON 文件，按下此按钮将使用新调整的 JSON 数据重新加载动画，而无需退出并重新登录世界，点击此按钮将关闭 UI 而不保存设置，以重新加载 JSON[/]
[/list]QuickMovieUI
[img]https://staticdelivery.nexusmods.com/mods/6063/images/5889/5889-1791393630-1067276053.png[/img]

QuickMovie UI 可用于快速与距离玩家角色最近的角色开始动画，并具有以下功能：
[list]
[]按 [color=#ff7700]Numpad –[/color]、[color=#ff7700]Shift + V[/color] 或短暂按住 [color=#00ff00]D-Pad Down[/color] 打开菜单[/]
[]它将在应用次级兼容性检查后，列出玩家角色与距离玩家最近角色之间可用的动画[/]
[]导航
[list]
[][color=#ff7700]W[/color]/[color=#00ff00]Right Stick Up[/color]：在选择菜单中向上移动[/]
[][color=#ff7700]S[/color]/[color=#00ff00]Right Stick Down[/color]：在选择菜单中向下移动[/]
[][color=#ff7700]Spacebar[/color]/[color=#00ff00]Xbox X button[/color]：播放所选动画[/]
[][color=#ff7700]Click outside[/color]/[color=#00ff00]Xbox B button[/color]：取消并关闭菜单[/]
[/list][/]
[/list][/spoiler]


PalCinema 不兼容其他动画框架的 JSON 文件
由于 JSON 结构差异相当大，自动转换对我来说编码起来更复杂，
因此不包含转换脚本（如果你能想出转换脚本，欢迎分享！）
 
该包包含一份 .docx 文档用户手册，涵盖 PalCinema 的安装、使用和控制，供你方便参考
 
用户手册末尾列出了 PalCinema 中当前正在处理的问题！
如果你发现该模组的任何其他问题，请告诉我~！

你可以从以下 Discord 服务器获取更多面向动画师、模组作者的专门模组包，或完整源代码，欢迎加入，那里有很多很棒的人！
[url=https://discord.gg/YSDTuB9P3]Jackal's Den[/url]
[url=https://discord.gg/BE6NhC9gV]T-Box's Server[/url]
 
[heading]特别感谢[/heading]
Lanz 制作 PalCinema 标志
xMenar、Z3N-DR4G0N、Lights 提供用于测试的动画资源
Z3N-DR4G0N、UnfairJackal、T-Box、Bakkas、Reaper 提供角色模型
Lights 提供一些功能代码片段
Deccu、Zetter、Shiinr、iso、Poki，以及来自 Jackal’s Den、T-Box Server、Zetter’s Shelter 的非常友好且支持 Palworld 模组社区的所有人