0ceal0t / Dalamud-VFXEditor

VFX, animation, sound, and physics editing plugin for FFXIV

VFXEditor

Wiki | Guides | Icon by PAPACHIN

VFX, animation, sound, and physics editing plugin for Dalamud

Just want to hide certain VFXs? Use EasyEyes instead

Supported File Types

Extension	Description
.avfx	VFXs, such as particles and glow effects. Has no impact on a character's motion
.pap	The animations performed by a character (such as swinging a weapon, smiling, etc.)
.tmb	Timelines for when to trigger VFXs, animations, and sound effects. Edit this if you want to replace a skill in its entirety
.scd	Sound files (background music, sound effects)
.eid	Bind points used to attach VFXs to character models
.uld	Determines the layout of UI elements
.atex	Texture files for VFXs
.tex	Texture files for UI elements and game models
.atch	Attachment points for weapons and other accessories (like the Machinist bag and Astrologian deck)
.sklb	Skeleton and bone definitions
.skp	Skeleton paramters, such as IK
.shpk	Bundled packages of vertex and pixel shaders
.shcd	Individual shaders
.mtrl	Materials for models

Installation

1. This plugin requires XIV Quick Launcher to run
2. Install the plugin from the /xlplugins menu
3. Once installed, open with /vfxedit

Beta Builds

Add the following custom repository in /xlsettings > Experimental:

https://raw.githubusercontent.com/0ceal0t/Dalamud-VFXEditor/main/repo.json

The beta and main builds cannot both be enabled at the same time, so make sure to disable one before enabling the other. Open the beta version using /vfxbeta

Usage

1. Select a "Loaded Vfx" (the new effect you want to use)
2. Select a "Vfx Being Replaced" (the effect which is being overriden. This can be the same as the source)
3. Make any modifications you want, then press UPDATE

Support

Having problems? Check troubleshooting tips or a basic guide. If you have other questions, please open an Issue

• QuickLauncher Discord
• Students of Baldesion

Contributing

If a VFX is behaving unexpectedly, or you are getting log messages indicating that it is not being parsed properly, please open an Issue.

• .phyb research document
• .tmb/.pap research document
• .scd research document
• .sklb research document

TODO

• Use tables in select dialog
• .sgb editor
• .imc editor
• Texture resize and basic edits
• More investigation into .pap Type and animation names
• .sklb gizmo
• Toggle for .pap animation preview
• C192
• .uld update component type
• Weapon bind points (some bind point ids aren't in the racial .eid)
• More research into sound position (C063)
• Weird crackling when playing back 4-ch and 6-ch files. Maybe related to clipping/conversion?
• Make it so node names don't change when others are deleted (Particle 1, etc.)
• More accurate spline curve calculations
• Add VFX to weapons without it (see here. Would require modifiying VFX id in imc file, and also doing a raw file copy?)
• Sound icon on timeline
• Better PNG import support
• Investigate VFX flags, better structs
• Weapons / footsteps / etc. in live view
• Add pre and post behavior to curve editor
• Update "try on" preview

bgcommon/world/air/shared/timelines/for_bg/tlbg_w_air_001_01a_closed.tmb
bgcommon/world/air/shared/timelines/for_bg/tlbg_w_air_001_01a_open.tmb
bgcommon/world/air/shared/timelines/for_bg/tlbg_w_air_001_01a_close.tmb
bgcommon/world/air/shared/timelines/for_bg/tlbg_w_air_001_01a_opened.tmb
bgcommon/world/air/shared/timelines/for_bg/tlbg_w_air_001_01a_loop.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_w_tbx_010_01_closed.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_w_tbx_013_01_open.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_a_tbx_001_01_opened.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_a_tbx_001_01_close.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_w_tbx_010_01_opend.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_a_tbx_001_01_open.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_a_tbx_001_01_fadeout.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_w_tbx_010_01_fadeout.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_w_tbx_010_01_open.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_w_tbx_013_01_close.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_w_tbx_010_01_close.tmb
bgcommon/world/tbx/shared/timelines/for_bg/tlbg_a_tbx_001_01_closed.tmb
bg/ffxiv/sea_s1/shared/timelines/for_bg/tlbg_s1f2_f1_fusy2_loop.tmb
bg/ffxiv/fst_f1/shared/timelines/for_bg/tlbg_f1t1_t1_sui00c_loop.tmb
bg/ffxiv/fst_f1/shared/timelines/for_bg/tlbg_f1t1_t1_sui00a_loop.tmb
bg/ffxiv/fst_f1/shared/timelines/for_bg/tlbg_f1t1_t1_suis1_loop.tmb
bg/ffxiv/fst_f1/shared/timelines/for_bg/tlbg_f1t1_t1_suis2_loop.tmb
bg/ffxiv/fst_f1/shared/timelines/for_bg/tlbg_f1t1_t1_sui00d_loop.tmb

chara/xls/animation/papLoadTable.plt
chara/xls/boneDeformer/human.pbd
chara/human/c0101/skeleton/base/b0001/skl_c0101b0001.skp
chara/xls/equipmentParameter/equipmentVfxParameter.evp
chara/xls/animation/animation_work_table-demihuman.awt
chara/xls/animation/AnimationExchangeTable.aet
chara/xls/animation/animation_work_table-human.awt
chara/xls/animation/MotionLineTable.mlt
chara/xls/animation/animation_work_table-monster.awt
chara/xls/animation/animation_work_table-weapon.awt

https://github.com/NotAdam/Lumina/blob/73e5bbff7c1668054f410b14815a01eae68d8e8e/src/Lumina/Data/Files/MtrlFile.cs
https://github.com/NotAdam/Lumina/blob/73e5bbff7c1668054f410b14815a01eae68d8e8e/src/Lumina/Data/Parsing/MtrlStructs.cs
https://github.com/NotAdam/Lumina/blob/73e5bbff7c1668054f410b14815a01eae68d8e8e/src/Lumina/Data/Parsing/MtrlStructs.cs