UPDATE: A DFU Android-compatible version of Shield Widget has been added to Main Files. Take your shield with you when you're on the go!

Android version notes:

• Made for use specifically with Vwing's DFU port. I can't guarantee it will work with different forks or projects. Refer to the github for instructions on installing mods.
• My access to Android devices is limited, so I'd appreciate any feedback regarding the mod working on other devices. As with the previous point, I can't guarantee it will work perfectly with every device, but with your help, I will try my best to figure out whether it's in my capability to fix.
• Many thanks to Vwing for their work on porting DFU to Android as well as being extra mindful of modding support.
  

---

UPDATE: The Recoil module's PCO compatibility patch is broken for now. You'll have to play without Recoil if you also want PCO until I figure out a way to get it to work. Sorry about that. Thanks to the players who reported it.

---

Main features:

• First-Person shield sprite
• Includes graphics for every shield type (Buckler, Round, Kite, Tower) as well as material variants*
• Adapts to any resolution changes (Widescreen, Retro-mode, etc)
• Scale and positional offsets are customizable
• Behavior under certain conditions is configurable (sheathed, spellcasting, etc)
• Condition tracking where the shield will show visible damage at certain durability thresholds
  

*Follows vanilla DF's color scheme where Leather/Chain/Silver all use the same material graphic

Visit the Videos page to see some of these features being shown off. 

---

Optional modules (Disabled by default, toggle and configure separately in the mod settings):

• Bob module - Adds bob and sway to the shield sprite when moving
• Inertia module - Delays the shield sprite when looking around to simulate weight
• Recoil module** - The shield recoils when an enemy targets a body part that is protected by it
• Animation module*** - Plays a frame-by-frame animation when sheathing and attacking instead of offsetting the sprite
• Step module - Rounds out the position values on the sprite to give it a stepped movement when being offset or with all transforms
  

**Can only be activated on the DFU Startup menu
***Will lock the base Offset sliders at specific values

---

All settings (except for enabling the Recoil module) can be accessed even during the game via the Mod Settings menu when paused, so you see any changes immediately.
There are also presets available for each module.

---

Compatibility:

• Shield, Bob, Inertia, Animation and Step modules should be fully compatible with any setup
• Recoil module requires overriding a vanilla damage formula (CalculateAttackDamage) so it won't be compatible with mods that do the same, like Physical Combat and Armor Overhaul (PCO)
  

---

This was inspired and made possible by l3lessed's mod work and posts on the old workshop forum.
Magicono43's work on PCO also helped with getting the Recoil module to function as well as providing material to make it compatible with PCO.
Carademono talked me through packaging textures into DFMODs on the Lysandus' Tomb Discord server.
WilhelmBlack contributed frame-by-frame animations for all shield/material/condition combinations as well as properly palletized sprites.
Much thanks to them for allowing others to learn from their work and helping with bringing this to completion.

---

Recommended Mods:

• If playing with Retro-Mode's aspect ratio correction, DunnyOfPenwick's Retro-Frame will cover up the Shield sprite crossing the black bars when changing offsets or when Bob, Inertia or Recoil is enabled. And it's just a darn nice mod overall. Highly recommended.
• To add on to Retro-Frame, I also recommend WilhelmBlack's Retro Experience mod, mainly because it's a work of art.
• The shield is fully compatible with First-Person Lighting, also by DunnyOfPenwick, and I can't recommend that mod enough for the serious dungeon delver.
• Excepting the Recoil module, Magicono43's Physical Combat and Armor Overhaul is mostly compatible with Shield Widget and puts a neat twist on how Shields work.
• Condition graphics may be difficult to experience in vanilla DF due to how little damage shields (and armor in general) incur with normal gameplay. Roleplay & Realism by Hazelnut, specifically the Armor Damage module, is highly recommended to make this feature more prominent.
• If playing with Mighty Meatus' Teal Elven or Purple Adamantium, there are recolor patches available for each in the Optional Files with graphics kindly contributed by WilhelmBlack