﻿팬텀 블레이드 제로 올인원 모드 1.8.6 (11월 10일) — 넥서스판 (DLL 없음)
11월 4일 패치(스팀 PC) 대응 · UE4SS Lua 모드
==========================================================

■ 설치 (끌어다 놓기, 설치 파일 없음)
 [필수] UE4SS for Phantom Blade Zero — 넥서스 5번 모드  https://www.nexusmods.com/phantombladezero/mods/5
 1) 게임 완전히 끄고, 5번 UE4SS 를 먼저 설치
 2) 이 압축 안의 PBZ 폴더를 게임 폴더의 PBZ 폴더 위에 끌어다 놓기 → "덮어쓰기"
      C:\Program Files (x86)\Steam\steamapps\common\PBZ
    (다른 드라이브면: 스팀에서 게임 우클릭 → 관리 → 로컬 파일 보기)
 3) 다 넣으면 이 파일이 있어야 함
      ...\PBZ\platform\steam\ue4ss\Mods\PBZCompassMap\Scripts\main.lua
 4) 게임 켜기
 ※ 이 압축에는 DLL·실행 파일이 하나도 없음 (루아·글·그림만). 패드는 게임 자체 입력으로 읽음
 ※ 이 모드 설정 settings.txt 는 압축에 없어서 덮어써지지 않음
 ※ 1.8.1 이하에서 업데이트: Scripts\PBZPad.dll 은 이제 안 쓰니 지워도 됨
 ※ 지우기: ue4ss\Mods\PBZCompassMap 폴더 삭제

■ 처음 설치하면 — 전부 꺼져 있음 (1.4.1부터)
 가볍게 쓰고 싶은 사람이 많아서, 새로 설치하면 모든 기능이 꺼진 상태로 시작함.
 게임 화면에 "올인원 모드 설치됨 — 전부 꺼져 있음" 안내가 뜨면 정상.

 기능 켜는 법
  1) 모드 패널 열기:  키보드 Home  /  패드 L3+R3 세 번 (게임이 잠깐 멈춤)
  2) ◀ ▶ (키보드 방향키) 로 「설정」·「화면」·「편의」 탭 이동
  3) ↑ ↓ 로 고르고 ✕ (키보드 스페이스) 로 켜기/끄기 → 바로 저장됨
  4) 닫기: ○ / Home

 추천 조합
  - 수집 위주:     설정 탭 → 지도 아이콘 · 미니맵 · 추적선 켜기
  - 길 안내만:     설정 탭 → 추적선 · 새 퀘스트 자동 추적 켜기
  - 최대한 가볍게: 지도 아이콘만 켜기 (지도 열었을 때만 동작)

 ※ 1.4.0 이하에서 덮어 설치한 사람은 원래 쓰던 설정(settings.txt)이 그대로 유지됨.
   전부 끄고 싶으면 각 탭 맨 위 「이 탭 설정 초기화」 두 번 누르기.

■ 기능 한눈에 (모드 패널 탭)
 [설정]  지도·미니맵·길안내
  - 지도 아이콘: 재료·화폐·상자·읽을거리 1,500여 곳 + 흑석·호박·기억의 꽃·무기·장신구·약·종·보스·퀘스트 목표.
    먹으면 바로 사라짐. 색 테두리 + 실제 아이템 아이콘, 크기 조절
  - 미니맵: 가까운 템 이름·거리·높이(▲위 ▼아래), 아래에 "전체 완료도 · 이 지도 %" (게임 지도 화면과 같은 기준)
  - 나침반: 화면 위 방위 띠 + 가까운 수집품. 모양 2가지: 먹 붓(東南西北 · 붉은 바늘 · 인장) / 기본 띠
  - 추적선: 실제 걸어갈 수 있는 길로 선 표시, 잠긴 문은 이유와 필요 아이템 안내
  - 자동 추적: 먹으면 다음 템 / 새 퀘스트 받으면 그 목표
  - 정보창: 지도 아이콘에 커서 = 이름·설명·얻는 법
  - 순간이동: 지도에서 R3 / Ctrl+G (게임 규칙 지킴: 종 친 구역만, 전투·스토리 중 X)
  - 난이도 표시 (초보자 / 중급자 / 상급자 / 최상급자, 이름 바꾸기 가능), 종 표시, 잡은 보스 숨기기
  - 퀘스트 상세 설명 (퀘스트 창): 목표 줄 아래 그 단계 상세 설명 (1.6.2, 기본 켜짐)
  - 언어 (Language): 자동(게임 언어) / 한국어 / 中文 / 日本語 / English — 설정 탭 맨 위
 [화면]  시야각, 카메라 거리·높이
         (1.4.1: 색수차·모션블러·필름그레인·안개·블룸 같은 화면 효과/그래픽 옵션은 일부 PC에서 바로 튕겨서 전부 뺌)
 [편의]  이동 속도(걷기·달리기만), 자동 줍기(재료 더미), 종 치기·잠긴 문·배 타고 내리기 모션 빨리,
         락온 고정(오른쪽 스틱 튕기면 그 방향 적으로), 필드 아이템 강조(빛·아이콘),
         보스 재도전 (아래 설명)
 [표시]  지도·미니맵에 보일 종류 체크
 [퀘스트]  진행 중 퀘스트 + 지금 할 일, ✕ = 길 추적
 [빠른엔딩] / [진엔딩]  장별 메인·진엔딩 조건·사이드·100% 남은 것 체크리스트
 [공략]  1장~엔딩 공략 순서 길안내 (아래 설명)
 [보스]  잡은/남은 보스 (장 순서·레벨 순서), 이 지역 보스 길 추적, 잡은 보스 누르면 보스방 근처로 이동
         (1.7.0에서 빠짐) 보스러시: 이 지역에서 잡은 보스를 장 순서대로 연속 재도전 (잡으면 다음 보스방으로 자동 이동)
         (1.7.0에서 빠짐) 로그라이크: 무작위 순서, 층마다 보스 +15%, 한 마리 잡을 때마다 강화 3개 중 1개 (숫자키 1·2·3)
         보스 재도전 강화: 기본 · 1.5배 · 2배 · 3배 (체력·공격력) / 재도전 시간·피격 기록, 보스별 최고 기록

■ 공략 순서 (1.4.2 기능 · 「공략」 탭)
 - 1장 비탄의 계곡부터 9장 단혼산 엔딩까지, 스토리 순서대로 종 → 종으로 갈 곳을 하나씩 추적선으로 안내 (24구간 504단계)
 - 쓰는 법: 모드 패널 → 「공략」 탭 → 단계 골라 ✕ (추적선이 꺼져 있으면 자동으로 켜짐)
 - 종을 치거나 템을 줍거나 보스를 잡으면 다음 단계로 자동, 이미 한 건 알아서 건너뜀
 - !! 표시 = 놓치면 못 얻는 것 / 그 전에 해야 할 것 (예: 형야 잡기 전에 견습 의사 약초, 목소규 승강기 전에 머리띠 5개)
 - 「○○ 다시 오기 (N장 이후)」 = 나중에 얻는 무장·열쇠가 있어야 가는 곳 — 그 장 끝낸 자리에 넣어둠
 - 지도에 위치가 없는 것(상자 속·보상·대화)은 다음 단계에 "가는 길에: …"로 같이 나옴
 - 다른 걸 추적하면 기다렸다가 이어서 안내, 추적을 직접 끄면 공략도 멈춤 (진행 위치는 기억함)

■ 무거운 기능 (프레임이 아쉬우면 이것부터 끄기)
 - 필드 아이템 강조 (화면에 빛·아이콘을 계속 그림)
 - 미니맵 / 나침반 (매 프레임 그림)
 - 추적선 (길 계산)
 지도 아이콘·퀘스트·보스 탭은 열었을 때만 동작해서 거의 영향 없음.
 아무것도 안 켜면 모드는 거의 일을 안 함.

■ 보스 재도전 (편의 탭 · 시험 기능)
 - 켜면 이미 잡은 보스 자리에 로고와 보스 이름이 뜸 → 그 앞에서 E (패드 ✕) = 그 보스가 다시 나옴
 - 2페이즈 보스: 1페이즈 잡으면 2페이즈가 이어서 나옴 / 옆의 붉은 「2페이즈 도전」 = 2페이즈만
 - 보스 탭에서 잡은 보스(처치함 · 재도전) 누르면 그 보스방 근처로 이동 (같은 지역, 종 친 구역만)
 - 쓰러지면 그 판은 끝 → 다시 1페이즈부터 도전 가능 / 마지막 페이즈 잡으면 「재도전 완료」
 - 안 잡은 보스·안 가본 지역엔 안 뜸, 같은 보스 2마리 안 나옴
 - 세이브 보호: 시작 직전 세이브를 모드 폴더 save_backup 에 복사 → 다음 게임 실행 때 자동으로 재도전 전 세이브로 되돌림
   (드랍·퀘스트·보스 기록 변화가 안 남음. 대신 재도전 뒤 플레이도 같이 되돌아감 — 남기려면 끄기 전에 Ctrl+Shift+N)
 - 추명(1장 비탄의 계곡)으로 확인함. 다른 보스는 이상하면 댓글로 알려줘

■ 조작
 패드 (듀얼센스 / 듀얼쇼크4 / 엑박) — 게임이 안 쓰는 L3+R3 로 조작
  L3+R3 한 번       미니맵 켜기/끄기
  L3+R3 두 번       추적 해제 / 가장 가까운 안 먹은 템 추적
                    (NPC 대화 선택지에 커서 = 그 퀘스트 추적, 막힌 문 안내 중 = 필요한 열쇠 위치 추적)
  L3+R3 세 번       모드 패널 열기   ○ = 닫기
  L3+R3 1초 누르기  모드 전체 끄기/켜기
  지도 화면: 아이콘에 커서 = 정보 / R3 = 그 자리로 순간이동 (지도 닫힘) / △ = 그 템 추적 (지도 닫힘)
  ※ R3·△ 는 게임 원래 기능도 그대로임: 아이콘에 커서가 없으면 R3 = 시점 초기화, △ = 전체 지도 보기
  ※ 지도 안의 「표시 종류」 창은 키보드(F)로만 열림. 패드는 모드 패널(L3+R3 세 번)에서 같은 설정을 바꾸면 됨
  ※ ✕ 는 지도에서 게임 자체 버튼(천행부 = 티켓 소모)이라 모드는 안 씀

 키보드
  Home 모드 패널   F 지도에서 표시 종류   방향키·스페이스 패널 조작
  T 지도: 추적 / 밖: 추적 해제   F7 가장 가까운 템 추적   Ctrl+G 순간이동(지도)
  F2 지도 아이콘   F3 추적선   F6 나침반   F8 미니맵   F9 모드 전체 끄기/켜기
  E (보스 재도전 로고 앞)   Ctrl+Shift+N 재도전 결과 남기기
  ※ 모드 패널 여는 키(Home)를 바꾸려면: ue4ss\Mods\PBZCompassMap\settings.txt 의 PanelKey=Home 줄
    (Home / Insert / End / Delete / PageUp / PageDown / F8 / F10 / F12 중 하나로 고치고 게임 다시 켜기)

■ 1.8.6 바뀐 점 (11월 10일)
 - [고침] 카메라를 돌릴 때 나침반이 뚝뚝 끊기며 따라오던 문제: 나침반이 1초에 25번만 움직였음 → 이제 추적선·미니맵처럼 매 프레임 따라감

■ 1.8.5 바뀐 점 (11월 10일)
 - [새 기능] 길 이펙트 7번 「붉은 실 (종 연출)」: 종 근처에서 나오는 그 붉은 실(게임 원본 효과)이 걸어갈 길을 따라 허리 높이에
   깔림. 가까운 24m는 세 가닥이 꼬이고, 그 너머는 한 가닥으로 끝까지(기본 60m). 계단·턱은 실제 바닥 높이를 따라감.
   설정: 길 표시 모양 = 게임 이펙트 → 길 이펙트 종류 = 7, 「붉은 실 가닥」(3/2/1) · 「붉은 실 길이」(30/60/100m)
 - [바뀜] 기본 노란 선과 이펙트가 겹치지 않음: 이펙트·화살표가 덮는 구간이 끝나는 바로 그 지점부터 노란 선이 이어짐
   (붉은 실은 실이 끝난 뒤부터). 전투 중 이펙트가 숨으면 노란 선이 처음부터 보임
 - [새 기능] 「지도에 죽은 자리 표시」 켜기/끄기 (기본 꺼짐)
 - [새 기능] 「탐색 안 한 곳은 지도 아이콘 숨김」: 켜면 모드 아이콘이 게임의 지도 안개 아래로 들어가 아직 안 가본 곳은 가려짐
 - [고침] 오류 「main.lua:248 ... string.match ... lineTick」: 켬/끔 판정이 매 프레임 글자를 검사하다 예외가 날 수 있었음 →
   한 번 본 값은 기억하고 절대 오류를 내지 않음. 또 화면 갱신 중 오류가 나도 모드가 멈추지 않고 log.txt 에만 남김

■ 1.8.4 바뀐 점 (11월 10일)
 - [고침] 진엔딩·공략 탭을 열면 튕기거나 버벅이던 문제: 패널이 매 프레임 탭의 모든 줄을 새로 만들면서 게임의 퀘스트·아이템·보스
   표를 1초에 수백 번 읽고 있었음. 이제 탭을 바꿀 때·실행할 때·최대 1초에 한 번만 만들고, ↑↓ 는 막대만 움직임
 - [고침] 오류 「main.lua:8431: 함수에 대한 산술 연산」 (프레임 시간 재기): 시계 값이 이상하면 시간 재기만 건너뛰고 모드 동작은 그대로
 - [고침] 방진 지도에 있는데 가보면 없는 아이콘: 같은 지도에 방진 희몽(8장, 꿈속 방진)이 방진(4장) 위에 겹쳐 있어서 그쪽 수집품이
   평소처럼 그려졌음. 이제 다른 장의 부분은 흐리게 그리고, 설명창에 「방진 희몽 · 8장 — 지금 있는 곳엔 없음」
 - [고침] 공략 탭이 맨 처음 설치 때만 세이브에 맞췄음 → 안내 중이 아니면 게임을 켤 때마다 처음 열 때 세이브에 맞춰
   「공략: 세이브 기준 다음 단계 3-5」를 알려주고, 커서도 그 단계에서 시작
 - [고침] 이동 속도를 바꿔 두면 5초마다, 시야각(FOV)을 바꿔 두면 10초마다 0.04~0.055초씩 끊기던 문제: 시야각용 카메라 부품은
   몸(로드·부활)마다 한 번만 찾고, 이동 속도 유지 점검은 20초에 한 번 (새 몸·설정 변경은 바로 적용)
 - [고침] 추적선이 카메라 바로 앞 점에서 한 프레임 끊기던 문제 (log.txt 의 「line error」)
 - [고침] 「먹으면 다음 템 자동 추적」이 아직 못 여는 문 너머 물건을 고르던 문제: 길이 잠긴 문·막힌 길에서 끝나면 그 물건은
   건너뛰고 다음으로 가까운 것 (직접 고른 추적은 건너뛰지 않음)

■ 1.8.3 바뀐 점 (11월 10일)
 - [고침] 튕김: 지도에서 설정창(Home)을 열고 ↑↓ 누르면 튕기던 문제, 지도에서 퀘스트·캐릭터 탭으로 넘겨도 패널이 남아
   있던 문제(보스 탭 넘기다 튕김 포함). 이제 지도·게임 메뉴 위에서는 설정창이 안 열리고, 탭을 넘기면 패널이 닫힘
 - [고침] 패드 Start·지도 열 때 가끔 설정창이 같이 열리던 문제 (메뉴 중 눌린 스틱 클릭을 연타로 세던 버그)
 - [고침] 보스 탭이 매 프레임 게임에 수백 번 물어보던 계산 → 2초에 한 번 (보스 탭 버벅임·튕김 완화)
 - [고침] 종 메뉴·강화·상점·인벤토리·설정·편지 같은 게임 화면이 열리면 나침반·미니맵·추적선이 숨음
 - [고침] 지도 아이콘에 커서를 올려도 설명이 안 나오던 문제 (정보창 설정이 꺼져 있어도 이름·종류·조작키 표시)
 - [고침] 지도의 재료 더미가 전부 「재료·화폐」로 나오던 문제 → 실제 내용물 이름 (예: 살기 개조의 수수께끼 · 2 + 의식의 티끌 ×431)
 - [고침] 「화폐」 → 게임 정식 이름 「의식의 티끌 ×양」
 - [고침] 대화로 받는 보상(시구 사흉 도끼 퀘스트 등) 아이콘이 받은 뒤에도 남던 문제: 그 자리에 30초쯤 있었는데 실물이 없으면 지워짐
 - [추가] 보스전 나침반 (설정 탭): 보스 체력바가 뜨면 나침반 숨김(기본) / 체력바 아래로 / 그대로. 2·3페이즈 넘어갈 때도 유지
 - [추가] F8 (패드 L3+R3 한 번): 미니맵 기능이 꺼져 있으면 기능 자체를 켜고 저장
 - [추가] 추적선: 「바닥선도 같이」 옵션 (끄면 화살표·이펙트만). 선에 원근감 (가까우면 굵고 진하게, 멀면 가늘고 옅게)

■ 1.8.2 바뀐 점 (11월 9일)
 - [변경] DLL 없앰: 1.8.1 압축에 UE4SS 와 패드 보조 DLL 이 들어 있어서 넥서스 자동 검사에 격리됨.
   이제 UE4SS 는 넥서스 5번 모드로 따로 받고, 패드는 게임 자체 입력으로 읽음
 - [변경] 지도 패드 조작: 아이콘 위에서 R3 = 순간이동, △ = 추적 (지도가 바로 닫히고 길 표시가 뜸)
 - [수정] 멀리(또는 위층으로) 순간이동하면 땅이 로딩되기 전에 떨어져 죽던 문제 → 땅이 생길 때까지 그 자리에 붙잡아 둠
 - [수정] 그 지역에서 게임 지도를 한 번 열기 전까지 미니맵 지형이 안 나오던 문제
 - [수정] 지도 가장자리에서 「미니맵 맞추는 중 · 지도 안쪽으로 조금 이동」이 계속 뜨던 문제 → 조금 안쪽에서 대신 맞춤

■ 1.8.1 바뀐 점 (11월 9일)
- 고침: 종 → 공간이동 지도에도 지도 아이콘 · 정보창이 나옴 (메뉴 지도와 다른 화면이라 안 나왔었음)

■ 1.8.0 바뀐 점 (11월 9일 · 정식판)
 - [변경] 수집품 1,546곳 위치·얻는 법을 이 모드가 게임 파일에서 직접 다시 뽑음 (전 지역 80,947칸 전부 읽음)
   이름·종류는 게임 언어 그대로, "상자를 열면 나옴 / 그 자리에서 주우면 됨" 안내
 - [변경] 보스 스폰 위치도 게임 레벨 파일에서 직접 뽑은 값으로 교체
 - [추가] 먹 붓 나침반 (東南西北 붓글씨 · 붉은 바늘 · 인장 · 먹물) — 설정 탭 「나침반 모양」 (기본 띠도 그대로 있음)
 - [추가] 락온 고정 (편의 탭): 고른 적한테 락온이 고정되고, 옆 적이 공격하거나 시점을 돌려도 안 바뀜
   물에 들어가거나 순간이동해도 쫓아갈 수 있으면 계속 따라감, 죽거나 사라지면 가까운 적으로
   오른쪽 스틱을 끝까지 튕기면 그 방향(상하좌우·대각선)의 적으로 바꿈 · R3 = 풀기 · 폭발통 같은 건 안 잡힘
 - [추가] 잠긴 문 확인 모션, 배 타기·내리기 모션도 빨리 (종 치기와 같은 설정)
 - [수정] 같은 모션이 연달아 나오면 두 번째부터 원래 속도로 돌아가던 것
 - [변경] 선택지·퀘스트 메모 294개는 이 모드가 쓴 글이 아니라서 뺌

■ 1.7.0 바뀐 점 (11월 9일 · 영어 지원)
 - [추가] 영어 전체 지원: 모드 패널·안내·알림·지도/미니맵 글자, 공략 순서 504단계, 수집품 목록 1,500여 곳, 퀘스트 상세 설명 194개
   게임 언어가 한국어·중국어·일본어가 아니면 자동으로 영어로 나옴 (설정 탭 「언어 (Language)」 에 English 추가)
 - [수정] 중국어·일본어 화면에서 일부 문구가 한국어로 남던 것 (세이브 진행도 맞추기, 길 표시 모양, 퀘스트 상세 설명 설정 등 32줄)
 - [변경] 보스 탭의 보스러시 · 로그라이크를 뺌 (혼문과 확실히 구분 — 로그라이크는 혼문 모드에서). 보스 재도전은 그대로, 로고를 새로 바꿈
 - [수정] 지도 정보창이 퀘스트 · 시스템 같은 다른 메뉴 페이지에서도 계속 떠 있던 것
 - [변경] 영어 화면 탭 이름 짧게 (편의 → QoL 등, 탭 줄이 패널 밖으로 넘치던 것)
 - 영어 설명서: README_EN.txt

■ 1.6.4 바뀐 점 (11월 9일 · 갤러리 제보 수정)
 - 고침: 공략 탭 「↻ 세이브 진행도에 맞추기」가 훨씬 뒤 단계로 튀던 것 — 가방에 이미 있는 무기·장신구(상점에서 산 것, 일찍 얻은 것)가
   「여기까지 왔다」로 잡혔음. 이제 종(울린 것)·보스(잡은 것)만 보고 위치를 맞춤
 - 고침: 살기 무기 장애물 안내 — 장애물마다 게임 데이터에 무기가 여러 개 적혀 있어서, 환술 비파 자리에 다른 비파만 있어도
   「갖고 있음, 장착하고 사용」이라고 떴음. 첫 번째(그 자리용) 무기가 아니면 「안 열리면 ○○ 필요」로 같이 알려줌
 - 공략 순서(4장 방진): 빠져 있던 보스 2명 추가 — 수행방 방주: 유룡 (유룡두) · 귀차 고수: 구혼 (이별 잔구, 사자탈로 가시덤불 태우고)
 - 참고: 「!!」 표시 = 놓치면 다시 못 얻는 것 · 순서 주의 (예: 「!! 백적련 잡으면 실패」)

■ 1.6.3 바뀐 점 (11월 7일 미니맵 수정)
 - [수정] 맵 끝자락에서 미니맵이 안 돌거나 멈춰 있던 것 / 미니맵이 안 나오던 것
   (게임 지도 투영이 지도 그림 가장자리에서 멈춰서, 끝자락에서 처음 맞추면 방향·축척이 틀어지거나 아예 못 맞추고 굳어 있었음)
   이제 지도 안쪽에서 한 번 맞춘 값(직선 맞춤)을 지도별로 minimap_fit.txt 에 저장해서 끝자락·지도 밖에서도 그대로 돌고 따라감
   처음 들어간 지도의 맨 끝에 서 있으면 「미니맵 맞추는 중 · 지도 안쪽으로 조금 이동」 이 잠깐 뜨고, 안쪽으로 몇 걸음 가면 바로 나옴
   (제보·수정 시도해주신 갤러님 고마움)
 - [수정] 방진 뒷골목처럼 게임 지도가 다른 지역 그림으로 보여주는 곳에서 미니맵 지형이 안 나오던 것
   (그 자리에서 지도를 한 번 열면 어느 그림인지 기억해서 미니맵에도 같은 그림·같은 좌표로 나옴)
 - [수정] 공략 탭: 기억의 꽃 · 흑석 조각 · 살기 호박 조각 단계가 먹어도 계속 ~ 로 남던 것
   (그 지역에서 그 종류를 먹은 개수만큼 앞 단계부터 ✔ 로 바로 바뀜)
 - [수정] 살기 무기가 여러 개 통하는 장애물에서 첫 번째 무기 이름만 나오던 것 (환술 비파 자리에 「뇌정창」으로 뜨던 것)
   이제 「A」 또는 「B」 로 전부 표시, 그중 갖고 있는 게 있으면 그걸 알려줌

■ 1.6.2 바뀐 점 (11월 7일)
 - [추가] 퀘스트 상세 설명: 퀘스트 창에서 퀘스트를 고르면, 짧은 목표 줄 바로 아래에 그 단계의 상세 설명이 같이 뜸
   (게임 데이터엔 있는데 화면에 안 나오던 설명 — 한국어·영어판은 아예 비어 있어서 중국어 원문을 게임 용어에 맞춰 번역, 194개)
   설정 탭 「퀘스트 상세 설명 (퀘스트 창)」 으로 켜기/끄기 (기본 켜짐). 끄면 원래 화면 그대로
 - [변경] 혼문(로그라이크)은 따로 배포로 분리 — 이 압축에는 혼문이 없음
   혼문은 「혼문_1.1.0.zip」 따로 받아서 설치 (혼문의 시련 50층 탑, PBZModLoader 필요). 올인원과 같이 써도 되고 따로 써도 됨
   이미 깔린 혼문은 이 설치·제거가 건드리지 않음 (혼문은 혼문 압축의 설치.bat / 제거.bat 으로)

■ 1.6.1 바뀐 점 (11월 7일 긴급 수정)
 - 혼문 허브에 들어갔다가 타이틀로 나와서 스토리 세이브를 불러오면 맵 밖으로 계속 떨어지던 문제 수정
   (허브의 "결계 밖으로 못 나감" 처리가 스토리 맵에서도 돌면서 플레이어를 허브 위치 쪽으로 계속 옮기던 것)
 - 이제 허브 · 판 관련 처리는 혼문 세이브 안에서만 돌고, 스토리 세이브를 불러오면 전부 꺼짐
 - 스토리 세이브 파일 자체는 원래부터 안 건드림 (세이브 손상 없음)

■ 1.6.0 바뀐 점 (11월 7일)
 - [추가] 로그라이크 모드 「혼문」 1.0 같이 들어감 (위 혼문 설명 · 게시판 업데이트 글 참고) — PBZModLoader 필요
 - [추가] 혼문 안에 있는 동안은 올인원 화면(나침반 · 미니맵 · 지도 아이콘 등)이 자동으로 숨고, 나오면 원래대로

■ 1.5.6 바뀐 점 (11월 6일 19:05)
 - [수정] 공략탭 ✔ 체크: 무기·살기 무기·장신구·약은 가방에 있으면 어디서 얻었든 ✔
   (전엔 그 자리 아이템이 사라졌는지만 봐서, 보상·상점·다른 경로로 얻은 정기늠연·장형 흑상 같은 게 ~ 로 남았음)

■ 1.5.5 바뀐 점 (11월 6일 15:45)
 - [수정] 공략탭 표시: 친 종·잡은 보스·먹은 수집품 ✔ / 아직 확인 안 된 것 ~ / 안 친 종·안 잡은 보스 ×
 - [추가] 공략에 선행 NPC 순서 안내 (견암완갑 = 역참 무덤 얘기 남자, 묘수재악 = 묘수 소장 구출 — 둘 다 백적련 전)
 - [추가] 시작키 변경: settings.txt 의 PanelKey=Home 줄 (Home / Insert / End / Delete / PageUp / PageDown / F8 / F10 / F12)
 - [변경] 난이도 표시 이름: 초보자 / 중급자 / 상급자 / 최상급자

■ 1.5.1 바뀐 점 (11월 6일 12:40)
 - [수정] 스터터링(화면 끊김) 큰 폭 개선: 이동속도·시야각을 켜둔 사람도
   끊김의 주범이던 1초마다의 능력치/카메라 조회를 5초에 한 번으로 줄임
   (테스트: 이속 2.5배+시야각 110 켠 상태에서 speed 느린 틱 분당 59→12로 감소)
 - [개선] 이동속도·시야각·카메라를 기본값으로 둔 사람은 그 기능 틱이 아예 잠듦(조회 0)
   → 안 쓰는 기능 때문에 생기던 주기적 끊김 제거

■ 1.5.0 바뀐 점 (11월 6일 01:30)
 - [새 기능] 한·중·일 지원: 모드 화면 전체(패널·안내·알림·지도/미니맵 글자)가 게임 언어를 따라 한국어 / 中文 / 日本語 로 나옴
   · 설정 탭 맨 위 「언어 (Language)」: 자동(게임 언어) / 한국어 / 中文 / 日本語 직접 고르기도 가능
   · 보스·종·무기·지역 이름은 게임 언어 파일 그대로, 공략 순서·수집품 목록도 언어별 파일로 따로 들어 있음
 - [새 기능] 보스러시: 보스 탭 「▶ 보스러시」 — 이 지역에서 잡은 보스를 장 순서대로 연속 재도전 (잡으면 다음 보스방으로 자동 이동, 쓰러지면 끝)
 - [새 기능] 로그라이크: 보스 탭 「▶ 로그라이크」 — 무작위 순서, 층마다 보스 +15%, 한 마리 잡을 때마다 강화 3개 중 1개 (숫자키 1·2·3)
 - [새 기능] 보스 강화: 보스 탭 / 편의 탭 「보스 재도전 강화」 기본·1.5배·2배·3배 (체력·공격력)
 - [새 기능] 기록 측정: 재도전 시간·피격 횟수 기록, 보스별 최고 기록 표시 (배율마다 따로)
 - [수정] 같은 보스가 두 곳에 있는 경우 보스러시가 안 잡은 쪽에서 멈추던 문제 → 그 자리는 건너뛰고 다음 보스로

■ 1.4.2 바뀐 점 (11월 5일 밤)
 - 새 기능 「공략」 탭: 1장~단혼산 엔딩까지 스토리 순서 길안내 504단계 (놓치면 안 되는 것 !! 표시, 나중에 다시 올 곳 따로 정리)
 - 난이도 표시: 어려움 이름 꺼드럭 → 팬갤러 37(121.171)도 깸 (예전 기본 이름 쓰던 사람은 자동으로 바뀜, 직접 바꾼 이름은 그대로)
 - 모드 패널 탭 줄 간격 정리 (탭 9개)

■ 1.4.1 바뀐 점 (11월 5일)
 - 새로 설치하면 모든 기능 꺼짐 + 첫 실행 안내. 꺼진 기능은 아예 계산을 안 해서 가벼움
 - [수정] 플레이 중 랜덤 크래시(보스전 등) 유력 원인 제거 (추정: 1.4.0 은 시야각을 안 써도 10초마다 카메라 목록을 훑었음 → 없앰)
 - [수정] 화면 탭 설정 건드리면 Fatal Error, 그 뒤로 켤 때마다 튕기던 문제 — 비네트·모션블러·필름그레인 등 화면 효과 옵션이 원인
   (제보자 확인). 실행 중에 게임 셰이더를 바꾸는 방식이라 화면 효과·그래픽 옵션을 전부 뺌. 시야각·카메라 거리/높이만 남김
 - [수정] 상호작용 순간 멈춤 대비: 보스 기록용 세이브 읽기를 지역 이동 직후·게임 저장 중엔 안 함
 - [수정] 미니맵 "이 지도 %" 가 게임 지도 완성도와 다르던 문제
   (방진 = 방진+뒷골목+희몽, 단혼산 = 단혼산+단혼애+환술실 을 한 지도로 계산)
 - [수정] 모드만 깔면 생기던 주기적 끊김(스터터링). 몇 초마다 무겁게 돌던 것들을 전부 정리함:
   · 화면·대화창·게임 시스템을 찾느라 게임 전체 오브젝트를 훑던 것 → 한 번 찾으면 계속 씀 (새로 생기면 게임이 알려줌)
   · 세이브 기록(수천 개)을 3초마다 통째로 다시 읽던 것 → 20초마다, 반씩 나눠서
   · 퀘스트 목록을 2초마다 읽던 것 → 자동 추적을 켰을 때만 6초마다
   · 잠긴 문·대화 선택지 정보 → 정보창을 켰을 때만 / 바닥 재료 더미 찾기 → 20초마다
   · 패드 입력 파일을 한 틱에 세 번 읽던 것 → 한 번
   · 그래도 끊기면 log.txt 에 "slow" 줄로 어떤 기능이 몇 ms 걸렸는지 남음 → 그 줄 같이 올려줘
 - [개선] 추적선 버벅임: 길 점을 줄여서(직선 구간 합침) 그리는 양을 크게 줄이고 길 계산 횟수도 줄임.
   그래도 버벅이면 설정 탭 「추적선 가볍게」 켜기 (테두리 없이, 계산 더 드물게)
 - [수정] 방진 뒷골목·희몽에 있을 때 지도에 방진 첫 지역 템·종만 나오던 문제: 한 지도로 묶인 구역(뒷골목·희몽,
   단혼애·환술실, 매곡호 유적)의 아이콘도 전부 표시
 - [수정] 지도에 종이 안 보이던 문제: 아직 안 친 종은 게임이 안개 속에 숨겨서, 모드가 직접 표시함
 - [추가] 튕김 방지 장치, 지도 화면을 열면 게임 %와 모드 %를 비교해서 log.txt 에 기록 (어긋나면 바로 찾게)
 - [새 기능] 보스 재도전

■ 같이 쓰면 안 되는 것
 - 패치 전 PBZCompass / PBZMapMarkers pak 모드 (Content\Paks\~mods) → 메뉴가 빨갛게 되거나 {ButtonText} 로 깨짐
 - 게임 스크립트를 바꾸는 pak 모드 일부 → 메뉴가 깨지면 Content\Paks\~mods 의 다른 pak 모드를 하나씩 빼서 확인
 - Movement Speed 모드 (같은 기능이 이 모드 안에 있음 — 둘 중 하나만)

■ 알려진 한계
 - 스팀판 11/4 패치(빌드 26367565) 전용. 에픽판·패치 전 버전은 안 됨
 - 게임 지도에 위치가 없는 퀘스트 단계는 길 추적 대신 설명만 나옴
 - 아주 먼 템은 길이 일부만 나옴 (가까이 가면 이어짐), 추적선은 벽 너머로도 보임
 - 게임 업데이트가 또 나오면 UE4SS 시그니처를 다시 맞춰야 할 수 있음

■ 문제가 생기면
 - 로그: ue4ss\Mods\PBZCompassMap\log.txt  (UE4SS 자체 로그: ue4ss\UE4SS.log) — 제보할 때 같이 올려줘
 - 켤 때마다 튕김: ue4ss\Mods\PBZCompassMap\settings.txt 삭제 (모드 설정만 초기화)
 - 이 모드만 끄기: ue4ss\Mods\PBZCompassMap\enabled.txt 삭제
 - UE4SS.log 에 "AOB scans could not be completed" → 시그니처가 게임 버전과 안 맞음

■ 만든 사람 · 출처 (꼭 같이 표기해줘)
 - 만든 사람: 디시 팬블제 게임시스템 갤 · 유동 제작자
 - UE4SS (RE-UE4SS 팀, MIT 라이선스 — ue4ss\LICENSE)  https://github.com/UE4SS-RE/RE-UE4SS
 - UE4SS for Phantom Blade Zero (Nexus Mods 5번 모드)  https://www.nexusmods.com/phantombladezero/mods/5
 - 11월 패치용 UE4SS 시그니처: 이 모드에서 PBZ.exe 를 직접 분석해서 새로 만듦 (먼저 공개해준 BabaBooey88 에게도 감사)
 - 수집품·보스 위치, 얻는 법, 이름: 전부 이 모드가 게임 파일에서 직접 뽑음
 - 나침반 그림: 이 모드용으로 새로 그림 (붓글씨: Yuji Boku 폰트, SIL Open Font License)
