Pie v1.2.1

Pie v1.2.1

A minor release of Pie with a few new tweaks to library behaviour and a handful of small bugfixes.

Changelog

• Pie will now verify that an equipped item includes the updated Item class before attempting to make Pie function calls, mitigating a crash caused by LightEquipItem when trying to start a Light World battle.

This change does not make LightEquipItem compatible with Pie features, it only allows battles in the light world to co-exist with the library.

• Both the reflect effect and thorns effect can no longer deal lethal damage.
• The above change in turn fixes a bug where the battle continues for part of a turn when no enemies are alive if the last enemy was killed by either effect during a wave.
• Fixed a few typos where functions were not receiving enough arguments or receiving the wrong arguments.
• Added a small yellow sparkle and audio cue effect whenever a HealItem with a future heal is used.

Installation

To install Pie, download the Source code from below, and place it into the libraries folder of the target mod.

The pie_examples archive has received no changes since the last release, so will not be provided here. It can be obtained from the previous release, v1.2.0, instead.

Pie v1.2.0

Pie v1.2.0 for Kristal v0.8.0

A new release of Pie to accompany changes to the repository structure, as well as (another) rework to HealItem heal bonuses.

Changelog

• The Pie library's library ID has changed. It is now pie, instead of passiveitemeffects.
• The Pie repository no longer includes pie_examples, and the Pie library is placed directly at the root instead. (pie_examples continues to be available through the releases section here.)
• HealItems can now receive bonus multipliers and flat increases from the same item.
• HealItems now accumulate all of the bonuses from every equipped item before applying them. By default, the overall multiplier is applied first, and then the flat bonus.
• The config option healMultiplierTakesPriority has been added, defaulting to true, which controls whether the healing multiplier is applied before or after the total flat healing bonus.
• The code has received an overhauled documentation to follow the structure of Kristal's code documentation, and be clear and concise to understand.

Installation

To install Pie, download the Source code from below, and place it into the libraries folder of the target mod.

Additionally, the pie_examples archive below is a helpful companion library which demonstrates how to use many of the features provided within Pie.

Pie v1.1.1

Pie v1.1.1

A micro-sized update to Pie! It includes just one small, new feature.

Changelog

Since the last release of Pie, the following feature has been added:

• Starting Tension, usable via starting_tension or Item:getStartingTensionAmount(), allowing for starting battles with variable amounts of tension when equipping an item.

As usual, a new example has been added to the pie_examples library to demonstrate this feature.

Additionally, a copy of the software license has been added to the pie folder to ensure it is properly distributed with the library.

Installation

To use Pie in your mod, donwload the source code below to any location, and extract the contents. Then, look for the pie folder, and place it into the libraries folder of your mod.
The source code also includes the pie_examples library separately, containing many helpful examples of how to use Pie.

Pie v1.1.0

Pie v1.1.0

A new release of Pie, coming with a handful of new features and improvements, including a heal bonus overhaul and built in dodge, thorns and reflect effects!

Changelog

Since the last release of Pie, the following features have been added or changed:

• Customisable Dodge, Thorns, and Reflect abilities for equipment.
• New Callbacks Item:onDodge(), Item:onThorns(), and Item:onReflect().
• New Library config options alwaysDoHealItemHealing, alwaysApplyHealBonus, passiveHurtCanKill, and passiveEffectCostCanKill for modifying aspects of library behaviour.
• HealItems will no longer call heal() and trigger the healing effect if they would heal 0 hp. (This can be reverted by setting alwaysDoHealItemHealing to true.)
• HealItems can now set block_heal_bonus to be unaffected by item heal bonuses.
• Heal bonuses can now specify an item specific bonus in the heal_bonuses table.
• Heal bonuses can now specify a multiplicative factor to boost healing by with multiplicative_heal_bonus/multiplicative_heal_bonuses/getMultiplicativeHealBonus() rather than a fixed value. This will override value heal bonuses if set.
• PartyMember:getHealBonus() is now PartyMember:applyHealBonus() and now returns the final amount of healing, instead of the amount of extra healing to add to the amount. Additionally, Item:applyHealBonus() is called to apply the bonus for each item, and should also return the full amount of healing after applying its effect.
• Heal bonuses will no longer apply to items if their base healing is 0. (This can be reverted by setting alwaysApplyHealBonus to true.)

In addition, the pie_examples library has received new examples/changes to show off some of the new features in this update.

Installation

To use Pie in your mod, donwload the source code below to any location, and extract the contents. Then, look for the pie folder, and place it into the libraries folder of your mod.
The source code also includes the pie_examples library separately, containing many helpful examples of how to use Pie.

Pie Version 1.0.0

Pie Version 1.0.0

The first release of Passive Item Effects!

Features

• Lots of new callbacks in the Item Class.
• Equipment items can now carry out many passive effects, controlled by defining their passive prefixed variables or extending their respective getter functions.
• Equipment items can now define heal_bonus (or respective getter function) which will increase the healing of HealItems whilst equipped.
• Equipment items can now define victory_heal (or respective getter function) which will heal the holder at the end of battle whilst equipped.
• HealItems can now perform future healing by defining future_heal_amount and future_heal_turns (or respective getter functions).

Installation

To use Pie in your mod, donwload the source code below to any location, and extract the contents. Then, look for the pie folder, and place it into the libraries folder of your mod.
The source code also includes the pie_examples library separately, containing many helpful examples of how to use Pie.