mcpField
D
dalamud-vfx-editor

dalamud-vfx-editor

github.com/akillness创意与媒体5352 次安装4 天前更新
代码仓库

关于 dalamud-vfx-editor

Dalamud VFXEditor 是用于安装和使用 Dalamud VFXEditor 插件、检查及编辑 Final Fantasy XIV 特效和相关资产的技能。内容包括文件类型识别、备份、测试版元数据检查和本地修改验证。

主要功能

  1. 01安装正式版或测试版插件
  2. 02识别特效和动画对应的资产类型
  3. 03创建带 SHA-256 清单的文件快照
  4. 04编辑并替换已加载的特效
  5. 05检查发布元数据

适用场景

  1. 01安装 VFXEditor 插件
  2. 02确定特效修改对应的文件类型
  3. 03编辑前备份资产
  4. 04查看测试版插件的发布信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/akillness/jeo-skills --skill dalamud-vfx-editor

安装后在 Claude Code 中输入/dalamud-vfx-editor确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
file-types-and-workflow.md
upstream.md
scripts/
snapshot_asset.py
inspect_repo_manifest.py

详细介绍

Dalamud VFXEditor

何时使用此技能

  • 从 /xlplugins 安装主插件，或配置 Beta 仓库。
  • 确定哪个 FFXIV 文件类型负责特效、动画、时间线、声音或材质修改。
  • 替换和编辑特效，同时保留回滚副本。
  • 检查插件发布元数据，或为 C# 源代码做贡献。

仅用于用户拥有的本地文件和经授权的模组工作流。不要使用此技能绕过服务控制、分发受版权保护的游戏资源，或干扰其他玩家。

说明

第 1 步：选择操作方式
  1. 安装主插件 — XIVLauncher → /xlplugins → VFXEditor → /vfxedit。
  2. Beta 插件 — 在 /xlsettings > Experimental 中添加上游 repo.json URL，只启用主版或 Beta 版之一，然后使用 /vfxbeta。
  3. 编辑资源 — 确定所属文件类型，备份源文件，编辑已加载的替换文件，更新、测试，并保留回滚凭据。
  4. 贡献源代码 — 克隆固定提交，恢复/构建 VFXEditor.csproj，并遵循当前 Dalamud SDK 要求。
第 2 步：确定所属文件类型

参阅 references/file-types-and-workflow.md。常见选择：

  • .avfx — 不包含角色动作的粒子和辉光；
  • .pap — 角色动画；
  • .tmb — 触发特效、动画和声音的时间线；
  • .scd — 音乐和音效；
  • .atex / .tex — 特效/UI/模型纹理；
  • .shpk / .shcd — 着色器包和单个着色器；
  • .mtrl / .mdl — 材质和网格。

如果用户只想隐藏特定特效，请引导他们采用上游作者推荐的 EasyEyes，而不是自行制作替换文件。

第 3 步：编辑前创建快照
python3 .agent-skills/dalamud-vfx-editor/scripts/snapshot_asset.py \
  /path/to/effect.avfx --output-dir ./vfx-backups

该脚本会原样复制字节并生成 SHA-256 清单。请将原文件、工作副本、导出的替换文件和测试结果分别保存。

第 4 步：进行最小幅度的编辑

在 VFXEditor 中：

  1. 选择 Loaded Vfx 作为新源；
  2. 选择 Vfx Being Replaced 作为目标；
  3. 只修改预期参数；
  4. 按 UPDATE；
  5. 在受控的本地场景中测试；
  6. 如果时序、附着、可见性、声音或性能有问题，立即还原。

若要完整替换技能，请检查 .tmb 时间线，而不要强行将所有更改都放进 .avfx。

第 5 步：使用 Beta 版构建时检查发布元数据
python3 .agent-skills/dalamud-vfx-editor/scripts/inspect_repo_manifest.py repo.json --json

确认内部名称、程序集版本、Dalamud API 级别、仓库 URL 和下载链接。主版和 Beta 版不能同时启用。

第 6 步：仅在兼容环境中构建源代码

检查的项目使用 Dalamud.NET.Sdk/15.0.0、锁定的 NuGet 包，以及 Debug、Release 和 Beta 配置。若没有兼容的 Dalamud 开发环境，请勿承诺能够成功构建。建议使用：

dotnet restore VFXEditor/VFXEditor.csproj --locked-mode
dotnet build VFXEditor/VFXEditor.csproj -c Debug --no-restore

应以上游当前文件为准，因为 Dalamud API 和包版本会发生变化。

第 7 步：验证并交接

报告源文件哈希、编辑的文件类型、目标路径、更改摘要、插件渠道、游戏/Dalamud 版本、测试场景、观察结果和回滚路径。切勿将未修改的游戏资源打包进技能或仓库。

示例

检查官方 Beta 清单
curl -fsSLO https://raw.githubusercontent.com/0ceal0t/Dalamud-VFXEditor/main/repo.json
python3 .agent-skills/dalamud-vfx-editor/scripts/inspect_repo_manifest.py repo.json
替换前备份时间线
python3 .agent-skills/dalamud-vfx-editor/scripts/snapshot_asset.py action.tmb

最佳实践

  1. 为每项源资源创建快照并记录哈希。
  2. 每次只更改一个层级或一组参数。
  3. 确保主版和 Beta 版插件渠道互斥。
  4. 测试附着、时序、可见性、声音和帧耗时影响。
  5. 分享补丁或自制资源，而不是受版权保护的游戏数据。

参考资料

  • references/file-types-and-workflow.md — 文件归属和编辑清单。
  • references/upstream.md — 安装、构建元数据、修订版本和许可证。
  • Dalamud VFXEditor
  • 上游指南

评论

支持 Markdown