Stat Increase Items!

Title: Stat Increase Items
Author: GrayShadow
apply to FF3us1.0
Download


So, I was talking about this in the Shoutbox a couple of days ago, and I finally got the code commented to my satisfaction. ;) This isn't actually an .ips file, because the code's not game ready -- this is designed to be incorporated into a more extensive hack, not least because it requires overwriting existing items.

But! Without further ado, I present: Stat Increase Items!

The items as-is operate in two ways: one, like the Sources in FF7, increase Vigor, Speed, Stamina, and Magic by one point each time they're used, although in the code as distributed they cap at 128 (this is easily altered if you want to increase/decrease the cap; check the comments in the .asm file); two, like Golden Apples and Soma Drops in FF4, items that increase HP by 100 or MP by 10.

These properly account for HP/MP boosting items; each base HP/MP increase will automatically incorporate a character's existing HP/MP boosts and will also properly adjust those extra points when the equipment is removed. This can cause an interesting non-glitch if you max out the stats while they're equipped, as it can look like you're still using an item on a character with maxed stats -- but they're really increasing the non-maxed base stat, regardless what the equipped boosts have the character at.

Likewise, though it's not as immediately obvious (because you have to check the status screen/equipment screen to see the updated stats), the Vigor/Speed/Stamina/Magic items cap at 128 /base/ stat, not adjusted. Increases from equipment can bring you above that value, as they can with esper bonuses in the vanilla game (which, IIRC, are also capped at 128).

Included in the .zip are the .asm code, the readme, and two screenshots with suggested FF3usME options selected for the items.

AS A NOTE: The code as-is overwrites Rename Card functionality; if there's demand for it, I can look at ways around that, but I figured... y'know. Rename Cards. Who uses those, anyway? ;)

The readme follows:

Code:

Title: Stat Increase Items
Author: GrayShadows (in.the.afterlight@gmail.com)
Version: v1.0
Applies to: FF3us v1.0
Tested on: FF3us v1.0

Contents: StatUp.asm
          StatUp-readme.txt
          StatUp-1.png
          StatUp-2.png

Urgency: None, unless you want these items for a hack you're
         developing.

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

Stat Up Items introduces code that will permanently boost
character stats with items, like the Sources in FF7 or the Golden
Apples and Soma Drops in FF4. The patch is being distributed as
an assembly file because it's intended to be included in more
extensive hacks, rather than as a stand-alone; it requires
replacing existing items, as it doesn't extend the item list,
although if there is enough interest I will look into how one
might do so -- although that might be beyond my current ASM
abilities.

To patch the .asm into your ROM, use xkas; I recomment FF3usME to
modify the items names, etc. Screenshots have been included with
recommended item settings, although obviously you can name them
whatever you want.

NOTE: This patch currently overwrites the functionality used by
Rename Cards, rendering them defunct -- this frees up an item ID
($E7) that can be used for one of the Stat Increase items,
though, and they're /rename cards/, so that shouldn't be much of
a problem.

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

By overwriting a check for the Rename Card item ID, this code
allows a jump to a new block of code (at C3/F200, in a large
chunk of free space) that checks against a series of six item
IDs to see if the item being used will permanently increase the
associated stat for the character upon whom it's being used.

This patch does NOT modify any items names, descriptions, or
properties. It is intended to be incorporated in a larger hack.
Existing items will need to be overwritten, and their IDs
written into the code in the .asm file where currently there are
placeholder IDs (#$01 through #$06).


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

v1.0 - July 8, 2013


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

Madsiur, for pointing me to the Rename Card check in the first
place, and Imzogelmo, Lenophis, assassin, Dragonsbrethren, and
Novalia Spirit for the C3 disassembly at slickproductions.org.
This code would not have been possible without them.