Single Press QTE

Button-mash QTEs complete with one press and hold QTEs with a tap. Each kind has its own switch in config.lua, live in game.

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

Single Press QTE

Button-mash QTEs complete with one press and hold QTEs with a tap. Each kind has its own switch in config.lua, live in game.

What it does

The game has QTEs that want a button mashed until a bar is full, and QTEs that want a button held for a time. This mod changes one number of each:

  • Button-mash QTEs: one press fills the bar. The mod sets the progress of one press to the full bar.
  • Hold QTEs: a tap is enough. The mod sets the hold time to 0.001 seconds (HoldSeconds).
  • QTEs that want one timed press stay as they are.
  • You still press the button yourself: the mod presses nothing and decides no QTE for you.
  • Each kind has its own switch in config.lua (Mash, Hold), and the file is read again during play.

It is a UE4SS Lua script: it changes the two numbers of a QTE while the game runs. It replaces no game file and writes nothing into your save.

Screenshots

Single Press QTE

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_singlepressqte_<version>.zip).
  3. Unpack it into the game folder platform\steam\, next to the game's exe. It adds the folder ue4ss\Mods\phantombladezero_singlepressqte\ (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 [Single Press QTE] <version> loaded., a few seconds later [Single Press QTE] Hook set on new mash QTEs (RepeatedPressQTETask). and the same for hold QTEs, and a line for each of the first QTEs it changed, for example [Single Press QTE] mash QTE 1 (new): ....

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_singlepressqte\; after the next game start the QTEs are the game's own again.

How to use

Nothing to set up. In a button-mash QTE press the shown button once; in a hold QTE tap it.

Settings

The settings are in platform\steam\ue4ss\Mods\phantombladezero_singlepressqte\Scripts\config.lua. Open it with a text editor, change a value and save: the mod reads the file every 5 seconds, so you see the change in the game without a restart. A file it cannot read (for example a typo) keeps the last settings. UE4SS.log shows the settings in use in the line [Single Press QTE] Settings: ..., and names each value it could not use.

Setting Default What it does
Enable true false: the mod changes nothing, the game as normal
Mash true true: a button-mash QTE completes with one press; false: the game's own
Hold true true: a hold QTE completes after HoldSeconds; false: the game's own
HoldSeconds 0.001 How long a hold QTE must be held, in seconds (0.001 to 10). 0.001 is a tap; a QTE that is shorter already stays as it is
LogDetail false true: UE4SS.log also names the QTEs the mod saw and left alone (for tests)

A QTE that the mod has changed stays changed until it ends, also when you turn its switch off in the meantime.

Compatibility

  • Game version: Steam build 26367565 (CL-302256_JKS-17280).
  • Tested with UE4SS v4.0.0.
  • Another mod that eases the same QTEs writes the same two numbers, for example Auto Execution with its setting OtherQTE at OnePress or Auto (it is Off by default). Use one of them for these QTEs.

Known issues

None yet.

How to build

There is nothing to build: src\phantombladezero_singlepressqte\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.