Live by the Blade

A timed parry or a dodge through an attack heals you; the medicine gourd has no charges. Your health comes from skill.

  • MIT · open source
  • 0 stars
  • Latest release v1.6
  • Updated 4 days ago
  • Gameplay
Description

Live by the Blade

A timed parry or a dodge through an attack heals you; the medicine gourd has no charges. Your health comes from skill.

What it does

Health comes from skill, not from the gourd:

  • A dodge that makes an attack miss heals 10% of your maximum health, once per dodge, however many hits it avoids.
  • A timed parry heals 10% of your maximum health. It must be right on time (the game's "perfect" grade); a parry that is only nearly on time does not heal, and neither does a block (holding the parry button).
  • The red-light perfect dodge and the blue-light parry heal too.
  • The medicine gourd has no charges. A rest at a bell still heals you fully and refills the gourd, and the mod empties it again.
  • The game's potion tutorial in the valley needs you to drink once: there the gourd gets one charge for that drink, and it is empty again right after.
  • A heal never goes above your maximum health. Other medicine that you find stays as it is.

Both heal amounts are settings. It is a UE4SS script; it changes no game file.

Screenshots

Live by the Blade

How to install

  1. Install UE4SS for Phantom Blade Zero, for example UE4SS (its zip phantombladezero_ue4ss_<version>.zip: the official UE4SS build with a config that makes it run in this game).
  2. Download the zip of the latest release on GitHub (phantombladezero_livebytheblade_<version>.zip).
  3. Unpack it into the game folder platform\steam\, next to the game's exe. It adds the folder ue4ss\Mods\phantombladezero_livebytheblade\ (with the file enabled.txt, UE4SS starts it by itself).
  4. Start the game.

To check that it runs: platform\steam\ue4ss\UE4SS.log has the line [Live by the Blade] <version> loaded.

To update the mod, replace the folder with the one of the new release; to keep your settings, put your old Scripts\config.lua back (a setting that it does not have keeps its default). To remove it, delete the folder ue4ss\Mods\phantombladezero_livebytheblade\. The game saves the empty gourd: after you remove the mod, rest at a bell once to fill it again.

How to use

Nothing to do: dodge through attacks and parry at the right moment to stay alive.

Settings

The settings are in platform\steam\ue4ss\Mods\phantombladezero_livebytheblade\Scripts\config.lua. Open it with a text editor, change a value and save: the mod reads the file every 5 seconds, so the game uses it without a restart (a heal amount at the next heal). UE4SS.log shows the settings in use in the line [Live by the Blade] Settings: ..., and names each value it could not use.

Setting Default What it does
DodgeHealPercent 10 A dodge that makes an attack miss heals this percent of your maximum health (0 to 100)
ParryHealPercent 10 A timed parry heals this percent of your maximum health (0 to 100)
LogHeal false true: UE4SS.log names each heal, the medicine charges and every health change (for tests and bug reports)

Compatibility

  • Game version: Steam build 26367565 (CL-302256_JKS-17280).
  • Tested with UE4SS v4.0.0.
  • Works with Witch Time (the same triggers). With Heaven or Hell and its one-hit deaths, the heal has no use.
  • Easier Parry and Dodge widens the timed parry and dodge windows, so the heal comes more often.

Known issues

None yet.

How to build

There is nothing to build: src\phantombladezero_livebytheblade\Scripts\main.lua is the mod. tests\test_main.py runs the script outside the game with Lua 5.4 (lupa) and mocks of UE4SS: python tests\test_main.py. README.md has the details.

Credits

Made by Kintaro. MIT license: you may use, change and share this mod. UE4SS is made by the UE4SS-RE team. Phantom Blade Zero belongs to its makers.