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. 03SHA-256マニフェスト付きでファイルを保存
  4. 04読み込んだエフェクトを編集・置換
  5. 05リリースメタデータを確認

活用シーン

  1. 01VFXEditorプラグインを導入
  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 からメインプラグインをインストールする、またはベータ版リポジトリを設定する。
  • エフェクト、アニメーション、タイムライン、サウンド、マテリアルの変更を所有する FFXIV ファイルの種類を特定する。
  • ロールバック用のコピーを保持しながら、エフェクトを置き換えて編集する。
  • プラグインのリリースメタデータを確認する、または C# ソースに貢献する。

ユーザーが所有するローカルファイルと、許可されたモッディングのワークフローでのみ使用してください。このスキルを使ってサービスの制御を回避したり、著作権で保護されたゲームアセットを配布したり、他のプレイヤーの妨害をしたりしないでください。

手順

ステップ 1：作業経路を選択する
  1. メインプラグインのインストール — XIVLauncher → /xlplugins → VFXEditor → /vfxedit。
  2. ベータ版プラグイン — 上流の repo.json URL を /xlsettings > Experimental に追加し、メイン版またはベータ版のどちらか一方のみを有効にしてから、/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. タイミング、アタッチメント、表示状態、サウンド、パフォーマンスに問題があれば、直ちに元に戻します。

スキル全体を置き換える場合は、すべての変更を .avfx に押し込むのではなく、.tmb のタイムラインを確認してください。

ステップ 5：ベータ版ビルドを使用する場合はリリースメタデータを確認する
python3 .agent-skills/dalamud-vfx-editor/scripts/inspect_repo_manifest.py repo.json --json

内部名、アセンブリのバージョン、Dalamud API レベル、リポジトリ URL、ダウンロードリンクを確認してください。メイン版とベータ版のビルドを同時に有効にすることはできません。

ステップ 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 のバージョン、テスト環境、確認した結果、ロールバック方法を報告してください。変更されていないゲームアセットをスキルやリポジトリに含めないでください。

例

公式ベータ版マニフェストを確認する
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. 一度に変更するレイヤーまたはパラメーターのグループは 1 つにします。
  3. メイン版とベータ版のプラグインチャンネルを相互排他的に保ちます。
  4. アタッチメント、タイミング、表示状態、サウンド、フレーム時間への影響をテストします。
  5. 著作権で保護されたゲームデータではなく、パッチや作成したアセットを共有します。

参考資料

  • references/file-types-and-workflow.md — ファイルの所有関係と編集チェックリスト。
  • references/upstream.md — インストール、ビルドメタデータ、リビジョン、ライセンス。
  • Dalamud VFXEditor
  • 上流のガイド

コメント

Markdown 対応