欢迎使用 POE2 MapGuiderWelcome to POE2 MapGuider

POE2 MapGuider 是一款专为《流放之路 2》玩家打造的辅助工具，支持横版（HB）与竖版（VB）两种布局，可自动显示地图攻略、角色信息、地图耗时与刷图时间线，减少来回切换窗口。同时支持在线排行榜、角色认证、地图点评与刷图统计。

POE2 MapGuider is a companion tool for Path of Exile 2 players. It supports both Horizontal (HB) and Vertical (VB) layouts, automatically displaying map guides, character info, map timing, and map timeline to reduce window switching. It also features an online leaderboard, character verification, map reviews, and map run statistics.

图 1.1 — POE2 MapGuider VB 竖版主界面（左右两张）Fig 1.1 — POE2 MapGuider VB main interface, shown in two screenshots

横版支持（HB 悬浮窗）Horizontal Mode (HB Overlay)

横版模式更适合边刷图边看信息：窗口置顶、紧凑显示地图/计时/攻略，并尽量不遮挡游戏操作。

HB mode is ideal for viewing info while mapping: always-on-top window, compact display of map/timer/guide, designed to not obstruct gameplay.

图 1.2 — 横版（HB）主界面Fig 1.2 — HB mode main interface

图 1.3 — 横版左侧功能按钮Fig 1.3 — HB left-side action buttons

安装与运行Installation & Setup

支持 Windows 10/11 系统，提供 exe 免安装版本和 Python 源码运行两种方式。

Supports Windows 10/11. Available as a standalone exe or Python source.

方式一：exe 直接运行（推荐）Option 1: Run exe Directly (Recommended)

1. 前往 下载入口 获取当前可用的最新版 zip 压缩包。
2. Use the download link to get the current available zip package.
3. 解压到任意目录，双击 POE2MapGuider_VB.exe 或 POE2MapGuider_HB.exe 即可。
4. Extract to any folder, then double-click POE2MapGuider_VB.exe or POE2MapGuider_HB.exe.

解压后目录结构Folder Structure After Extraction

图 1.4 — 解压后的文件夹内容Fig 1.4 — Extracted folder contents

仪表盘概览Dashboard Overview

启动后，您将看到采用深色金色主题设计的控制台，核心功能一目了然。

On startup, you'll see a dark gold-themed dashboard with core features at a glance.

PSL 排行榜预览PSL Leaderboard Preview

访问 psl.lss.lol 查看速通榜、进度榜与个人刷图统计。

Visit psl.lss.lol for speedrun rankings, progress boards, and personal map stats.

图 1.5 — 剧情速通榜Fig 1.5 — Story Speedrun Leaderboard

图 1.6 — 刷图统计页面Fig 1.6 — Map Statistics Page

角色信息同步Character Sync

支持 WeGame（国服）与 poe.ninja（国际服）角色链接绑定，粘贴后即可快速同步角色信息，包括等级、职业、生命/魔力/护盾及力敏智六维属性。绑定后数据会自动上传至排行榜。

Supports WeGame (CN server) and poe.ninja (International server) character linking. Paste the URL to sync character info including level, class, HP/MP/ES, and STR/DEX/INT. Data auto-uploads to the leaderboard after binding.

方式一：WeGame 角色绑定（国服）Option 1: WeGame Binding (CN Server)

1. 打开浏览器，访问 WeGame 流放之路2 助手 - 角色页面。
2. Open browser and visit WeGame POE2 Helper - Character Page.
3. 登录你的 WeGame 账号，在角色列表中找到要绑定的角色。
4. Log in to your WeGame account and find the character you want to bind.
5. 点击角色进入详情页，复制浏览器地址栏中的完整 URL。
6. Click the character to view details, then copy the full URL from the address bar.
7. 回到 POE2 MapGuider，将链接粘贴到角色输入框中，点击"刷新"即可完成绑定。
8. Return to POE2 MapGuider, paste the link into the character input box, and click "Refresh" to complete binding.

图 1.7a — WeGame 助手角色页面，复制地址栏 URL 即可Fig 1.7a — WeGame Helper character page, copy the URL from address bar

方式二：poe.ninja 角色绑定（国际服）Option 2: poe.ninja Binding (International Server)

1. 打开浏览器，访问 poe.ninja 账号页面，登录你的 GGG 账号。
2. Open browser and visit poe.ninja account page, log in with your GGG account.
3. 在角色列表中找到你要绑定的角色，点击角色名进入详情页。
4. Find your character in the list and click the name to view details.
5. 复制浏览器地址栏中的完整 URL（格式类似 https://poe.ninja/poe2/builds/char/账号名/角色名）。
6. Copy the full URL from the address bar (format: https://poe.ninja/poe2/builds/char/account/charname).
7. 回到 POE2 MapGuider，将链接粘贴到角色输入框中，点击"刷新"即可完成绑定。
8. Return to POE2 MapGuider, paste the link into the character input box, and click "Refresh" to complete binding.

步骤 1 — 访问 poe.ninja 账号页面Step 1 — Visit poe.ninja account page

步骤 2 — 选择要绑定的角色Step 2 — Select character to bind

步骤 3 — 进入角色详情页Step 3 — Enter character details

步骤 4 — 复制地址栏 URL 粘贴到客户端Step 4 — Copy URL and paste into client

绑定后效果After Binding

绑定成功后，客户端会自动获取并显示角色的职业、等级、六维属性等信息。同时角色数据会同步到 PSL 排行榜，你可以在 角色档案 和 刷图统计 页面查看。

After binding, the client will automatically fetch and display your character's class, level, and six attributes. Data syncs to the PSL leaderboard — view it on Profile and Map Stats pages.

图 1.7b — 角色信息面板（含六维属性与认证状态）Fig 1.7b — Character info panel with attributes and verification status

地图统计Map Statistics

工具会自动读取游戏日志（Client.txt），识别您进入的地图区域并显示攻略。

The tool automatically reads the game log (Client.txt) to identify map areas you enter and display guides.

• 1 自动识别：进入地图时自动显示地图名称。 Auto Detection: Map name displays automatically when you enter.
• 2 地图攻略：自动显示当前地图攻略、BOSS 与奖励信息，减少遗漏精魂与天赋点。 Map Guide: Automatically shows current map guide, boss info, and rewards to help you not miss spirits and skill points.
• 3 耗时统计：离开地图或返回藏身处时，自动结算该次刷图用时，并显示最近两次地图记录。 Time Tracking: Automatically calculates run time when leaving map or returning to hideout, showing last 2 map records.
• 4 剧情速通计时：自动检测剧情开始（污流河畔）与通关（金字塔避难所），全程分段计时并上报速通榜。 Story Speedrun Timer: Auto-detects story start (Fetid Mire) and completion (Ziggurat Refuge), timing all segments and reporting to leaderboard.
• 5 刷图时间线：点击计时器旁按钮查看服务器最近记录，包含进入时间、地图名、耗时与死亡数。 Map Timeline: Click the button beside the timer to view recent server records with entry time, map, duration, and deaths.
• 6 地图点评：登录后可为当前地图发布公开或私密点评，公开点评通过审核后展示给其他用户。 Map Reviews: Logged-in users can post public or private reviews for the current map. Public reviews show to others after moderation.

图 1.8 — 地图识别、区域内容与攻略展示Fig 1.8 — Map detection, area content, and guide display

刷图时间线Map Timeline

点击计时器旁的时间线按钮，可以打开当前角色的服务器刷图记录。时间线按进入时间串联最近路线，适合回看剧情推进顺序、检查单张地图耗时，以及定位死亡或卡进度的位置。

Click the timeline button beside the timer to open server-side map records for the current character. The timeline connects recent runs by entry time, making it easier to review story progression, check single-map duration, and locate deaths or progress blockers.

图 1.9 — 刷图时间线窗口Fig 1.9 — Map timeline window

图 1.10 — 地图点评窗口Fig 1.10 — Map review dialog

图 1.11 — 快捷键设置Fig 1.11 — Hotkey settings

极简计时器Minimal Story Timer

极简计时器会根据进入地图的章节自动记录剧情进度。它是独立的透明悬浮窗，可以与 HB 或 VB 主程序同时显示，不会上传到排行榜。

The minimal timer automatically records story progress from the chapter of each entered area. It is a separate transparent overlay that can stay open with HB or VB and is not uploaded to leaderboards.

1. 1在客户端菜单中选择“极简计时器”打开窗口。首次进入可识别的剧情地图后会自动开始；总计时左侧的播放、暂停图标也可手动开始、暂停或继续。Open it from the client menu. Timing starts automatically in recognized story areas; use the play and pause icon beside the total time to start, pause, or resume manually.
2. 2首次进入下一章节时，上一章节会自动结算。返回城镇、藏身处或其他非章节区域不会切换章节，当前章节仍会继续累计。The previous chapter is finalized when you first enter the next one. Towns, hideouts, and other non-chapter areas do not switch chapters, so the current chapter continues accumulating.
3. 3间歇章节的三个小节会合并累计，直到首次进入“金字塔避难所（The Ziggurat Refuge）”时才统一结算。The three intermission parts share one timer and are finalized only when you first enter The Ziggurat Refuge.
4. 4除操作按钮外，可在窗口内任意位置拖动移动；点击大号时间可收起或展开。窗口内可隐藏 / 打开主程序；重置会要求再次确认。游戏退出后计时暂停，离线时间不会计入。Drag from any non-button area to move the overlay and click the large timer to collapse or expand. The overlay can hide / open the main app, and reset requires confirmation. Timing pauses when the game exits, so offline time is excluded.

待补充配图：极简计时器的章节列表、透明窗口与控制按钮Image placeholder: Minimal timer chapter list, transparent window, and controls img/tutorial-chapter-timer.png

图 1.12 — 极简剧情章节计时器Fig 1.12 — Minimal story chapter timer

通关海报Campaign Poster

完成剧情后，客户端会根据极简计时器记录的章节耗时，以及当前角色的职业、升华、赛季和属性，生成一张本地通关海报。海报只保存在本机，不会自动公开或上传。

After completing the campaign, the client can create a local poster using chapter times, your character's class, ascendancy, season, and attributes. It is kept on your device and is never published automatically.

1. 1先使用“极简计时器”完成剧情。首次进入金字塔避难所后，本次章节耗时会自动保存为通关记录。Complete the campaign with the Minimal Timer running. On your first entry to The Ziggurat Refuge, the chapter times are saved as a completion record.
2. 2VB 在“分享平台”右侧点击“通关海报”；HB 在功能菜单中选择“通关海报”。选择一条记录后即可生成预览。In VB, click “Campaign Poster” beside “Share Platform”. In HB, select it from the tools menu. Select a record to generate a preview.
3. 3等待海报生成完成后，点击“保存 PNG”选择位置即可下载。预览会自动完整适配窗口，可直接检查角色资料和时间。When generation is complete, click “Save PNG” and choose a location. The preview automatically fits the whole poster inside the window.

待补充配图：通关记录列表、完整海报预览与“保存 PNG”按钮Image placeholder: Campaign record list, full poster preview, and Save PNG button img/tutorial-campaign-poster.png

图 1.13 — 通关海报预览与保存Fig 1.13 — Campaign poster preview and save

分享平台Share Platform

分享平台用于浏览 POE2 玩家相关的商业分享和 GM 分享。VB 可在主界面的“分享平台”按钮打开，HB 可在功能菜单中打开。

Share Platform lists POE2 player commercial shares and GM shares. Open it from the “Share Platform” button in VB or from the tools menu in HB.

1. 1浏览卡片可查看标题、发布者和目标网站。点击“打开链接”前，客户端会再次提示目标网站地址。Browse cards for their title, publisher, and destination. The client shows the target website again before opening a link.
2. 2发现不合适的玩家分享时，可点击“举报”并填写原因。GM 分享不提供举报入口。For unsuitable player shares, use “Report” and provide a reason. GM shares do not have a report action.
3. 3发布或管理自己的分享需要先登录，并拥有有效 VIP 权益；未满足条件时，客户端会说明原因。Publishing or managing your own share requires sign-in and active VIP eligibility. The client explains why when eligibility is unavailable.

待补充配图：分享平台卡片、打开链接提示与发布管理按钮Image placeholder: Share cards, external-link prompt, and publish management button img/tutorial-share-platform.png

图 1.14 — 分享平台Fig 1.14 — Share Platform

BD 推荐Build Recommendations

客户端的“BD 推荐”汇集已发布的职业与升华构筑。选择适合的构筑后，可直接下载到游戏的 BD 规划器目录；登录后还可以点赞和分享自己的构筑。

The client’s “Build Recommendations” collects published class and ascendancy builds. Download a selected build directly to the game’s Build Planner folder. After signing in, you can like builds and share your own.

浏览与筛选Browse and Filter

1. 1 使用顶部的职业 / 升华下拉框筛选构筑；每个选项后的数字表示该职业或升华已发布的构筑数量。 Use the class / ascendancy selector at the top. The number beside each option is its published build count.
2. 2 列表按序号显示，选择一项后会显示构筑名称、适用阶段、最低等级、作者与来源信息。内容较多时可使用页码切换。 Each numbered row shows build details after selection. Use page controls when more results are available.
3. 3 爱心和下载图标旁会显示对应数量；下载状态会常驻显示，方便区分已下载和未下载的构筑。 Like and download icons show their counts. The download state stays visible so downloaded and new builds are easy to distinguish.

待补充配图：BD 推荐列表与职业升华筛选Image placeholder: Build recommendation list and class filter img/tutorial-bd-recommend-list.png

图 1.15 — BD 推荐列表、职业 / 升华筛选与下载状态Fig 1.15 — Build list, class / ascendancy filter, and download state

下载并在游戏中使用Download and Use in Game

1. 1 选中构筑后，点击“下载到游戏 BD 规划器”。客户端会将对应的 .build 文件放入游戏可识别的位置。 Select a build and click “Download to Game Build Planner”. The client places the .build file where the game can read it.
2. 2 点击“打开本地目录”可查看已下载文件。默认目录为 Documents\My Games\Path of Exile 2\BuildPlanner。 Click “Open Local Folder” to view downloaded files. The default folder is Documents\My Games\Path of Exile 2\BuildPlanner.
3. 3 进入游戏后打开“BD 规划器”，即可从下拉列表选择刚下载的构筑并应用。 Open “Build Planner” in game, then select the downloaded build from its dropdown list.

待补充配图：选择构筑、下载到游戏 BD 规划器与打开本地目录Image placeholder: Select, download, and open local folder img/tutorial-bd-recommend-download.png

图 1.16 — 下载构筑与打开本地目录Fig 1.16 — Download a build and open the local folder

点赞与分享构筑Like and Share Builds

待补充配图：分享构筑、选择 build 文件与填写信息Image placeholder: Share build, select file, and fill in information img/tutorial-bd-recommend-share.png

图 1.17 — 分享 BD 构筑Fig 1.17 — Share a build

PSL 排行榜PSL Leaderboard

PSL（POE2 Speedrun Leaderboard）是配套的在线排行榜系统，支持速通榜与进度榜两种视图，数据由客户端自动上传。

PSL (POE2 Speedrun Leaderboard) is the companion online ranking system with speedrun and progress views. Data is auto-uploaded by the client.

图 2.1 — PSL 速通榜与进度榜标签页Fig 2.1 — PSL Speedrun and Progress tabs

角色档案Profile

访问 psl.lss.lol/profile 查看个人角色列表与汇总统计。

Visit psl.lss.lol/profile to view your character list and summary stats.

图 2.2 — 角色档案页面Fig 2.2 — Profile page

刷图统计Map Records

访问 psl.lss.lol/maps 查看角色级刷图详情。

Visit psl.lss.lol/maps for character-level map run details.

图 2.3 — 刷图统计页面Fig 2.3 — Map Records page

更多工具More Tools

PGT（流放之路攻略翻译助手）PGT (POE Guide Translator)

打开工具Open Tool

PGT 是面向 POE 玩家的一键攻略翻译助手，适合阅读 Ninja、Maxroll、POBB、Mobalytics 等英文攻略网站时使用，可快速把关键内容翻译成中文。

PGT is a one-click guide translation assistant for POE players, useful when reading English guide sites such as Ninja, Maxroll, POBB, and Mobalytics.

图 2.4 — PGT 流放之路攻略翻译助手Fig 2.4 — PGT POE Guide Translator

常见问题 (FAQ)FAQ

G:\POE2\logs\Client.txt
F:\WeGameApps\rail_apps\流放之路：降临(2002052)\logs\Client.txt
Documents\My Games\Path of Exile 2\logs\Client.txt

更新日志Changelog