Using Penumbra to Offset Weapons on Idle Stance + Shield as Buckler

Required Programs 
 Before you start, make sure you have the Penumbra 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 now have a new mod. Enable the mod (on your own character), then go to Advanced Editing. 
 
 Step 3 
 In the Advanced Editing window, select Meta Manipulations, then click "0 Attachment Points (ATCH)" 
 
 Step 4 
 In that tab, select the race and gender of your character (so you can see changes quickly), then click the weapon/tool 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 only has three letters, refer to the ATCH Weapon Items Code List below) 
 
 ATCH Weapon Items Code List (Hips & Back Only) (up to patch 7.1) 
 Combat Jobs 
 
 
 
 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 5 
 When ready, hit the + button next to that entry, then a new line will appear below. The values are now lit up and can be changed. 
 
 Step 6 
 There are 8 things you can now change: 
 
 The first one is the parent bone , which means where the weapon is placed while in standing idle (in state 1). You would change this if you want to place the weapon somewhere else on your character's body in sheathed position (such as arm, back, etc), you will need to enter in the exact Bone name. 
 The three numbers to the right of that are X, Y, and Z coordinates of the weapon, relative to that bone. 
 The number below the parent bone is the size of the weapon in that state. 
 The three numbers to the right of the size 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), change the Weapon to something else, then click the + button to add. 
 
 
 Shield as Buckler 
 For Paladins/Gladiators , if you want to change the shield 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 Offset and Rotation adjustments. 
 Use State 1 if you want to change idle , and State 0 for when weapon is drawn/fighting stance . 
 
 
 Notes 
 
 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+ also has weapon adjustment parameters, but was not working at the time of this 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 
 WHEN 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). 
 
 by Req Rider ported to the Wiki By Stoia last update 24.02.2025 
 
 
 ATCH Weapon Codes 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     2gb -Gunblade (back) Dragoon (Lancer)     2sp -Spear (back) 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     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     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     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     2gl -Globe (back)     crd -Astrologian Deck (hips) 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     hmm (hips) Armorer     aar, abl (back)     hmm (hips)         ytk (none) Goldsmith     agl (back)     mlt (hips)     tbl, tgn (none) Leatherworker     alt (back)     fry (hips)     prf (none) Weaver     ase (back)     tmb (hips)     ndl, whl (none) Alchemist     aai, aal (back)     ali, alm (hips)     mrb, mrh (none) Culinarian         aco (back)     fry (hips)     stv (none) 
 Miner     pic (back) Botanist     htc (back)     nph (none) 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