EPL卡牌动画工具

创作者: iiTzSamurai

已更新:2026-08-16 14:00:21

13KB

下载

前置 MOD

使用 EPL卡牌动画工具时将自动安装

增强型预制体加载器

217KB

EPL接口

11KB

关于此 MOD

在活页夹/卡册、牌桌和墙面投影仪上，播放来自增强型预制体加载器（EPL）自定义套牌的多帧卡牌动画。

EPL卡牌动画师

集换式卡牌商店模拟器的动态卡牌美术。 EPL卡牌动画师 在活页夹/相册、牌桌和墙面投影仪中，通过增强型预制加载器（EPL）自定义套装在卡牌上播放多帧动画。

基础游戏卡牌永远不会被改动——只有拥有动画包的EPL卡牌才会有动画效果。

功能

为任何拥有匹配动画包的EPL卡牌添加动画效果。
读取 一次性多个卡包 ——不同作者的不同套牌可以共存。
支持AssetBundles。
同步播放——每张卡牌的副本都会同步播放动画，拾取或缩放卡牌时动画绝不会重新开始。
在加载界面预加载帧以实现即时播放（可切换）。
可配置帧率。

安装（用户）

将其解压出来，以便你拥有：

BepInEx/plugins/EPLCardAnimator/EPLCardAnimator.dll

配置

启用动画 （默认开启）—— 总开关。
动画帧率 （默认 20，范围 1–30）— 播放速度。
预加载帧 （默认关闭）—— 加载时预先解码所有帧，以实现即时播放。关闭此项可降低内存占用，但代价是每张卡牌首次显示时会有短暂延迟。
详细日志 （默认关闭）— 用于故障排除的额外扫描/解析日志记录。

制作动画包（模组作者）

帧按扩展包和来自你EPL .json文件的CardSpriteName进行组织：

动画/<Expansion>/<CardSpriteName>/0001.png, 0002.png, 0003.png, ...

<扩展> — EPL系列的扩展包名称去除空格后的形式（例如MythicalIsland）。它必须与卡牌的ECardExpansionType相匹配。

<卡牌文件夹> — 必须 作为卡牌的精灵名称：集合 JSON 中的值精灵字段。

动画/神话岛/85_MI_雪拉比EX/

帧文件 — 按顺序命名以便排序：0001、0002、……（或1、2、……）。

可选：边框 / 闪卡覆盖
默认情况下，卡牌文件夹会匹配卡牌，无论其边框或闪卡状态。要定位特定变体，请将其嵌套在边框或闪卡文件夹下：

动画/神话岛/85_MI_时拉比EX/ ← 任意边框，任意闪卡（默认）
动画/神话岛/EX/85_MI_雪拉比EX/ ← 仅EX边框
动画/神话岛/闪卡/85_MI_雪拉比EX/ ← 仅闪卡版本

边框文件夹名称必须与系列中真实的 ECardBorderType 值一致（例如 Base、EX、FirstEdition、FullArt）。

正在构建捆绑包
对于已发布的包，使用我在可选文件中提供的UnityAssetBundler.zip构建AssetBundle——在Unity Hub中打开该项目。

使用Unity 2021.3 使用打包工具打开项目。
将你的帧放在 Assets/animated/<Expansion>/<CardSpriteNameFolder>/ 下。
帧纹理必须导入为 精灵（2D 和 UI）包含的打包工具已为你设置此项。
奔跑 工具 → 处理纹理并创建捆绑包.
输出文件以你的扩展包文件夹命名（例如 mythicalisland.assets），并带有唯一的内部名称。
将 .assets 文件放入 BepInEx/plugins/EPLCardAnimator/animated/ 中。或 BepInEx/plugins/EPLCardAnimator/animated/<folderofchoice>

关键规则：唯一名称
每个卡包都需要一个 唯一捆绑包名称 ——文件名两者和构建时烘焙进去的内部 AssetBundle 名称。两个共享同一内部名称的包无法一起加载；即使文件被重命名，Unity 也会拒绝加载第二个。内置的打包工具通过按扩展文件夹为每个包命名来自动处理这一点。如果你手动构建包，请为每一组指定一个不同的 AssetBundle 名称。

压缩：LZ4 / LZ4HC（Unity 的“基于块的压缩”）或未压缩都可以。避免使用 LZMA——它会在加载时完全解压到内存中。

卡包如何组合
该模组会加载其文件夹下的所有 .assets 资源包，并将它们合并。不同的集合会对应不同的卡牌，因此来自不同作者的卡包不会冲突。如果两个卡包定义了同一张卡牌，则后加载的会覆盖先加载的。

故障排除