Editing Weapon Idle Position

Using VFX EditorPenumbra to Offset Weapons on Idle Stance

Required Programs

Before you start, make sure you have the VFX EditorPenumbra plugin for Dalamud (as well as using XIVLauncher to run Dalamud).

Steps

Step 1

Make a new Mod, by pressing the + button. Enter a name, then press Enter.

Step 2

You willnow alsohave needa Penumbranew tomod. implementEnable the mod if(on youyour doown notcharacter), wantthen go to loadAdvanced up VFXEditor all the time.Editing.

Step 1 - Open VFX and Select ATCH:

Open up VFX Editor by typing /vfxedit. Proceed to click the “atch” button.

Step 2 - Select Race and Gender:

In the newAdvanced Editing window, underselect LoadedMeta AtchManipulations, then click "0 Attachment Points (ATCH)"

Step 4

In that tab, select the firstrace line)and gender of your character (so you can see changes quickly), then click the Searchweapon/tool button,that you want to edit (example will be using Gladiator/Paladin's Sword). Make sure the number next to the weapon is set to "1" which is the un-drawn state (if you pick "0" then it is the drawn state).

(If the weapon is not named, and inonly thehas newthree window, select Character, then select base Race/Gender. Pick you character's race/gender, then hit Select.

(For this example, this guide will use Hyur Midlander F)

Step 3 - Select Weapon/Tool/etc:

A new list will pop up on the Atch Editor window (you can close the Atch Select [LOADED] window).
This contains a list of all weapons, tools, and other related things. Pleaseletters, refer to the bottomATCH ofWeapon theItems guideCode List below)

ATCH Weapon Items Code List (Hips & Back Only) (up to seepatch which7.1)

Combat whichJobs

Crafting Jobs

Gathering Jobs

Step 4 - Select Replaced Race:5

BelowWhen "Loadedready, Atch", onhit the line+ Atchbutton Beingnext Replaced, clickto that searchentry, button'sthen icon,a new line will appear below. The values are now lit up and repeatcan stepbe #2.changed.

Step 6

There are 8 things you can now change:

• The first one is forthe parent bone, which means where the oneweapon is placed while in standing idle (in state 1). You would change this if you want to load to. Use the same choice as you picked for Step #2

  

  Step 5 - Select the Weapon:

  Now with the job or class you want weapons adjusted, make sure those weapons are currently shown. Clickplace the weapon somewhere else on your character's body in sheathed position (forehandsuch oras backhand,arm, whicheverback, you want to adjust) andetc), you will see six lines that are named "State".
  You wantneed to edit State 1, and should either have "kosi" or "sebo"enter in the nameexact (KosiBone forname.

hips,
• The Sebothree fornumbers back):
  j_buki_kosi_<l/r> → Sheathed Weapon (Hip)

  j_buki2_kosi_<l/r> → Sheathed Weapon (Hip2)

  j_buki_sebo_<l/r> → Sheathed Weapon (Back)

  

  Pressto the small white triangle button to expand the windowright of that weapon's State 1, and you should see some numbers like in the example above.

  Step 6 - The Trial and Error Part:

  This part will be the trial-and-error part. Change only one value (use increments of 0.1 or 0.01) at a time, then hit the green UPDATE button to see a change on your weapon. If things went well, the weapon on your character should have moved in some way…

  

  • Focus on Offset and Rotation part. These values do not necessarily coordinate withare X, Y, and Z,Z andcoordinates this moves only one weapon forof the class/jobweapon, forrelative to that particular race/gender. (Offset moves placement, rotation changes weapon orientation. This affects you idle standing position with weapons sheathed.)bone.
  • UseThe Changenumber Posebelow (in-game)the toparent seebone howis the size of the weapon looks on different standing idle positions. I start at the base standing position where both arms are just straight down. (I do not know how to "reset" a value, so I write down the base numbers in casethat I need to start from base.)state.
  • SaveThe yourthree workspace by going to File > Save As, then select where you want to save your workspace (then use Save when you make further changes). Use Open (or Open Recent) to load this up again in the future.

  Step 7 - Saving it all:

  Once you have made all your changes for every job you want adjusted for that single race/gender, click Export, then pick either Penumbra or Textools, then fill in the information for your modpack then Save. You can also export the RAW ATCH file as well (the buttonnumbers to the right of the greensize UPDATEbutton button)are the rotation of the weapon in an X, Y, and Z axis.

Step 7

Change one number, starting on the Offset X-Coordinate, and change value by 0.1 (for testing). Click Apply Changes, then back on the main Penumbra Window, at the bottom where it says Redraw, hit "All" or "Self."

Step 8

Your character should disappear, then reappear in a second or less. The weapon should now have moved a bit from default.

Step 9

With the Advanced Editing window still open, change that value(s) you change, as well as any other value, by repeating Step 8, until you are satisfied with that Weapon Offset.

Optional: Export as .pmp file

To save your edits as a .pmp file, go back to the main penumbra window, and under that mod you just made, click Edit Mod, change the Name, Author, Version, etc. and then click Export Mod. The file should save at the location when you hover over the Export Mod button.

Step 10

To change another weapon, go back to the first line under Attachment Points (not the one you changed, the one above it), espciallychange the Weapon to something else, then click the + button to add.

Shield as Buckler

For Paladins/Gladiators, if you want to usechange yourthe adjustmentsshield to be a buckler change the following:

• Change parent bone from j_buki_sebo_l to j_ude_b_l
• I would recommend changing the size to half (example Au Ra Female: from "0.75" to "0.375")
• Please see sheet for other races/gender.

  

  If you want to edit other races/gender, click the + button (see below)Offset and thenRotation repeatadjustments.

the
• Use previousState steps. You can keep one Workspace file1 if you want to adjustchange multiple races/gender.

  

  Finalizingidle, and Notes:State 0 for when weapon is drawn/fighting stance.

Notes

Turn off VFX Editor, then load the .pmp or .ttmp2 file to see if it worked (and that you do not need to load in VFXEditor each time you log into the game).

• Not all races/gender will share the same exact values for 1 weapon, will need to adjust for each if planning to do all.
• Hand collisions will occur on idle positions. Move the weapon again if it bothers you.
• Using Change Pose can make some weapons look further out/in. I tested with the standard idle position (arms straight down).
• If you use Customize+, you will need to adjust for that (load your C+ setting for your character before adjusting weapons). Apparently C+ Weaponalso Offsethas isweapon NOTadjustment parameters, but was not working asat the time of now.
this
• If you edited one race/gender, and if you want to load those settings on another, you can save that workspace into an .ATCH file, then load that file in Loaded Atch (first line). Note that it will use the base of the loaded race/gender combination, and may not reflect the natural weapon positions of the target race/gender. This can save work, but weapons can appear farther on other races/gender, and may need more fine tuning.writing.
• Crafting main tools will either have a side hip tool or a back tool position. (If you need to test back tools, use Glamourer and switch to an Aesthete tools)
• This guide is for adjusting weapon positions on the idle position. For drawn and everything else, I think you would need to adjust the other States (personally have not tried this).

Warning

SpecialWHEN A NEW PATCH THAT INTRODUCES A NEW JOB, YOU MAY HAVE TO START OVER, AS SAVED WORKSPACES OR ATCH FILES MAY NOT WORK! Loading an old file causes new weapons to disappear, as there were no values before the new patch with a new job. Unknown if this will change in future VFXEditor releases. Save numbers in a spreadsheet for easy access. (This was for the VFXEditor method, may not apply for this Penumbra method)

Thanks

Saenomaed: For teaching me this technique on adjusting weapons (the old VFXEditor method).

ReqRiderby forReq writingRider
ported to the OriginalWiki Guide.By Stoia
Saenomaedlast forupdate Teaching ReqRider this technique.
Everyone involved in VFXEdit, especially ocealot.24.02.2025

ATCH Weapon Items Code List
Paladin (Gladiator)
    swd -Sword (hips)
    sld -Shield (back)

Warrior (Marauder)
    2ax -Greataxe (back)

Dark Knight
    2sw -Greatsword (back)
Gunbreaker
 Gunbreaker   2gb -Gunblade (back)

Dragoon (Lancer)
    2sp -Spear (back)
Reaper
 Reaper   2km -Scythe (back)
    ebz -Reaper Shroud (none)

Monk (Pugilist)
    cls, clw -Claw (hips)
    clg -Glove (none)
        Notes: I found cls may work rather than clw, like with tonfa weapons
Samurai
 Samurai   2kt -Katana (hips)
    ksh -Samurai Sheath (hips)

Ninja (Rogue)
    dgr, (dge) -Dagger (hips)
    frg -Ninja Frog (none)
    rbt -Ninja Rabbit (none)
        Notes: dge may not affect daggers, have not found a use

Bard (Archer)
    2bw -Bow (back)
    qvr -Quiver (back)
    flt -Flute (none)
    hrp -Harp (none)
Machinist
 Machinist   2gn -gun (back)
    bag -Machinist Bag (hips)
    msg -Machinist Shotgun (back)
    mwp -Machinist Cannon (back)
    gsl -Machinist Deployable (none)
    syl -Machinist Sniper (none)
        Notes: Shotgun and Cannon are normally deployed quickly, may not need to adjust these
Dancer
 Dancer   chk -Chakram (hips)    
Black Mage, White Mage (Thaumaturge, Conjurer)
    2st -Greatstaff (back)
    stf -Staff (hips) [single hand staffs, 1.0, 2.0 content]

Summoner, Scholar (Archanist)
    2bk -Book (hips)

Red Mage
    2rp -Rapier (hips)
    orb -Red Mage Focus (hips)

Blue Mage
    rod -Blue Mage Rod (hips)
Astrologian
 Astrologian   2gl -Globe (back)
    crd -Astrologian Deck (hips)
Sage
 Sage   2ff -Nouliths (back)
Viper    
    bld, bld2 -Twinfangs (back)
Pictomancer
    brs -Brush (back)
    plt -Paint Pad (hips)

Carpenter
    awo (back)
    saw (hips)
    csl, csr (none)
Blacksmith
 Blacksmith   hmm (hips)
Armorer
 Armorer   aar, abl (back)
    hmm (hips)    
    ytk (none)
Goldsmith
 Goldsmith   agl (back)
    mlt (hips)
    tbl, tgn (none)
Leatherworker
 Leatherworker   alt (back)
    fry (hips)
    prf (none)
Weaver
 Weaver   ase (back)
    tmb (hips)
    ndl, whl (none)
Alchemist
 Alchemist   aai, aal (back)
    ali, alm (hips)
    mrb, mrh (none)
Culinarian    Culinarian
    aco (back)
    fry (hips)
    stv (none)
Miner
    pic (back)
Botanist
 Botanist   htc (back)
    nph (none)
Fisher
 Fisher   fsh (back)
    fha (none)
    sic (none)
Unknown:
    Hips -rap, gun, yt2, ytc
    Back -sht
    None -atr, avt, col, cor, cos, crr, drm, egp, elg, fcb, fch, fdr, fl2, fud, gdb, gdh, gdl, gdr, gdt, gdw, gsr, hel, let, lpr, nik, oum, pen, sxw, syr, syu, tcs, trm, trr, trw, vln, wng, ypd