﻿Phantom Blade Zero All-in-One Mod 1.8.6 (Nov 10) — Nexus build (no DLL)
For the Nov 4 patch (Steam PC) · UE4SS Lua mod
Languages: English / 한국어 / 中文 / 日本語 (follows the game's language automatically)
==========================================================

■ Install (drag & drop, no installer)
 [Required] UE4SS for Phantom Blade Zero — Nexus Mods mod 5  https://www.nexusmods.com/phantombladezero/mods/5
 1) Close the game completely and install UE4SS (mod 5) first
 2) Drag the PBZ folder from this archive onto your game's PBZ folder → choose "Replace"
      C:\Program Files (x86)\Steam\steamapps\common\PBZ
    (other drive: Steam → right-click the game → Manage → Browse local files)
 3) When done you should have
      ...\PBZ\platform\steam\ue4ss\Mods\PBZCompassMap\Scripts\main.lua
 4) Start the game
 * This archive has no DLL or script files at all (only Lua, text and pictures) — the controller is read through the game's own input
 * Your mod settings (settings.txt) are not in the archive, so updating never overwrites them
 * Updating from 1.8.1 or older: you may delete Scripts\PBZPad.dll (no longer used)
 * Uninstall: delete ue4ss\Mods\PBZCompassMap

■ First install — everything is OFF
 A fresh install starts with every feature off, so the mod costs nothing until you choose.
 If you see "All-in-one mod installed — everything is off" in game, it's working.

 Turning features on
  1) Open the mod panel:  keyboard Home  /  pad L3+R3 three times (the game pauses briefly)
  2) ◀ ▶ (arrow keys) to move between tabs (Settings · Screen · Convenience …)
  3) ↑ ↓ to pick, ✕ (Space) to toggle → saved immediately
  4) Close: ○ / Home

 Suggested setups
  - Collecting:     Settings tab → Map icons · Minimap · Trail on
  - Just guidance:  Settings tab → Trail · Auto-track new quests on
  - Lightest:       Map icons only (works only while the map is open)

■ Language
 - The mod's screen text follows the game's language: English, Korean, Chinese or Japanese.
   Any other game language shows English.
 - Settings tab, top row 「Language」: Auto (game language) / 한국어 / 中文 / 日本語 / English
 - Boss, bell, weapon and area names come straight from the game's own language files, so they match the game.
   The walkthrough, collectible list and quest details have their own file per language.

■ Features at a glance (mod panel tabs)
 [Settings]  map · minimap · guidance
  - Map icons: 1,500+ spots of materials, currency, chests and readables + Blackstone, Amber, Memory Flowers,
    weapons, accessories, medicines, bells, bosses and quest goals. Picked up = gone at once.
    Colored frame + the item's real icon, adjustable size
  - Minimap: nearby item names, distance and height (▲ above ▼ below); under it "Overall completion · this map %"
    (same rules as the game's map screen)
  - Compass: heading strip at the top + nearby collectibles. Two looks: ink brush (東南西北, red needle, seal) / plain strip
  - Trail: a line along the real walkable path; locked doors tell you why and which item opens them
  - Auto-track: after a pickup → the next item / after taking a new quest → its goal
  - Info window: cursor on a map icon = name, description and how to get it
  - Teleport: R3 on the map / Ctrl+G (keeps the game's rules: only areas whose bell you rang, not in combat or story)
  - Difficulty label (renameable), bells shown, beaten bosses hidden
  - Quest details (quest window): the step's full description under the short goal line.
    The game has these texts but never shows them (and in English they are blank) — 194 of them translated
 [Screen]  field of view, camera distance and height
 [Convenience]  movement speed (walk/run only), auto pickup (material piles), faster bell / locked door / boat on-off motions,
                sticky lock-on (flick the right stick to switch),
                field item highlight (glow · icon), Boss Rematch (below)
 [Show]  which kinds appear on the map and minimap
 [Quests]  quests in progress + what to do now, ✕ = trail to it
 [Quick ending] / [True ending]  per-chapter checklist: main, true ending requirements, side quests, what's left for 100%
 [Guide]  walkthrough from chapter 1 to the ending (below)
 [Bosses]  beaten / remaining bosses (chapter or level order), trail to bosses in this area,
           press a beaten boss to move near its room
           Rematch boost: Default · x1.5 · x2 · x3 (HP · attack) / time and hits recorded, best record per boss

■ Walkthrough order (「Guide」 tab)
 - From chapter 1, Weeping Creek Valley, to the chapter 9 ending on Mount Soulrend, in story order, bell to bell,
   each next place guided by a trail (24 sections, 504 steps)
 - How: mod panel → 「Guide」 tab → pick a step, ✕ (the trail turns on by itself if it's off)
 - Ringing a bell, picking up an item or killing a boss moves to the next step; things already done are skipped
 - 「↻ Sync with save progress」 reads your save (bells rung, bosses beaten) and jumps to the right step
 - !! = missable / must be done before that point (e.g. the herbs for Apprentice Healer before Jing Ye)
 - 「… — come back (after ch.N)」 = places that need a Phantom Edge or key from a later chapter
 - Things with no map position (inside chests, rewards, dialogue) show up in the next step as "On the way: …"
 - If you track something else the guide waits and picks up again; turning tracking off stops the guide (your step is kept)

■ Heavy features (turn these off first if frames are tight)
 - Field item highlight (draws glows and icons constantly)
 - Minimap / compass (drawn every frame)
 - Trail (path finding)
 Map icons and the Quests / Bosses tabs only run while open, so they cost almost nothing.
 With nothing turned on the mod does almost no work.

■ Boss Rematch (Convenience tab)
 - When on, beaten bosses' spots show an emblem and the boss name → press E (pad ✕) in front of it = the boss comes back
 - Two-phase bosses: beat phase 1 and phase 2 follows / the red 「Phase challenge」 next to it = phase 2 only
 - In the Bosses tab, press a beaten boss (beaten · rematch) to move near its room (same area, rung bells only)
 - Fall and that run ends → retry from phase 1 / beat the last phase = 「Rematch complete」
 - Not shown for bosses you haven't beaten or areas you haven't been to; never two of the same boss
 - Save protection: your save is copied to save_backup in the mod folder right before the fight, and the next launch
   restores it automatically (no change to drops, quests or boss records stays). Play after the rematch is rolled back
   too — to keep it, press Ctrl+Shift+N before quitting

■ Controls
 Pad (DualSense / DualShock 4 / Xbox) — uses L3+R3, which the game doesn't use
  L3+R3 once        minimap on/off
  L3+R3 twice       tracking off / track the nearest item not picked up
                    (cursor on an NPC dialogue choice = track that quest; during a locked-door hint = track the key)
  L3+R3 three times open the mod panel   ○ = close
  hold L3+R3 1 s    whole mod off/on
  Map screen: cursor on an icon = info / R3 = teleport there (the map closes) / △ = track it (the map closes)
  * R3 and △ keep their own map jobs: with the cursor NOT on an icon, R3 only resets the view and △ only shows the whole map
  * The kinds panel on the map is keyboard-only (F); with a pad, change the kinds in the mod panel (L3+R3 three times)
  * ✕ on the map is the game's own button (Travel Charm = uses a ticket), so the mod doesn't use it

 Keyboard
  Home mod panel   F kinds panel on the map   arrows / Space panel control
  T on the map: track / outside: tracking off   F7 track nearest item   Ctrl+G teleport (map)
  F2 map icons   F3 trail   F6 compass   F8 minimap   F9 whole mod off/on
  E (in front of a rematch emblem)   Ctrl+Shift+N keep the rematch result
  * To change the panel key (Home): the PanelKey=Home line in ue4ss\Mods\PBZCompassMap\settings.txt
    (Home / Insert / End / Delete / PageUp / PageDown / F8 / F10 / F12, then restart the game)

■ 1.8.6 changes (Nov 10)
 - Fixed: the compass followed the camera in small jumps when turning - it moved only 25 times a second. It now follows every frame, like the trail and the minimap

■ 1.8.5 changes (Nov 10)
 - [New] Trail effect 7 "Red string (bell effect)": the red string you see near a bell (the game's own effect) runs along
   the walkable route at waist height - three strands twisting round each other for the first 24 m, one strand on to the
   end (60 m by default), following the real ground up stairs and ledges.
   Settings: Trail style = Game effect -> Trail effect = 7, "Red string strands" (3/2/1), "Red string length" (30/60/100 m)
 - [Changed] The yellow base line no longer overlaps the effects: it starts exactly where the effect / arrows end (after
   the whole red string). In a fight, when effects hide, the line shows from the start
 - [New] "Death spots on the map" on/off (off by default)
 - [New] "Hide map icons in unexplored areas": the mod's icons go under the game's map fog, so places you haven't been
   stay hidden
 - [Fixed] Error "main.lua:248 ... string.match ... lineTick": the on/off check read the setting text several times a frame
   and could throw; it now remembers each value and can't fail. An error in a frame update no longer stops the mod (log.txt only)

■ 1.8.4 changes (Nov 10)
 - [Fixed] Crash / stutter with the True Ending and Guide tabs open: the panel rebuilt every row of the tab on every
   frame, reading the game's quest, item and boss tables hundreds of times a second. Rows are now built when the tab
   changes, after an action, and at most once a second; ↑↓ only moves the bar
 - [Fixed] Error "main.lua:8431: attempt to perform arithmetic on a function" (the frame timer): a bad clock reading
   now only skips the timing, never the mod's work
 - [Fixed] Map icons on Pangzhen that aren't there: Pangzhen Mirage (Ch.8, the dream Pangzhen) lies over Pangzhen (Ch.4)
   on the same map, and its pickups were drawn like normal ones. Parts of another chapter are now drawn faint and their
   info box says "Pangzhen Mirage · Ch.8 — not where you are now"
 - [Fixed] Guide tab: it matched your save only on the very first run. Now, while no guiding runs, it follows your save
   once per game session when you first open it ("Guide: next step by your save 3-5"), and the bar starts on that step
 - [Fixed] A hitch every 5 s with Move speed set, and every 10 s with FOV set (40-55 ms each): the FOV camera part is now
   found once per body, and the move-speed keep-alive check runs every 20 s (a new body / a changed setting still at once)
 - [Fixed] The trail could break for a frame ("line error" in log.txt) when a point lay exactly at the camera
 - [Fixed] "Track the next item after a pickup" picked items behind doors that can't be opened yet: when the way ends at
   a locked door or a closed path, that item is skipped and the next nearest is taken (items you pick by hand are never skipped)

■ 1.8.3 changes (Nov 10)
 - [Fixed] Crash: opening the settings panel (Home) on the map and pressing ↑↓, and the panel staying up after switching
   the system menu to Quests / Character (incl. the crash when paging the Boss tab). The settings panel no longer opens
   over the map or a game menu, and closes when the menu page changes
 - [Fixed] Pad Start / opening the map sometimes opened the settings panel too (stick clicks during menus counted as taps)
 - [Fixed] The Boss tab asked the game hundreds of times a second while shown → once every 2 s (less stutter, no crash)
 - [Fixed] Game screens (bell menu, upgrades, shop, inventory, settings, letters...) now hide the compass, minimap and trail
 - [Fixed] Hovering a map icon showed no description: the name, kind and keys now show even with the info box setting off
 - [Fixed] Every loose pile on the map read "Materials · currency" → its real contents (e.g. a book page + Remnant Dust ×431)
 - [Fixed] "Currency" → the game's own name, "Remnant Dust ×amount"
 - [Fixed] Rewards handed over in a dialogue (e.g. the Xigu axe quest) stayed on the map: gone after ~30 s near the spot with nothing there
 - [New] Compass in boss fights (Settings tab): while the boss health bar is up the compass hides (default) / moves under it / stays. Kept through phase changes
 - [New] F8 (pad L3+R3 once): if the minimap is switched off in the settings, it switches it on (saved)
 - [New] Trail: "Also draw the ground line" option (off = arrows / effects only). The line has depth: thicker and stronger near you, thinner and fainter far away

■ 1.8.2 changes (Nov 9)
 - [Changed] No DLL any more: the 1.8.1 archive was quarantined by Nexus because it bundled UE4SS and the controller
   helper DLL. UE4SS now comes from Nexus mod 5, and the controller is read through the game's own input
 - [Changed] Map controls on a pad: R3 on an icon = teleport, △ on an icon = track (the map closes and the trail shows at once)
 - [Fixed] Teleporting far away (or to an upper floor) could drop you through the ground before it loaded — you are now
   held in place until the ground is there
 - [Fixed] The minimap showed no terrain until you had opened the game's map once in that area
 - [Fixed] 「Minimap: fitting · move a little inward」 stayed at the edge of a map — it now measures a little way in instead

■ 1.8.1 changes (Nov 9)
- Fixed: the bell's fast-travel map now shows the map icons and the info box too (it is its own screen, not the menu map)

■ 1.8.0 changes (Nov 9, full release)
 - [Changed] All 1,546 collectible spots and how to get them were extracted again by this mod straight from the game
   files (all 80,947 world cells read). Names and kinds come in the game's language, with "Inside the chest — open it" /
   "Lying there — just pick it up"
 - [Changed] Boss spawn positions replaced with values read from the game's own level files
 - [New] Ink-brush compass (東南西北 in brush strokes, red needle, seal, ink drops) — Settings tab 「Compass style」
   (the plain strip is still there)
 - [New] Sticky lock-on (Convenience tab): the lock stays on the enemy you picked — another enemy attacking or turning the
   camera no longer moves it. If it dives or blinks away the lock follows while it can; if it dies, the nearest enemy.
   Flick the right stick fully to switch to the enemy that way (8 directions). R3 lets go. Barrels and the like are never locked
 - [New] Faster locked-door check and boat on/off motions (same switch as the bell)
 - [Fixed] the same motion played twice in a row went back to normal speed the second time
 - [Changed] the 294 dialogue-choice / quest notes were removed (not written by this mod)

■ 1.7.0 changes (Nov 9)
 - [New] Full English: every panel, notice, map/minimap text, the 504-step walkthrough, the collectible list
   (1,500+ spots with English hints) and the 194 quest details. Any game language other than
   Korean / Chinese / Japanese now shows English
 - [New] 「Language」 option: English added (Auto / 한국어 / 中文 / 日本語 / English)
 - [Changed] Boss Rush and the mini Roguelike were taken out of the Bosses tab (the full roguelike is the separate mod
   Honmun). Boss Rematch stays, with a new emblem
 - [Fixed] the map's info box stayed on screen on the other menu pages (Quests, System...)

■ Don't use together with
 - Pre-patch PBZCompass / PBZMapMarkers pak mods (Content\Paks\~mods) → red menus or broken {ButtonText}
 - Some pak mods that change game scripts (if menus break, take other pak mods out of Content\Paks\~mods one by one)
 - Movement Speed mod (the same feature is inside this mod — use only one)

■ Known limits
 - Steam Nov 4 patch (build 26367565) only. Epic and pre-patch versions won't work
 - Quest steps with no position on the game map show a description instead of a trail
 - Very distant items show only part of the path (it continues as you get closer); the trail shows through walls
 - A future game update may need new UE4SS signatures

■ If something goes wrong
 - Logs: ue4ss\Mods\PBZCompassMap\log.txt  (UE4SS's own log: ue4ss\UE4SS.log) — please attach them to reports
 - Crashes on every launch: delete ue4ss\Mods\PBZCompassMap\settings.txt (resets this mod's settings only)
 - Turn off just this mod: delete ue4ss\Mods\PBZCompassMap\enabled.txt
 - "AOB scans could not be completed" in UE4SS.log → the signatures don't match your game version

■ Credits (please keep them)
 - Made by: an anonymous author of the DC Inside Phantom Blade Zero game-system gallery
 - UE4SS (RE-UE4SS team, MIT license — ue4ss\LICENSE)  https://github.com/UE4SS-RE/RE-UE4SS
 - UE4SS for Phantom Blade Zero (Nexus Mods mod 5)  https://www.nexusmods.com/phantombladezero/mods/5
 - UE4SS signatures for the November patch: made for this mod by analysing PBZ.exe (thanks also to BabaBooey88 for sharing first)
 - Collectible and boss positions, how to get them, names: all extracted by this mod from the game files
 - Compass art: drawn new for this mod (brush glyphs: Yuji Boku font, SIL Open Font License)
