Title: For What Ails Ya
Authors: Lenophis, Imzogelmo, Kejardon
Version: v1.1
Applies to: FF3us v1.0
Tested on: FF3us v1.0

Contents: For What Ails Ya - no multi-steal - header.ips
          For What Ails Ya - no multi-steal - no header.ips
          For What Ails Ya - multi-steal - header.ips
          For What Ails Ya - multi-steal - no header.ips
          Anti Ails - no multi-steal - header.ips
          Anti Ails - no multi-steal - no header.ips
          Anti Ails - multi-steal - header.ips
          Anti Ails - multi-steal - no header.ips
          readme.txt
          C2 - new.txt
          C2 - old.txt
          ails_ya.asm

ROM addresses: C2/4DAF - C2/4DB3
               C2/39EC - C2/39EE   (original)
               C2/39E9 - C2/39EB   (Imzogelmo's multi-steal)
               C2/3A7C - C2/3A7E
               C2/64E7 - C2/6512

Urgency: Annoyingly high. This can happen to any item, so it's recommended this
patch be used immediately.

--------------------------------------------------------------------------------
Description:

When using an item, there are circumstances that can surface that would cause
you to lose it, even though you never used it. In a non-hacked game, this only
matters when a character dies and gets revived. In hacked games, when the
"don't deplete from inventory" flag for items can get used, it can be more of a
factor, since the items may just randomly disappear. The game supports it, but
at times it seems to forget or something overwrites it.

--------------------------------------------------------------------------------
What this patch does:

When any command can write to the a character's reserve, calls are now added
to update inventory if there is an item in the reserve.

!!!!WARNING!!!!

Due to the way the game works, there is a slight annoyance with this patch. It
may well be the very cause of the bug in hacked games with the "don't deplete"
flag, but at this moment it's unknown.

If character A inputs to use an item, but dies before it is actually used, it
will remain in limbo slightly. Because it wasn't used, the "re-add to inventory"
is not set, therefore the item isn't re-added immediately. However, having that
character perform steal, metamorph, use another item, or if battle ends will
trigger the item to be re-added back to inventory. This cannot be helped, as I
didn't really feel like tearing the engine apart just to get the inventory to
update itself every single frame.

Fun fact: If the inventory is changed, and you are still sitting there with a
character idling, the inventory will not "refresh" until you switch characters.
It was like this in the original game as well, however, I'm stating it here
in case you do not know. But now you know, ya know?

Note: The anti patch effectively removes this patch.

--------------------------------------------------------------------------------
Patches to use:

If you have patched Imzogelmo's Multi-Steal fix, then use either one with the
"Multi-steal" label. Otherwise, use either one with the "no multi-steal" label.

--------------------------------------------------------------------------------
Updates:

1.1 - October 24, 2010
      Fixed an incredibly rare bug in which item users would attack rather than
      perform the item usage, while still having the item deducted from
      inventory.

1.0 - February 1, 2008
      Initial release.

--------------------------------------------------------------------------------
Credits:

Terii Senshi & assassin - For writing the C2 bank disassembly.
assassin - For giving some insight on how to tackle this grand annoyance.
Gil_Galad - For bringing this bug to light.