Skip to main content

Editing Weapon Idle Position

Using VFX EditorPenumbra to Offset Weapons on Idle Stance

 + Shield as Buckler

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.

image.png

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.

image.png

Step 1 - Open VFX and Select ATCH:

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

weaponidle_atch.png
atch in the VFX Editor window.

Step 2 - Select Race and Gender:

3

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

image.png

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)

weaponidle_selectrace.png

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)

affects

Combat whichJobs

classes/jobs.
weaponidle_selectatchpoint.png
Job Code Item Paladin (Gladiator) swd Sword (hips)   sld Shield (back) Warrior (Marauder) 2ax Greataxe (back) Dark Knight 2sw Greatsword (back) Gunbreaker 2gb Gunblade (back) Dragoon (Lancer) 2sp Spear (back) Reaper 2km Scythe (back) Monk (Pugilist) cls, clw Claw (hips) Samurai 2kt Katana (hips)   ksh Samurai Sheath (hips) Ninja (Rogue) dgr Dagger (hips) Viper bld, bld2 Twinfangs (back) Bard (Archer) 2bw Bow (back)   qvr Quiver (back) Machinist 2gn Gun (back)   bag Machinist Bag (hips) 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 (Arcanist) 2bk Book (hips) Red Mage 2rp Rapier (hips)   orb Red Mage Focus (hips) Blue Mage rod Blue Mage Rod (hips) Astrologian 2gl Globe (back)   crd Astrologian Deck (hips) Sage 2ff Nouliths (back) Pictomancer brs Brush (back)   plt Paint pad (hips)

Crafting Jobs

Job Code Position Carpenter awo back   saw hips Blacksmith & Armorer hmm hips   aar, abl back Goldsmith agl back   mlt hips Leatherworker alt back   fry hips Weaver ase back   tmb hips Alchemist aai, aal back   ali, alm hips Culinarian aco back   fry hips

Gathering Jobs

Job Code Position Miner pic back Botanist htc back Fisher fsh back

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.

This

image.png

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
    weaponidle_selectreplace.png

    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)

    weaponidle_adjuststate.png

    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…

    weaponidle_adjustandupdate.png
      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.

      image.pngStep 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.
        weaponidle_saving.png

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

        theUse previousState steps. You can keep one Workspace file1 if you want to adjustchange multiple races/gender.
        weaponidle_addingtoit.png

        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

        to:

        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 CodeCodes List

        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