wiki_ko

← Home

---

POEFixer Wiki

POEFixer 문서에 오신 것을 환영합니다. 아래에서는 인터페이스 탭별로 프로그램의 기능을 설명합니다.

---

1. Login (Trade Browser)

Login 탭은 거래 경험의 시작점입니다. 애플리케이션에 완전한 기능의 웹 브라우저를 직접 통합하여, 도구를 떠나지 않고 공식 Path of Exile Trade 웹사이트와 상호작용할 수 있습니다.

주요 기능

내장 웹 브라우저

WebView2로 구동되는 내장 브라우저는 Chrome이나 Edge를 사용하는 것과 동일한 원활한 경험을 제공합니다.

• 세션 관리: 애플리케이션이 세션 쿠키를 자동으로 캡처합니다. 이는 Trade 탭이 공식 WebSocket API에 연결하여 실시간 업데이트를 수신하는 데 필수적입니다.
• 게임 모드 지원: 설정에 따라 Path of Exile 1과 Path of Exile 2 거래 사이트를 자동으로 감지하고 지원합니다.
• 탐색: 수동 URL 입력을 위한 주소 표시줄과 메인 거래 검색 페이지로 빠르게 돌아갈 수 있는 Home 버튼을 포함합니다.

거래 필터 추가

공식 사이트에서 검색을 구성한 후(예: 특정 스탯을 가진 "Headhunter"), 애플리케이션의 모니터링 시스템에 추가할 수 있습니다.

1. 검색 구성: 브라우저를 사용하여 거래 사이트에서 필터를 설정합니다.
2. "Add" 클릭: 탭 상단의 큰 Add 버튼을 누릅니다.
3. 검증: 도구가 URL이 유효하고 현재 게임 모드(PoE 1 vs PoE 2)와 일치하는지 확인합니다.
4. 확인: 대화 상자가 나타나며, Trade 탭에서 모니터링을 시작하기 전에 검색에 이름을 지정할 수 있습니다.

참고: "WebView2 Missing" 오류가 표시되면, 애플리케이션이 Microsoft에서 필요한 런타임을 다운로드할 수 있는 링크를 제공합니다.

---

2. Trade

Trade 탭은 실시간 시장 모니터링의 커맨드 센터입니다. 공식 Path of Exile WebSocket API를 활용하여 검색 조건에 일치하는 새로운 아이템 등록에 대한 즉각적인 알림을 수신합니다.

인터페이스 개요

메인 뷰에는 모든 활성 거래 검색 연결 목록이 표시됩니다.

연결 목록 열

1. 상태:
   • 초록색: 연결되어 새로운 아이템을 수신 대기 중.
   • 주황색: 연결 중...
   • 빨간색: 연결 해제됨.
   • 속도 제한: API에 의해 속도 제한이 적용된 경우, 재연결 가능 시점까지의 카운트다운 타이머가 여기에 표시됩니다.
2. 이름: 검색의 이름(예: "Headhunter").
   • 클릭: 기본 웹 브라우저에서 검색 URL을 엽니다.
   • 툴팁: 마우스를 올려 전체 URL을 확인합니다.
3. 통계:
   • 핸드셰이크 아이콘: 이 세션에서 발견된 아이템 수.
   • 체크 아이콘: 성공적으로 전송된 귓속말 메시지 수.
   • X 아이콘: 실패한 귓속말 시도 수.
4. 작업:
   • 재생/정지 버튼: 이 특정 연결의 실시간 검색을 수동으로 시작하거나 중지합니다.
   • 장바구니: 이 검색에서 아이템을 대량 구매하기 위한 Manual Buy 메뉴를 엽니다.
   • 펜(편집): 연결의 이름 또는 URL을 업데이트합니다.
   • 기어(설정): 이 연결의 상세 Settings & Logs 창을 엽니다.
   • 휴지통(삭제): 이 검색 연결을 영구적으로 제거합니다.

전역 컨트롤

탭 하단에 전역 컨트롤이 있습니다:

• Connect All: 활성화된 모든 검색에 순차적으로 연결합니다. API 속도 제한 트리거를 방지하기 위해 연결 사이에 약간의 지연을 추가합니다.
• Disconnect All: 모든 활성 검색을 즉시 중지합니다.
• Add Link: Login 탭 브라우저를 사용하지 않으려는 경우 거래 검색 URL을 수동으로 추가합니다.

Auto-Stash (Memory Scanner 모드 전용)

Memory Scanner가 활성화된 경우, 거래 시스템은 거래 중 자동 인벤토리 관리를 지원합니다.

• Enable Auto-Stash: 거래 흐름 중 자동 창고 보관을 활성화하는 체크박스.
• Inventory Threshold: 인벤토리 사용률이 이 백분율(10-80%)을 초과하면, 시스템이 자동으로 은신처로 텔레포트하고 구매를 계속하기 전에 아이템을 창고에 보관합니다.
• Protected Slots: 특정 인벤토리 슬롯을 보호됨으로 표시할 수 있습니다 — 이 슬롯의 아이템은 창고로 이동되지 않습니다.

Auto-Stash 작동 방식

1. 각 구매 전에, 시스템이 인벤토리 스냅샷을 촬영하고 사용률을 확인합니다.
2. 사용률이 임계값을 초과하면, 시스템이 은신처로 텔레포트합니다.
3. 창고까지 걸어가서 열고, 보호되지 않은 모든 아이템을 Ctrl+클릭으로 창고에 넣습니다.
4. 창고 보관이 완료되면, 거래로 돌아갑니다.

Auto-Stash 설정 (Settings 탭 내)

설정	범위	기본값	설명
Stash Inventory Threshold	10-80%	50%	창고 보관을 트리거하는 사용률 %
Stash Click Retries	1-20	5	창고 엔티티 열기 최대 시도 횟수
Item Transfer Max Clicks	5-100	40	중단 전 최대 Ctrl+클릭 시도 횟수
Item Transfer Delay	30-1000ms	100ms	각 Ctrl+클릭 후 지연
Stash Open Verify Delay	50-2000ms	200ms	창고 엔티티 클릭 후 지연
Movement Key	Virtual key	T (0x54)	창고까지 걷는 데 사용하는 키
Walk Cursor Distance	100-800px	400px	걷기 커서의 플레이어 전방 픽셀 수
Protected Inventory Slots	12×5 bitmask	0	슬롯별 보호 마스크

안전: 정지 핫키는 모든 창고 작업을 즉시 중단합니다. 입력 차단은 RAII 가드로 보호됩니다(항상 해제됨). 각 Ctrl+클릭은 창고 UI가 여전히 열려 있는지 확인합니다.

연결 설정 및 로그

연결의 Gear 아이콘을 클릭하면 상세 모달 창이 열립니다.

1. 일반 설정

• Auto Reconnect: 활성화하면, 연결이 끊어진 경우 도구가 자동으로 재연결을 시도합니다.
• Enable Notification: 새로운 아이템이 발견되면 게임 내에 팝업 알림 오버레이를 표시합니다.
• Multi-Item Whisper Delay: 귓속말 메시지 사이에 설정 가능한 지연(밀리초)을 추가합니다. 이는 대량 검색에서 스팸으로 플래그되는 것을 방지하는 데 중요합니다.

2. 화폐 필터

등록 가격에 따라 수신 알림을 필터링합니다. 이를 통해 웹사이트 필터를 변경하지 않고도 너무 싸거나 비싼 등록을 무시할 수 있습니다.

• PoE 1 / PoE 2 지원: 화폐 목록은 선택한 게임 모드에 따라 자동으로 조정됩니다.
• Min/Max: 특정 화폐의 최소/최대 수량을 설정합니다(예: 100~150 Chaos Orb 사이에 등록된 아이템만 알림).

3. 거래 로그

설정 창의 오른쪽에서 이 특정 검색으로 발견된 아이템의 기록을 볼 수 있습니다.

• 아이템 카드: 아이템 아이콘, 이름, 등록 가격을 표시합니다.
• 판매자 정보: 플레이어 이름과 아이템이 등록된 후 경과 시간을 표시합니다.
• 모드: 아이템의 Explicit Modifier를 목록으로 표시합니다.
• 상태 표시:
  • Travel: 판매자의 은신처 방문 성공 여부를 나타냅니다.
  • Buy: 거래 메시지가 성공적으로 복사/전송되었는지 나타냅니다.

---

3. Settings

Settings 탭은 애플리케이션의 전역 동작, 게임 통합, 사용자 인터페이스 환경설정을 구성하는 컨트롤 센터입니다.

게임 선택

• Path of Exile 2 / Path of Exile 1: 현재 플레이 중인 게임 모드를 선택합니다. 이에 따라 거래 검색 URL, 창 감지 로직, 스캐너 호환성이 조정됩니다.
• League: 드롭다운 메뉴에서 현재 리그(예: Standard, Hardcore 또는 임시 리그)를 선택하여 거래 검색이 올바른 경제를 대상으로 하도록 합니다.

스캐너 유형

애플리케이션이 게임 클라이언트에서 데이터를 읽는 방법을 선택합니다.

• WGC (Windows Graphics Capture):
  • 설명: 게임 창이 백그라운드에 있어도 시각적으로 캡처합니다. PoE 1 또는 Memory Scanner를 사용할 수 없는 경우 권장됩니다.
  • Corner Density: 프레임 분석의 임계값을 조정합니다(고급 설정).
  • Use Full Window: 활성화하면 전체 게임 창을 스캔합니다. 비활성화하면 특정 스캔 영역을 수동으로 정의할 수 있습니다(울트라와이드 모니터나 특정 설정에 유용).
  • Select Area: 화면에 스캔 사각형을 그리는 인터랙티브 도구.
• Memory Scanner (PoE 2 전용):
  • 설명: 게임 메모리를 직접 읽어 아이템과 엔티티를 식별합니다. 일반적으로 PoE 2에서 더 빠르고 정확하지만, 게임이 호환 가능한 상태여야 합니다.

클릭 설정

애플리케이션이 게임 마우스 입력과 상호작용하는 방법을 구성합니다. 주로 자동 거래나 인벤토리 관리에 사용됩니다.

• Enable Auto Click: 애플리케이션이 마우스 클릭을 수행할 수 있게 하는 마스터 스위치.
• Click Count: 작업당 클릭 횟수(인벤토리에 화폐가 없는 경우, 첫 번째 클릭으로 아이템이 구매되지 않을 수 있음).
• Click Interval: 클릭 사이의 지연(밀리초).
• Scan Timeout: 스캐너가 아이템 찾기를 포기하기 전 최대 시간(초).
• Hold Ctrl: 클릭 중 자동으로 Ctrl 키를 유지합니다(인벤토리와 창고 사이에서 아이템을 빠르게 이동하는 데 유용).
• Return Cursor: 클릭 작업 수행 후 마우스 커서를 원래 위치로 되돌립니다.
• Block Input: 애플리케이션이 자동 작업을 수행하는 동안 간섭을 방지하기 위해 사용자 마우스 입력을 일시적으로 차단합니다.
• Enable Rate Limit: 게임 서버에 의한 플래그 지정을 방지하기 위해 작업 빈도를 제한합니다.
• Fast Trade: 빠른 거래 상호작용을 위해 설정을 최적화합니다.
• Fast Mouse Click: 마우스 다운/업 이벤트의 입력 지연을 줄입니다.

고급

• Return to Hideout: 특정 작업 후 채팅에서 자동으로 /hideout을 입력하려고 시도합니다(구성된 경우).
• Streamer Mode: 스트리밍 소프트웨어(OBS 등)에서 애플리케이션의 오버레이와 창을 숨겨 시청자에게는 게임만 보이도록 합니다.

데스크톱 알림

거래 검색이 아이템을 찾았을 때 나타나는 팝업 알림을 사용자 정의합니다.

• Enable Desktop Notifications: 시스템 수준 알림 켜기/끄기.
• Position: 알림이 화면에 나타나는 위치를 선택합니다(우상단, 좌상단, 우하단, 좌하단).
• Display Time: 알림이 표시되는 시간(초).
• Enable Sound: 알림이 나타날 때 효과음을 재생합니다.
• 표시 옵션:
  • Show Icon: 아이템 아이콘을 표시합니다.
  • Show Price: 등록 가격을 표시합니다.
  • Show Seller: 판매자의 캐릭터 이름을 표시합니다.
  • Show Mods: 아이템의 Explicit Modifier를 목록으로 표시합니다.
• Test Notification: 현재 설정을 테스트하기 위해 샘플 알림을 전송합니다.

테마 및 외관

• Theme: 전체 애플리케이션에 대한 4가지 비주얼 테마 중 선택:
  • Dark — 미묘한 대비의 기본 다크 테마.
  • Light — 밝은 환경을 위한 라이트 테마.
  • Blue — 블루 액센트 컬러의 다크 테마.
  • Midnight — 최소 밝기의 딥 다크 테마.
• Font Scale: 고해상도 디스플레이에서 가독성 향상을 위해 전역 텍스트 크기(0.8x~1.5x)를 조정합니다.

언어 및 인터페이스

• Language: 애플리케이션의 인터페이스 언어를 전환합니다(예: 영어, 러시아어, 한국어 등). 11개 언어가 지원됩니다.
• 모든 테마 관련 문자열은 지원되는 모든 언어에서 현지화되어 있습니다.

---

4. AutoPot [PoE 2]

AutoPot 탭은 Path of Exile 2 전용의 자동 물약 사용 및 유틸리티 기능을 제공합니다. 자동 작업과 비주얼 오버레이를 통해 캐릭터의 Health(HP), Energy Shield(ES), Mana(MP)를 관리하는 포괄적인 시스템을 포함합니다.

주요 기능

1. 입력 장치 및 드라이버 상태

시스템은 안전하게 입력을 시뮬레이션하기 위해 가상 컨트롤러에 의존합니다.

• ViGEmBus Driver: 필요한 ViGEmBus 드라이버가 설치되어 있는지 확인하고, 없는 경우 다운로드 링크를 제공합니다.
• 컨트롤러 감지: 물리적 컨트롤러(Gamepad)와 가상 컨트롤러를 자동으로 감지합니다.
• 안전 경고: 게임패드 키를 바인딩했지만 컨트롤러가 감지되지 않는 경우 경고합니다.

2. Vitals Overlay (HUD)

게임 위에 현재 HP, ES, MP를 표시하는 사용자 정의 가능한 비주얼 오버레이.

• 표시 모드: 7가지 다른 스타일 중 선택:
  • Horizontal Bars (클래식 스타일)
  • Vertical Bars (컴팩트 사이드 뷰)
  • Percent Text (간단한 텍스트 표시)
  • Circles (링 인디케이터)
  • Compact Blocks (미니멀 사각형)
  • Minimal Dots (눈에 띄지 않는 점)
  • Glass Panel (투명 배경)
• 사용자 정의:
  • Scale: 오버레이 크기 조정(0.5x~3.0x).
  • 표시 전환: HP, ES, MP 바를 독립적으로 표시/숨기기.
  • 숫자 값: 백분율과 절대 수치 간 전환.
  • 드래그 가능: 메뉴가 열려 있을 때, "Drag Hint"가 나타나 오버레이를 화면 어디든 이동할 수 있습니다.

3. 자동화 모드

캐릭터 빌드에 가장 적합한 로직을 선택:

• Life: HP만 모니터링.
• Energy Shield (ES): ES만 모니터링.
• Life + ES: 둘 다 모니터링.
• Mind Over Matter (MOM): MP 모니터링(종종 피해 경감에 사용).
• MOM + Life: MP와 HP 모니터링.
• MOM + ES: MP와 ES 모니터링.
• All: HP, ES, MP를 동시에 모니터링.

4. 임계값 설정

물약이 사용되는 시점의 정밀한 제어.

• 슬라이더: HP, ES, MP의 백분율 임계값(1-100%)을 설정합니다. 값이 이 수준 아래로 떨어지면 해당 키가 트리거됩니다.
• 스마트 표시: 선택한 Mode에 관련된 슬라이더만 표시되어 UI를 깔끔하게 유지합니다.

5. Auto Disconnect (Chicken)

체력이 위험한 수준으로 떨어지면 자동으로 로그아웃하거나 연결을 끊는 안전 기능.

• 개별 트리거: HP, ES, MP에 대한 독립적인 활성화 토글과 임계값.
• 비주얼 인디케이터: 임계값이 Vitals Overlay에 점선이나 마커로 시각화되어, 연결 끊기가 트리거되는 정확한 시점을 표시합니다.

6. 키 바인딩 및 지연

각 작업에 대해 누를 키를 구성.

• Key 1: 선택한 모드에 따라 일반적으로 Health(HP) 또는 Energy Shield(ES)에 사용.
• Key 2: 일반적으로 Mana(MP) 또는 보조 물약 트리거로 사용.
• Key 3: Energy Shield(ES) 전용 키. "All" 모드에서만 사용 가능.
• 입력 유형: 키보드 키와 Gamepad 버튼 모두 지원.
• 지연: 너무 빠른 액션 반복을 방지하기 위해 각 키에 쿨다운(밀리초)을 설정.

---

5. Radar [PoE 2]

Path of Exile 2 전용으로 설계된 고급 비주얼 어시스턴트 및 맵 오버레이 시스템. 탐색, 엔티티 추적, 필터링을 지원합니다.

주요 기능

1. 일반 설정

레이더의 핵심 동작을 사용자 정의.

• Draw Walkable Map: 게임의 내비게이션 메시(이동 가능한 지형)의 시각화를 전환합니다. 어두운 영역에서 유효한 경로를 확인하는 데 유용합니다.
  • Color: 맵 오버레이의 색상을 사용자 정의.
  • Border Thickness: 맵 경계의 윤곽 두께를 조정.
• Map Fix: 맵 정렬 문제의 보정 모드를 전환합니다.
• 가시성 로직:
  • Hide in Town/Hideout: 안전 지역에서 레이더를 자동으로 비활성화하여 혼잡을 줄입니다.
  • Hide in Background: 게임 창에 포커스가 없을 때(Alt+Tab 시) 오버레이를 숨깁니다.
  • Hide on Pause: 게임이 일시 중지되었을 때 오버레이를 숨깁니다.
  • Hide Outside Network Bubble: 서버의 업데이트 범위 밖의 엔티티를 숨겨 "고스트" 엔티티(오래된 데이터)를 방지합니다.
• Show Player Names: 플레이어 위에 이름 표시를 전환.

2. 아이콘

레이더에서 엔티티의 시각적 표현을 사용자 정의.

• 그룹: 엔티티는 그룹(Base, League, Breach, Delirium, Expedition 등)으로 분류됩니다.
• 사용자 정의: 각 그룹에 특정 아이콘을 할당하고 크기를 조정할 수 있습니다. 이를 통해 일반 몬스터, 보스, 특정 리그 메카닉을 한눈에 구분할 수 있습니다.

3. Path Finder

특정 대상까지의 선/경로를 그리는 강력한 내비게이션 도구.

• Enable Path Finder: 경로 그리기 시스템을 전환.
• Multicolor: 여러 대상 간의 구분을 개선하기 위해 경로 색상을 무작위화.
• Important POI: "관심 지점"(퀘스트 목표나 웨이포인트 등)의 표시를 선택적 텍스트 배경과 함께 전환.
• 대상 관리:
  • Add Target: 이름으로 대상을 수동 추가.
  • Add from Map: 레이더에서 객체를 클릭하여 대상으로 추가하는 인터랙티브 모드 진입.
  • Add to Global/Area: 대상을 모든 영역(Global)에서 추적할지 현재 지역(Area)에서만 추적할지 선택.
• Ignored Areas: 혼잡을 피하기 위해 특정 지역에서 Path Finder를 비활성화할 수 있습니다.

4. 필터 (엔티티 관리)

레이더에 표시되는 엔티티와 표시 방법을 미세 조정.

• Add Nearby Entities: 플레이어 근처의 유효한 엔티티(몬스터, 상자, NPC 등)에 대해 현재 메모리를 스캔하는 드롭다운 목록. 엔티티를 선택하고 "Add"를 클릭하여 즉시 필터를 생성합니다.
• Manual Input: 고급 사용자를 위해, metadata 경로를 수동으로 입력하여 필터를 추가할 수 있습니다.
• Edit Mode: 필터 옆의 "E" 버튼을 클릭하여 상세 편집기를 엽니다:
  • Name: 사용자 정의 표시 이름을 설정.
  • Color: 사용자 정의 텍스트 색상을 선택.
  • Icon: 아이콘 표시를 전환하고, 특정 아이콘을 선택하고, 크기를 조정.
  • Draw Path: 이 엔티티에 대한 경로 그리기 개별 토글(Path Finder가 활성화된 경우).
  • Ignore: 레이더에서 이 엔티티를 완전히 숨기기.

---

6. Smoother

Smoother 탭은 게임 성능을 최적화하고 비주얼 요소를 사용자 정의하도록 설계된 포괄적인 도구입니다. 게임의 데이터 파일(.ggpk 등)을 수정하여 특정 그래픽 기능을 비활성화하거나 변경합니다.

주요 기능

게임 선택 및 설정

• Game Version: Path of Exile 1과 Path of Exile 2 모두 지원.
• 경로 설정: 게임의 Content.ggpk 파일(또는 PoE 2의 경우 Bundles2 디렉토리) 경로를 지정해야 합니다. 도구에는 올바른 경로가 선택되었는지 확인하는 파일 브라우저와 유효성 검사가 포함되어 있습니다.
• 백업 시스템:
  • Create Backup: 패치 적용 전에 원본 파일의 백업을 자동으로 생성합니다.
  • Restore All: 모든 변경을 되돌리고 게임을 원래 상태로 복원하는 단일 버튼.
  • Clear Backup: 저장된 백업과 해시를 삭제합니다(새로 시작하려는 경우에 유용).
  • 게임 업데이트: 게임이 업데이트되었음을 자동으로 감지하고, 손상을 방지하기 위해 새 백업 생성을 요청합니다.

성능 패치

특정 그래픽 효과를 비활성화하는 개별 패치를 전환합니다. 이는 저사양 시스템에서 FPS를 크게 향상시킬 수 있습니다.

• Fog / Atlas Fog: 맵과 Atlas에서 안개 효과를 제거.
• Shadows & Lights: 동적 그림자와 조명 계산을 비활성화.
• Particles: 환경 파티클(비, 먼지)과 일반 파티클 효과를 제거.
• Corpses: 시체 렌더링을 방지(PoE 1 전용).
• Delirium: Delirium 리그와 관련된 시각적 안개와 오버레이를 제거.
• EpkRemoval: 더 깨끗한 비주얼을 위해 이펙트 패키지를 제거.
• Camera: 확장 카메라 줌 제한을 활성화(슬라이더로 구성 가능).

고급 사용자 정의 도구

1. Color Mods

아이템 Modifier와 스탯의 텍스트 색상을 사용자 정의.

• Search & Add: 특정 스탯(예: "Physical Damage")을 검색하고 사용자 정의 색상을 할당합니다.
• Presets: 위험한 모드(Reflect, No Regen)나 귀중한 드롭용 기본 프리셋을 포함합니다.
• Export/Import: JSON 파일을 통해 다른 사용자와 색상 구성을 공유.
• Edit Descriptions: 더 명확하게 모드의 텍스트 설명을 다시 작성할 수도 있습니다.

2. Spell Effects

특정 스펠 효과를 비활성화하는 강력한 트리 기반 편집기.

• Tree View: 카테고리별로 정리된 모든 게임 효과를 탐색.
• 선택적 비활성화: 특정 스킬(예: "Discharge", "Tornado Shot")의 효과를 비활성화하여, 모든 것을 제거하지 않고 시각적 혼잡을 줄임.
• Search: 이름으로 효과를 빠르게 검색.

3. Black Screen (성능 모드)

텍스처와 셰이더를 제거하여 필수적인 게임플레이 요소를 표시하면서 게임 월드를 대부분 검은색으로 렌더링하는 극단적인 최적화 모드.

• File Extensions: 무시할 파일 유형(예: .dds 텍스처, .wav 사운드)을 선택.
• Animation Blocks: ParticleEffects, Lights, WindEvents 등의 특정 애니메이션 카테고리를 비활성화.
• SkinMesh Settings:
  • Ignore List: Black Screen 모드에서도 표시할 특정 3D 모델(metadata)을 선택. 캐릭터, 특정 보스, 중요한 메카닉을 표시하는 데 필수적입니다.
  • Scanning: 도구가 게임 파일을 스캔하여 토글 가능한 사용 가능한 모델의 전체 목록을 구축.

---

7. AutoCraft (개발 중!)

AutoCraft 탭은 특정 Modifier가 적중될 때까지 화폐 스팸(예: Chaos Orb)을 사용하여 아이템을 제작하는 강력한 자동화 도구를 제공합니다.

개요

AutoCraft는 선택한 화폐를 아이템에 자동으로 반복 적용하는 방식으로 작동합니다. 각 적용 후, 아이템의 Modifier를 스캔하여 원하는 조건에 일치하는지 확인합니다. 일치가 발견되면 프로세스가 즉시 중지됩니다.

시작하기

Smoother 탭으로 이동 -> .ggpk 파일 경로 지정 -> Load Data 클릭 (게임 클라이언트에서 모드 정보를 가져와야 하므로 매우 중요합니다!)

1. 모듈 활성화: 메인 POEFixer 창의 AutoCraft 탭으로 이동하여 "Enable AutoCraft" 상자를 체크합니다.
2. 게임 내 활성화:
   • 게임 창으로 전환합니다.
   • 인벤토리에서 제작하려는 아이템 위에 마우스 커서를 올립니다.
   • **Ctrl + Alt**를 누릅니다.
   • AutoCraft Overlay 창이 열립니다.

인터페이스 설명 (오버레이)

제작 프로세스는 게임 내 오버레이 창을 통해 완전히 관리됩니다.

• Target Item: 현재 제작용으로 선택된 아이템의 이름을 표시.
• Currency: 사용하려는 화폐 유형(예: Chaos Orb, Orb of Alteration)을 선택하는 드롭다운 메뉴. 도구가 인벤토리의 사용 가능한 화폐를 자동 감지합니다.
• Limit: 사용할 화폐의 최대 수를 설정하는 안전 기능. 기본값은 10입니다. 이 제한에 도달하면 봇이 중지되어 모든 화폐를 실수로 잃는 것을 방지합니다.
• Search Mods:
  • 이 필드에 입력하여 특정 Modifier(예: "maximum life", "resistance")를 검색합니다.
  • 일치하는 모드 목록이 아래에 나타납니다. 모드를 클릭하여 구성용으로 선택합니다.
• 모드 구성:
  • 모드가 선택되면, 해당 스탯의 최소값을 설정할 수 있습니다(예: "+80 to Maximum Life" 이상을 원하면 값을 80으로 설정).
  • "+ Add" 버튼을 클릭하여 대상 목록에 추가.
• Target Mods List:
  • 찾고 있는 모든 조건을 표시.
  • 로직: 시스템은 "OR" 로직을 사용합니다. 즉, 이 목록의 어떤 단일 모드라도 필요한 값과 함께 아이템에서 발견되면, 제작 프로세스는 "성공"으로 중지됩니다.
  • 대상을 관리하려면 "Edit" 또는 "X"(Delete) 버튼을 사용.

제작 프로세스

1. 설정: 인벤토리에 선택한 화폐가 충분한지 확인.
2. 시작: 오버레이의 초록색 "START CRAFT" 버튼을 클릭.
3. 실행:
   • 봇이 자동으로 화폐를 우클릭.
   • 대량 적용을 활성화하기 위해 Shift를 유지.
   • 대상 아이템을 좌클릭하여 화폐를 적용.
   • 각 클릭 후, 아이템의 새로운 Modifier를 즉시 읽기.
4. 중지:
   • 성공: 일치하는 모드가 발견됨.
   • 제한 도달: 설정된 화폐 제한에 도달.
   • 수동 중지: "STOP" 버튼 클릭.
   • 오류: 아이템 또는 화폐가 이동/분실됨.

경고: 봇은 마우스 클릭을 시뮬레이션합니다. 제작 프로세스 실행 중에는 마우스를 움직이거나 키보드를 사용하지 마십시오(긴급 정지 핫키가 구성된 경우 해당 키 누르기, 또는 UI에서 Stop 클릭은 제외).

설정

AutoCraft 모듈은 UI에서 직접 설정 가능한 항목을 노출합니다:

• Timing: 클릭 간격, 스캔 타임아웃, 작업 쿨다운의 조정 가능한 지연.
• Safety: 세션당 화폐 제한, 긴급 정지 핫키 지원.
• Behavior: 대량 제작용 Shift 유지 설정, 커서 복귀 옵션.

긴급 정지: 언제든지 제작 프로세스를 즉시 중지하는 전역 핫키를 구성할 수 있습니다.

---

8. HealthBars

HealthBars 탭은 게임 월드 내 엔티티 위에 Health(HP)와 Energy Shield(ES) 바를 직접 표시하는 고도로 사용자 정의 가능한 오버레이 시스템을 제공합니다. 이 비주얼 보조 도구를 통해 고우선순위 대상을 빠르게 식별하고, 자신의 상태를 모니터링하며, Culling Strike와 같은 메카닉을 정밀하게 실행할 수 있습니다.

전역 설정

이 설정은 전체 HealthBars 시스템에 적용되거나 기본값을 정의합니다.

• Enable HealthBars: 전체 기능 켜기/끄기.
• Draw in Town / Draw in Hideout: 마을이나 은신처 같은 안전 지역에 있을 때 체력 바를 표시할지 선택.
• Interpolate Position: 엔티티의 움직임에 맞춰 체력 바의 이동을 부드럽게 합니다.
  • Interpolation Rate: 부드러움 속도(밀리초)를 조정. 낮은 값은 더 반응적이고, 높은 값은 더 부드럽습니다.
• Height Offset: 엔티티 모델 대비 모든 체력 바의 수직 위치를 전역적으로 조정(바가 너무 높이 뜨거나 모델에 겹치는 경우 유용).
• Culling Strike 임계값:
  • 몬스터가 Culling Strike 범위에 있음을 나타내기 위해 바 색상이 변경되는 HP 백분율을 정의.
  • White, Magic, Rare, Unique 몬스터에 대해 별도로 구성 가능.

엔티티 그룹

다른 유형의 엔티티에 대해 체력 바를 독립적으로 구성할 수 있습니다. 이를 통해 예를 들어, Unique 보스에는 크고 뚜렷한 바를 표시하면서 White 몬스터 바는 미묘하게 하거나 숨길 수 있습니다.

지원되는 그룹:

• White Monsters: 일반 적.
• Magic Monsters: 파란 적.
• Rare Monsters: 노란 적.
• Unique Monsters: 보스와 유니크 적.
• Friendly Monsters: 소환수와 아군 NPC.
• Player: 자신의 캐릭터와 다른 플레이어.

그룹별 설정

각 그룹에는 다음 옵션을 포함하는 접을 수 있는 섹션이 있습니다:

가시성 및 요소

• Enable Group: 이 특정 그룹의 체력 바를 전환.
• Show Health Bar: 메인 HP 바를 표시.
• Show ES Bar: Energy Shield 바를 표시(HP 바 위에 쌓임).
• Show Culling Strike: 대상이 정의된 Culling Strike 임계값 이하일 때 HP 바 색상을 변경.
• Show Text: 숫자 HP 값(예: "1.5M", "100K")을 표시.
  • Show Text Background: 가독성 향상을 위해 텍스트 뒤에 배경 상자를 추가.

색상

풀 컬러 피커로 시각적 외관을 사용자 정의(투명도 지원):

• Health Color: HP 바의 색상.
• ES Color: Energy Shield 바의 색상.
• Background Color: 바의 빈 부분의 배경색.
• Text Color: 숫자 텍스트의 색상.
• Text Background: 텍스트 배경 상자의 색상.

크기 및 레이아웃

• Scale (Width/Height): 체력 바의 크기를 조정.
• Shift (X/Y): 엔티티 대비 바의 위치를 미세 조정(픽셀 오프셋).
• Graduations: HP 백분율 추정에 도움이 되는 수직 눈금을 바에 추가.
• Border Thickness: 바 주위의 검은 윤곽 두께를 조정.
• Bar Gap: HP 바와 ES 바 사이의 수직 간격을 설정.

---

9. Atlas

Atlas 탭은 게임 내 Atlas를 위한 포괄적인 오버레이를 제공하며, 매핑 전략을 간소화하기 위한 향상된 시각화, 경로 찾기, 관리 도구를 제공합니다. 완료 추적, 특정 맵 찾기, Atlas 전체의 경로 계획을 지원합니다.

주요 기능

1. 인터랙티브 오버레이

핵심 기능은 게임 내 Atlas 화면 위에 직접 그려지는 고도로 사용자 정의 가능한 오버레이입니다.

• Enable Overlay: Atlas Overlay 시스템 전체 켜기/끄기.
• Hide When Not Focused: 게임 창에 포커스가 없을 때 오버레이를 자동으로 숨겨 리소스와 화면 공간을 절약.
• Controller Mode: 컨트롤러를 사용하는 플레이어를 위한 최적화된 내비게이션 및 표시 조정.

2. 검색 및 내비게이션

특정 맵을 쉽게 찾거나 진행 경로를 계획.

• Search Maps: 맵 이름을 입력할 수 있는 전용 검색 바(부분 일치 지원). 오버레이가 일치하는 맵을 하이라이트.
• Visual Pathfinding (Draw Lines):
  • Route Lines: 노드 간 연결선을 그려 경로를 시각화.
  • Path Thickness: 가시성 향상을 위한 조정 가능한 두께.
  • Search Lines: 현재 위치/시작 노드에서 검색 쿼리에 일치하는 맵까지 선을 그림.
  • Citadel/Tower Lines: Citadel이나 Tower 같은 중요한 목표까지 선을 그림.
  • Range Sliders: 화면 혼잡을 피하기 위해 이 선들의 최대 거리를 구성.

3. 표시 사용자 정의

현재 목표에 집중하기 위해 표시 내용을 필터링.

• Hide Completed: 이미 완료한 맵(보너스 목표 달성)을 숨기기.
• Hide Inaccessible: 현재 도달하거나 실행할 수 없는 맵을 숨기기.
• Grid System:
  • Show Grid: 더 쉬운 좌표 추정을 위해 Atlas에 그리드를 오버레이.
  • Skip Completed: 완료된 영역의 그리드 셀을 제거.
  • Custom Color: 완전히 사용자 정의 가능한 그리드 선 색상.

4. 비주얼 향상

선호도에 맞게 오버레이의 외관을 사용자 정의.

• Map Badges: 맵에 티어, 바이옴, 특정 속성을 나타내는 아이콘이나 텍스트 배지를 표시.
• Biome Borders: 특정 바이옴에 속하는 맵 주위에 색상 테두리를 그림.
  • Thickness: 조정 가능한 테두리 두께.
• Colors & Scaling:
  • Background/Font Colors: 오버레이 요소의 전역 기본 색상을 설정.
  • Scale Multiplier: 게임 UI 대비 오버레이 요소(텍스트, 아이콘)의 크기를 조정.
  • Anchor Nudge: 오버레이가 게임 창과 완벽하게 일치하지 않는 경우 정렬을 미세 조정.

5. 바이옴 및 콘텐츠 관리

특정 게임 메카닉과 지역의 하이라이트 방법에 대한 상세 제어.

• Biome Settings: 각 특정 바이옴의 가시성을 전환하고 테두리 색상을 사용자 정의.
• Content Settings:
  • Badges: 맵과 관련된 특정 콘텐츠 유형(예: Breach, Delirium, Expedition, Ritual)의 하이라이트를 구성.
  • Overrides: 각 콘텐츠 유형에 대해, 눈에 띄게 만들기 위한 사용자 정의 배경 및 글꼴 색상을 설정.

6. Map Groups

특정 전략(예: "Farming", "Boss Rushing") 추적을 위한 맵의 사용자 정의 컬렉션을 생성.

• Custom Groups: 이름이 지정된 맵 그룹을 생성.
• Organization: 그룹 재정렬, 삭제, 이름 변경.
• Styling: Atlas에서의 빠른 시각적 식별을 위해 각 그룹에 고유한 배경 및 글꼴 색상을 할당.
• Management: 이름으로 맵을 그룹에 쉽게 추가하거나 제거.

---

10. Hotkeys (Custom Hotkeys)

Hotkeys 탭은 복잡한 동작, Auto-Aim 스크립트, 반응 기반 트리거를 생성할 수 있는 강력한 자동화 및 매크로 시스템입니다. Custom Hotkeys와 System Hotkeys의 두 가지 주요 섹션으로 나뉩니다.

Custom Hotkeys

이 섹션에서는 자신만의 매크로를 정의할 수 있습니다. 그룹으로 정리하고, 특정 조건을 설정하고, 여러 작업을 연결할 수 있습니다.

그룹

• Add Group: 핫키를 정리하기 위한 새 폴더를 생성(예: "Combat", "Buffs").
• Toggle: 전체 그룹을 한 번에 활성화/비활성화.
• Rename: 그룹 이름을 더블 클릭하여 이름 변경.

핫키 설정

각 핫키는 식별 정보, 트리거/출력 키, 전역 조건, 작업 목록으로 구성됩니다.

1. 식별 정보:

   • Enabled: 개별 핫키 전환.
   • Name: 더블 클릭하여 이름 변경(예: "Auto Pot", "Aim Bot").
   • ID: 매크로 연결에 사용되는 고유 번호(예: #1).

2. 전역 조건:

   • Focus: 체크하면, 게임 창이 포그라운드에 있을 때만 핫키가 작동합니다(Alt+Tab 중 실수로 트리거되는 것을 방지).
   • Safe Zone: 체크하면, 마을과 은신처에서 핫키가 비활성화됩니다(자원 낭비를 방지).

3. 출력 키(트리거):

   • 버튼을 클릭하여 키를 할당(키보드, 마우스 또는 Gamepad).
   • 기능: 작업 실행 시 프로그램이 시뮬레이션하여 누르는 키입니다. "Chain" 작업의 수동 트리거로도 작동합니다.
   • 수정 키: Ctrl, Shift, Alt, Gamepad LT 지원.

작업

하나의 핫키에 여러 작업을 추가할 수 있습니다. 설정에 따라 순차 실행 또는 반복됩니다.

• Repeat:

  • 단순히 출력 키를 반복적으로 누릅니다.
  • Infinite: 핫키가 활성화된 동안 영구적으로 실행.
  • Count: 특정 횟수만 실행.
  • Interval: 키 누르기 간 시간(ms).

• Chain (Link Hotkeys):

  • ID로 다른 핫키를 트리거합니다.
  • Trigger Mode:
    • Program Only: 이 핫키가 자동으로 트리거된 경우에만 발동.
    • User Only: 사용자가 물리적으로 키를 누른 경우에만 발동.
    • Always: 두 경우 모두 발동.
  • Delay: 다음 핫키를 트리거하기 전 대기 시간.

• Vitals (Health / Energy Shield / Mana):

  • HP/ES/Mana가 조건을 충족할 때 키 누르기를 트리거(예: < 50%).
  • Auto-Pot, Auto-Logout, 패닉 스킬에 유용.

• Buffs / Charges:

  • Check Charges: Power/Frenzy/Endurance/Spirit 충전 횟수에 따라 트리거.
  • Check Buff: 특정 버프 이름이 존재/부재하거나 특정 스택 수/남은 시간이 있을 때 트리거.
  • Charged Staff: "charged_staff_stack"에 대한 특정 체크.

• Monster Count:

  • 특정 반경 내에 일정 수의 몬스터(선택적 Rarity 필터 포함)가 있을 때 트리거.
  • 둘러싸였을 때 AoE 스킬을 자동으로 사용하는 데 유용.

• Hold:

  • 지정된 시간(ms) 동안 출력 키를 누르고 있습니다.

• MouseMove (Auto-Aim):

  • 가장 고급 작업. 대상을 찾고, 마우스 커서를 이동시키고, (선택적으로) 키를 누릅니다.
  • 대상 유형:
    • Monster: Rarity(Normal/Magic/Rare/Unique)로 필터.
    • Chest: 유형(Strongbox, Expedition, Breach 등)으로 필터.
    • Player/NPC: 현재 영역에서 특정 이름을 선택.
    • Custom: Metadata 경로로 임의의 엔티티를 대상으로 지정.
  • 설정:
    • Radius: 대상 검색 최대 거리.
    • Hold Time: 대상을 추적하는 시간.
    • Debug Mode: 오버레이에 빨간 원(반경)과 흰색 텍스트(엔티티 metadata)를 그림.
    • Scan All: 표준 필터를 무시하고 모든 것을 대상으로 지정(테스트용).

System Hotkeys

애플리케이션 제어를 위한 내장 전역 단축키.

• Menu Toggle: 오버레이 메뉴 표시/숨기기.
• Stop Trade: 거래 자동화 긴급 정지.
• Radar - Add from Map: 커서 아래의 엔티티를 Radar 필터 목록에 추가.
• Radar - Add POI: 커서 위치에 관심 지점을 추가.

---

11. Launcher (Limited User)

Launcher 탭은 게임을 실행하기 위한 안전하고 격리된 환경을 제공합니다. 제한된 권한을 가진 Windows 계정인 "Limited Users"를 생성하고 관리하며, 이 특정 사용자 컨텍스트에서 게임을 실행할 수 있습니다. 이는 보안(샌드박싱)과 다른 설정/권한으로 게임의 여러 인스턴스를 실행하는 데 특히 유용합니다.

주요 기능

사용자 관리

이 탭의 핵심은 제한된 Windows 사용자 계정의 관리입니다.

• User Selection: 게임 실행에 사용할 Limited User 계정을 선택하는 드롭다운 메뉴.
• Create New User: "Create New" 버튼을 클릭하여 새 사용자 이름과 비밀번호를 정의하는 대화 상자를 엽니다. 이는 제한된 권한으로 시스템에 실제 Windows 사용자 계정을 생성합니다.
• Delete User: 현재 선택된 Limited User를 시스템에서 삭제.
• Manage All Users: 시스템의 모든 사용자 목록을 봅니다. 경고: 어떤 사용자든 삭제할 수 있으므로 주의하여 사용하십시오.

게임 설정

• Game Path: 게임 실행 파일의 전체 경로를 지정합니다(예: PathofExile.exe 또는 PathofExile_x64.exe).
• Browse: "..." 버튼을 사용하여 파일 탐색기를 열고 실행 파일을 선택합니다.

실행

• Launch Game: 하단의 큰 버튼으로 선택된 Limited User의 자격 증명을 사용하여 게임을 시작합니다. 애플리케이션은 백그라운드에서 사용자 로그인과 프로세스의 안전한 시작의 복잡한 과정을 처리합니다.

상세 기능

1. 격리: 다른 사용자로 게임을 실행함으로써, 게임 프로세스가 메인 사용자의 파일과 다른 실행 중인 프로세스로부터 격리됩니다.
2. 설정 저장: 런처는 선택한 게임 경로와 사용자 환경설정을 limitedUser/config.json에 자동 저장하므로, 매번 다시 입력할 필요가 없습니다.
3. 보안: 비밀번호와 자격 증명은 애플리케이션의 백엔드(LimitedUserManager)에 의해 안전하게 관리됩니다.

---

12. Logs

Logs 탭은 애플리케이션의 내부 상태를 모니터링하고, 문제를 디버그하고, 자동 작업을 실시간으로 추적할 수 있는 강력한 시스템 이벤트 뷰어입니다. 정보를 관련성 있고 읽기 쉽게 유지하기 위한 광범위한 필터링 및 관리 도구를 제공합니다.

인터페이스 개요

인터페이스는 컨트롤 바, 카테고리 필터, 로그 목록, 상태 표시줄의 네 가지 주요 영역으로 나뉩니다.

1. 컨트롤 바 (상단)

탭 상단에 위치하며, 전역 필터와 창 관리에 빠르게 접근할 수 있습니다.

• Search: 실시간 텍스트 필터. 여기에 입력하면 메시지 내용이나 타임스탬프로 로그를 즉시 필터링.
• 레벨 필터: 심각도에 따라 로그 표시/숨기기를 전환하는 토글 버튼:
  • Info: 일반 정보 메시지(파란색).
  • Warning: 잠재적 문제나 중요한 알림(노란색).
  • Error: 치명적 오류(빨간색).
  • Debug: 상세 내부 상태 정보(회색, Debug 빌드에서만 사용 가능).
• Category Filter Toggle: 필터 아이콘을 클릭하여 상세 카테고리 선택 패널을 확장/축소.
• Detach/Attach Window: Logs 탭을 별도의 떠다니는 창으로 이동. 메인 애플리케이션에서 다른 탭을 사용하면서 두 번째 모니터에 로그를 표시하는 데 유용.
• Save to File: 현재 로그 기록을 logs/ 디렉토리의 텍스트 파일로 내보내기. 지원을 위해 개발자와 공유하는 데 유용.

2. 카테고리 필터 (접을 수 있음)

확장하면, 어떤 모듈이 로그를 생성하는지 세밀하게 제어할 수 있습니다.

• Categories: Trade, Radar, AutoPot, AutoCraft, Hotkeys 등 특정 기능의 로그를 활성화하거나 비활성화할 수 있습니다.
• Trade 하위 그룹: Trade 카테고리는 정밀한 디버깅을 위해 하위 그룹으로 더 나뉩니다:
  • Connection: 거래 사이트 연결 상태.
  • Buy: 구매 작업과 클립보드 연산.
  • WebSocket: 실시간 데이터 스트림 이벤트.
  • RateLimit: API 속도 제한에 대한 경고.
  • Icon: 아이템 아이콘 로딩 상태.
• All / None: 모든 카테고리를 한 번에 활성화하거나 비활성화하는 빠른 버튼.

3. 로그 목록 (중앙)

메인 영역에 이벤트의 시간순 기록이 표시됩니다.

• 형식: 각 항목에는 타임스탬프, 레벨 아이콘, 카테고리 아이콘, 메시지가 표시됩니다.
• 컨텍스트 메뉴: 로그 항목을 우클릭하여 복사 옵션에 접근:
  • Copy Line: 선택한 로그 줄을 클립보드에 복사.
  • Copy Visible: 현재 필터링된 로그만 복사.
  • Copy All: 전체 로그 기록을 복사.
• Auto-Scroll: 수동으로 위로 스크롤하여 이전 로그를 확인하지 않는 한, 목록이 자동으로 최신 항목으로 스크롤됩니다.

4. 상태 표시줄 (하단)

통계 및 유지보수 도구를 표시.

• Counters: 메모리 내 로그의 "Total" 수와 현재 필터에 기반한 "Shown" 수를 표시.
• Clear All: 메모리에서 모든 로그 항목을 영구적으로 삭제.
• Clear Filtered: 현재 표시된(활성 필터를 통과한) 로그만 삭제.

---

13. Follow Bot

Follow Bot 탭은 캐릭터가 자동으로 다른 플레이어나 엔티티를 따라갈 수 있게 합니다. 이는 서포트 캐릭터(Aurabot)로 플레이하거나 듀얼 박싱에 특히 유용합니다.

주요 기능

1. 일반 제어

• Enable Follow Bot: 봇 시작/정지의 마스터 스위치.
• 상태 표시: 봇의 현재 상태(예: Following, WaitingForTarget, Stuck)를 색상 코딩으로 표시하여 빠른 상태 확인이 가능.

2. 대상 설정

누구를 따라갈지, 얼마나 가까이 있을지 구성.

• Target Name: 따라갈 플레이어/캐릭터의 이름을 수동 입력.
• Pick Player: 근처 플레이어를 표시하는 드롭다운 목록. 선택하면 Target Name이 자동으로 채워집니다.
• Stop Distance: 봇이 대상 쪽으로의 이동을 중지하는 거리(대상 바로 위에 서는 것을 방지).

3. 이동 설정

봇의 이동 방법과 게임과의 상호작용을 미세 조정.

• Move Key: 이동에 사용하는 키를 할당(보통 게임 내 "Force Move" 키). 버튼을 클릭하고 원하는 키를 눌러 바인딩.
• Click Ahead Distance: 봇이 현재 위치에서 얼마나 앞을 클릭하려고 하는지.
• Click Interval: 이동 클릭 간 시간(ms).
• Update Interval: 봇 로직이 실행되는 빈도.
• Path Recalc Interval: 경로 찾기 알고리즘이 대상까지의 경로를 재계산하는 빈도.
• Return Cursor: 활성화하면, 이동 클릭 후 마우스 커서를 원래 위치로 되돌립니다.
• Require Focus: 활성화하면, 게임 창이 포그라운드에 있을 때만 봇이 이동합니다.
• Disable in Town: 마을이나 은신처에 있을 때 봇을 자동으로 일시 중지.

4. Anti-Stuck 설정

봇이 막힌 상황을 처리하는 메커니즘.

• Stuck Timeout: "Stuck"을 선언하기 전 이동 없이 대기하는 시간(ms).
• Max Recovery: 포기하거나 리셋하기 전 스턱 해소 시도 횟수.

5. 디버그 설정

경로 찾기와 로직을 진단하기 위한 시각적 도구.

• Debug Overlay: 화면에 디버그 정보 그리기를 활성화.
• Show Path: 대상까지의 계산된 경로를 그림.
• Show Waypoints: 봇이 클릭하는 특정 지점을 하이라이트.
• Show Stop Radius: 봇이 멈추는 대상 주위의 원을 시각화.
• Metadata Debug: 엔티티 metadata를 보고 특정 객체까지의 경로 찾기를 테스트하는 도구(Custom Hotkeys와 유사).

---

14. Debug [PoE 2]

Debug 탭은 게임 메모리 구조를 실시간으로 검사하기 위한 저수준 검사 도구를 제공합니다. 주로 플러그인 개발자와 엔티티 데이터, 컴포넌트 값, UI 요소 계층 구조를 이해해야 하는 고급 사용자를 위해 설계되었습니다.

1. Entity List

게임에 현재 로드된 모든 엔티티를 표시하는 필터링 가능한 테이블.

• 열: Entity ID, Address, Metadata Path, Type, SubType, State, Rarity, Zone (InnerCircle/OuterCircle/Far).
• 유형 필터: 엔티티 유형으로 빠르게 필터링 — Monsters, Chests, NPCs, Players, Items, Shrines, AreaTransitions, ExpeditionMarkers, ExpeditionRemnants 등.
• 거리 필터: 특정 범위(0-5000 그리드 유닛) 내의 엔티티만 표시하는 슬라이더.
• Search: metadata 경로에 의한 텍스트 기반 검색.
• 카운트 표시: 전체 엔티티 수와 필터링된 수를 표시.

2. Entity Watch (Component Inspector)

목록의 엔티티를 클릭하여 "워치"합니다. 애플리케이션의 워커 스레드가 해당 엔티티의 상세 컴포넌트 데이터를 매 프레임 읽습니다.

사용 가능한 컴포넌트:

• Life: Health/EnergyShield/Mana 바이탈(각각 Current, Total, Regeneration, ReservedFlat, ReservedPercent 포함).

• Render: 월드 위치(X/Y/Z), 그리드 위치, 지형 높이, 모델 경계(X/Y/Z).

• Positioned: Reaction 값, IsFriendly 플래그.

• Targetable: IsTargetable, IsHighlightable, IsTargettedByPlayer, HiddenFromPlayer, MeetsQuestState 플래그.

• Animated: 현재 애니메이션 경로, 애니메이션 ID.

• Stats: CurrentWeaponIndex, IsShapeshifted, 아이템과 버프의 stat 사전(stat ID → value).

• Actor: AnimationId, AnimationName, 활성 스킬 목록(Name, UseStage, CastType, Cooldown, CanBeUsed 포함), DeployedCounts.

• Buffs: 모든 활성 버프(이름, 충전, 남은 시간, 전체 지속 시간, 물약 슬롯, 효과, 소스 엔티티 ID 포함).

• All Components: 전용 파싱이 없는 컴포넌트를 포함하여 모든 컴포넌트 이름→주소 쌍(총 34개 컴포넌트)의 전체 목록을 표시.

3. Component Explorer

전체 34개 게임 오브젝트 컴포넌트 클래스를 상세히 검사하기 위한 전용 하위 탭.

• 원본 20 컴포넌트: Actor, Animated, Buffs, Charges, Chest, DiesAfterTime, Life, MinimapIcon, Mods, NPC, Player, Positioned, Render, Shrine, Stack, StateMachine, Stats, Targetable, Transitionable, TriggerableBlockage.
• 신규 13 컴포넌트: Quality, Flask, Sockets (데이터 보유); AreaTransition, Base, Beam, ClientAnimationController, CurrencyInfo, HeartbeatClickable, Magnetic, ObjectMagicProperties, Pathfinding, Projectile (마커 전용).
• 인디케이터 열: Q (Quality), F (Flask), S (Sockets), W (기타 중요 컴포넌트)로 엔티티가 보유한 컴포넌트를 한눈에 확인.
• 거리 필터: 0-5000 그리드 유닛 범위 선택기.
• Item Properties: 아이템 엔티티의 Quality, Sockets, Flask 데이터, 유형 요약을 표시하는 결합 섹션.

4. Inventory Debug

게임의 인벤토리 시스템을 상세히 검사.

• ServerData: ServerData 컴포넌트 주소를 표시.
• Inventory List: 모든 플레이어 인벤토리(ID, Address, Name)를 표시.
• Inventory Watch: 검사할 인벤토리를 선택:
  • Slot Grid: 사용 중/빈 슬롯의 시각적 표현.
  • Item List: metadata 경로, Rarity, 슬롯 위치를 포함한 모든 아이템.
  • Item Mods: 값을 포함한 전체 모드 분석(Implicit, Explicit, Enchant, Hellscape).

5. UI Explorer

게임의 UI 요소 트리 계층 구조를 탐색.

• Game UI Root: 게임 내 UI 루트 아래의 요소(패널, 메뉴, 버튼)를 검사.
• Top-Level UI Root: 로그인/로딩 화면의 최상위 UI 루트에 접근.
• Tree Navigation: UI 요소를 확장/축소하여 자식, 주소, 속성을 확인.
• Search: 이름/경로로 요소를 필터.
• GameCullValue: UI 스케일 계산용으로 표시.

---

15. Plugins

Plugins 탭은 POEFixer의 기능을 확장하는 네이티브 C++ DLL 플러그인을 관리합니다. 플러그인은 오버레이 렌더링, 게임 데이터 접근, 기존 UI와의 원활한 통합이 가능합니다.

플러그인 관리

• Plugin List: Plugins/ 디렉토리에서 발견된 모든 플러그인을 표시.
• Enable/Disable: 개별 플러그인 켜기/끄기. 상태는 세션 간에 저장됩니다.
• 플러그인별 설정: 활성화된 각 플러그인은 Plugins 탭 내에 자체 설정 섹션을 직접 렌더링할 수 있습니다.
• SDK Version Check: 호스트가 로드 시 플러그인 SDK 버전 호환성을 검증합니다. 현재 SDK 버전: 4.

사용 가능한 플러그인

Kill Counter

영구적인 통계를 가진 포괄적인 킬/상자/사망 추적 오버레이.

• 몬스터 킬 추적: Rarity(Normal, Magic, Rare, Unique, Unknown)별로 처치한 몬스터를 카운트. 소멸 기반 감지 사용 — InnerCircle(약 60 유닛)과 OuterCircle(약 120 유닛) 존 내 엔티티를 모니터링.
• 상자 추적: 유형(Magic, Rare, Expedition, Breach, Strongbox)별로 열린 상자를 카운트. 상태 전환(닫힘 → 열림)을 감지.
• 사망 카운터: HP 전환을 모니터링하여 플레이어 사망을 추적.
• 맵별 카운터: 새로운 영역에 입장하면 자동 리셋. 새 영역에서의 첫 킬까지 이전 카운터는 표시된 채로 유지.
• 생애 합계: SQLite3 데이터베이스(Plugins/KillCount/data/killcount.db)에 저장되는 영구 통계. 영역별 세션 기록(이름, 해시, 레벨, 타임스탬프, 모든 카운터)을 추적.
• 오버레이:
  • 프로그램 메뉴가 활성화되면 드래그 가능("Drag to reposition" 힌트 표시).
  • 메뉴가 숨겨지면 비인터랙티브이고 타이틀 바 없음.
  • 불투명도 설정 가능(0-100%).
  • Map과 Total 뷰를 전환하는 탭 바(둘 다 동시에 활성화 가능).
  • 색상 구분 섹션: 주황색 헤더(Monsters), 하늘색(Chests), 빨간색(Deaths).
• Icon Atlas: 공유 Resources/radar/icons.png 스프라이트 시트에서 엔티티 유형 아이콘을 표시하며 모든 카테고리에 폴백 아이콘 사용.
• 설정: 표시할 카운터(5개 몬스터 유형 + 5개 상자 유형 + 사망) 구성, 불투명도, 오버레이 모드, 맵/생애 통계 리셋 버튼.

Ninja Pricer

poe.ninja에서 가격을 가져와 바닥 아이템, 인벤토리, 창고 탭에 표시하는 실시간 아이템 가격 오버레이.

• poe.ninja 통합: 13개 카테고리에 걸쳐 Exchange API에서 가격을 가져옴: Currency, Fragments, Abyss, Uncut Gems, Essences, Soul Cores, Idols, Runes, Omens (Ritual), Expedition, Liquid Emotions (Delirium), Catalysts (Breach), Lineage Support Gems.
• 세 가지 표시 위치:
  • Ground Items: 게임 월드에서 드롭된 아이템에 가격을 표시. 스택 수를 감지(예: "2x Divine Orb" → 가격 두 배). 위치 설정 가능: 아이템 라벨의 상단, 하단, 왼쪽, 오른쪽.
  • Inventory: 플레이어 인벤토리 그리드의 아이템에 가격을 표시. 작은 셀에 적응하는 글꼴 크기. 위치 설정 가능: 각 셀의 모서리.
  • Stash Tabs: 현재 열려 있는 창고 탭의 아이템에 가격을 표시. 창고 UI와 활성 탭 인덱스를 자동 감지.
• 가격 표시:
  • 세 가지 화폐 모드: Divine (D), Exalted (E), Chaos (C).
  • 색상 구분: 금색(>= 1 Divine), 흰색(>= 0.1 Divine), 회색(< 0.1 Divine).
  • 텍스트 크기 조정 가능(0.5x~2.0x).
• 자동 새로고침: 백그라운드 스레드가 5~60분마다 가격을 가져옴(설정 가능). 수동 새로고침 버튼 사용 가능. 오프라인 폴백을 위한 로컬 JSON 캐시.
• 리그 감지: poe2scout.com API에서 현재 리그 목록을 가져옴. 폴백 리그: Fate of the Vaal, HC Fate of the Vaal, Standard, Hardcore.
• 가시성 제어:
  • 게임에 포커스가 없을 때 숨기기.
  • 숨기기 핫키(누르고 있는 동안 오버레이를 일시적으로 숨기기).
  • 카테고리별 토글(13개 가격 카테고리 중 어느 것이든 활성화/비활성화).
• 설정: 리그 선택기, 화폐 모드, 텍스트 스케일, 위치별 표시 위치, 새로고침 간격, 카테고리 토글, 숨기기 핫키.

Example Plugin

모든 Plugin SDK 기능을 보여주는 참조 구현:

• Buff Inspector: 필터링과 진행 바가 있는 플레이어 버프 목록.
• Entity Explorer: 워치 메커니즘, 컴포넌트 트리가 있는 엔티티 디버그 목록.
• Inventory Inspector: ServerData 뷰어, 인벤토리 선택기, 슬롯 그리드, 아이템 모드.
• Memory Viewer: 헥스 덤프 뷰어, Read<T> 데모, 패턴 스캐너.
• UI Explorer: 검색과 하이라이팅이 있는 전체 UI 요소 트리 네비게이터.

플러그인 만들기

자신만의 플러그인 만들기에 대한 자세한 지침은 Plugin Development Guide를 참조하십시오. 다음을 포함합니다:

• 프로젝트 설정 및 빌드 구성
• IPlugin 인터페이스 구현
• PluginContext API 참조(v1-v4)
• 데이터 구조 및 열거형
• 일반적인 레시피와 패턴
• 드래그 가능한 오버레이 패턴
• 문제 해결 가이드

---

← Home