PBZ Auto Weapon Switch

🇬🇧 English · 🇵🇱 Polski · 🇫🇷 Français · 🇪🇸 Español · 🇺🇦 Українська

An accessibility mod for Phantom Blade Zero (PC) that switches weapons for you at the right moment: to recover Shachi, to get out of Break, and to keep a combo going.

♿ This mod was created with players with motor disabilities in mind. Weapon switching in Phantom Blade Zero is an extra, well-timed button press in the middle of combat. If that is hard or impossible for you, this mod does it automatically, exactly when the game's own tutorial says you should.

⚠️ An official, legally purchased version of the game is required for the mod to work.

Works well together with PBZ Auto Parry & Dodge (automatic perfect parry and perfect dodge). Each mod can be installed on its own.

---

✨ What it does

The switch is the weapon's switch attack – it has invulnerability frames and refills Shachi. The mod uses it in three situations (only in combat, only with two weapons equipped, only when the switch is off cooldown):

Situation	What the mod does
Shachi below 20 %	Switches at once to refill Shachi (the game's own tutorial rule).
You are in Break	Switches to get you out of Break. If the game blocks the switch in the first moment of the stagger, the mod tries again about 1 s later.
A combo is about to drop	When a light or heavy attack sits in its combo window and no next attack follows, the mod switches so that the switch attack continues the chain. Only when Shachi is at least 35 %, so the cooldown stays available for recovery.

• On-screen messages – when you load a save, when you change a setting, and on every automatic switch (for example “Auto Weapon Switch: Shachi recovery”).
• Your settings are remembered between game sessions.
• Nothing in the game is modified – the mod only adds files next to the game.

Tested results (Steam version)

Rule	Automatic switches	Result
Shachi recovery	9	Shachi went from 0–20 % back to 83–100 %
Leaving Break	3	Break ended every time, Shachi up to ~98–100 % (second attempt after ~1 s)
Keeping the combo	7	Switch attack continued the chain

📋 Requirements

• An official copy of Phantom Blade Zero for PC (Windows 10/11).
  • Steam – tested ✅
  • Epic Games Store – supported by the installer, not tested yet
  • GOG – the game is not on GOG at the moment; the installer will find it if it appears there
• Two weapons equipped in the main weapon slots (with one weapon there is nothing to switch to).
• An internet connection for the first installation (the installer downloads UE4SS, the free mod loader for Unreal Engine games, unless it is already installed).
• The game is single-player only and has no anti-cheat. This mod does not touch DRM or online features.

🚀 Easy installation (recommended)

1. Download PBZ-AutoWeaponSwitch-v1.0.1.zip from the Releases page.
2. Unpack the zip anywhere (for example on the Desktop).
3. Close the game.
4. Double-click install.bat.
   • If Windows shows “Windows protected your PC”, click More info → Run anyway (the installer is a plain text script – you can open install.ps1 in Notepad to read it).
5. When it says Done!, close the window.
6. Start the game normally. After loading a save you will see: Auto Weapon Switch: ON | Combo extension: ON

If the game is not found automatically, the installer asks for the game folder: Steam → right-click Phantom Blade Zero → Manage → Browse local files; Epic → Library → ⋯ → Manage → Installation folder. Copy that path and paste it into the installer window.

If PBZ Auto Parry & Dodge is already installed, the installer keeps its UE4SS and just adds this mod.

🎮 Controls

Key	Action
F10	Auto weapon switch ON / OFF
F6	Combo extension ON / OFF (Shachi recovery and Break still work)

(F11 is not used because the game uses it for fullscreen.) Every change is shown on screen for 3 seconds and saved automatically. You can still switch weapons yourself at any time.

🗑️ Uninstall

Close the game and double-click uninstall.bat. It removes the mod. UE4SS is removed only if this installer put it there and no other PBZ mod still uses it (you will be asked first).

🔧 Manual installation (advanced)

1. Open the game folder that contains the large PBZ.exe (Steam: …\steamapps\common\PBZ\platform\steam\).
2. If UE4SS is not installed yet: download the latest UE4SS_v…zip (not zDEV-…) from UE4SS experimental-latest and unpack it there, so that dwmapi.dll and the ue4ss folder sit next to PBZ.exe.
3. Copy the contents of this package's ue4ss-config folder into that ue4ss folder (MemberVariableLayout.ini and the UE4SS_Signatures folder). The game needs this config to run UE4SS.
4. Copy the mod\PBZAutoSwitch folder into ue4ss\Mods\.
5. Open ue4ss\Mods\mods.txt and add the line PBZAutoSwitch : 1 above the Keybinds line.

❓ Troubleshooting

• No message after loading a save → check that ue4ss\Mods\mods.txt contains PBZAutoSwitch : 1 and look at ue4ss\UE4SS.log for errors.
• The mod never switches → check that two weapons are equipped and that you are in combat.
• The game does not start or crashes at start-up → run uninstall.bat (or delete dwmapi.dll next to PBZ.exe). A game update can change the code that UE4SS needs; check this page for an updated version.
• Something else is wrong → open ue4ss\Mods\PBZAutoSwitch\Scripts\main.lua in Notepad, change log = false to log = true, play, and attach autoswitch.log (from the mod folder) to an issue.

⚙️ How it works (short)

Once per frame the mod reads the player's state from the game (Shachi, Break, combat, combo window, weapon cooldown) and, when a rule matches, starts the switch attack through the game's own input function – the same one the controller button uses. Every switch is confirmed by a weapon or cooldown change, and retried if the game refused it. The mod is a UE4SS Lua script; it ships no game files.

🙏 Credits

• UE4SS – the Unreal Engine scripting system (MIT).
• Phantom Blade Zero UE4SS config (MemberVariableLayout.ini, signatures) – KintaroModding, submitted as UE4SS-RE/RE-UE4SS#1484; signature patterns from the UE4SS team's custom game configs (MIT).
• Built with the help of Claude Code (Anthropic's Claude AI), which analysed the game's combat logic and wrote the mod together with the author; all results were tested in the real game.

📄 License & disclaimer

Code: MIT License. This is an unofficial fan project, not affiliated with or endorsed by S-GAME. Phantom Blade Zero is a trademark of S-GAME. Use at your own risk – keep a backup of your save files.

See the changelog for version history.