Guilds가 없어도 공개/개인 모드를 포함한 나머지 기능은 전부 정상 동작합니다.

🌟 카테고리별 포탈 목록 — 포탈이 많아져도 한눈에 찾기

• 포탈이 늘어날수록 지도에서 원하는 포탈을 찾기가 점점 힘들어지는 문제를 정면으로 해결하는 PotalMap의 핵심 기능입니다
• 큰 지도를 열면 화면 좌측에 내가 접근 가능한 포탈 전부가 공개(노랑) / 개인(파랑) / 길드(빨강) 카테고리로 자동 분류되어 나열됩니다
• 지도 위에서 겹쳐 있는 핀들 사이를 눈으로 뒤질 필요 없이, 목록에서 이름을 클릭하기만 하면 그 즉시 해당 포탈로 이동합니다
• 포탈이 수십 개로 늘어나도 목록이 화면 밖으로 넘치지 않고 스크롤되며, 미니맵 핀 자체도 한 곳에 몰려있으면 자동으로 살짝 퍼져서 겹치지 않게 표시됩니다

맵 클릭 텔레포트

• 포탈에 들어가면 큰 지도가 자동으로 열립니다 (M키로 직접 연 지도와는 구분됨 — 이땐 클릭 텔레포트가 동작하지 않음)
• 지도에서 포탈 핀을 왼쪽 클릭하거나 좌측 목록에서 이름을 클릭하면 그 포탈로 즉시 이동
• 포탈 트리거 밖으로 나가면 지도가 자동으로 닫힘

접근 모드 3종 (공개 · 개인 · 길드)

• 자기 포탈을 보며 Shift+E로 공개→개인→길드 순으로 순환
• 공개: 누구나 접근 가능
• 개인: 소유자만 접근 가능
• 길드: 같은 길드원만 접근 가능 (Guilds 모드 필요)
• 새로 설치한 포탈의 기본 모드는 Config에서 지정 가능

미니맵 핀 자동 등록 & 자동 분산

• 포탈 위치에 핀과 이름표가 자동으로 뜨고, 접근 모드에 따라 색이 다릅니다 (좌측 패널과 동일한 색상 기준)
• 한 거점에 포탈이 여러 개 몰려있으면 아이콘/이름표가 겹치지 않도록 작은 원형으로 자동으로 퍼져서 표시됩니다

포탈 근접 발광 (연결 대상 없어도)

• 바닐라는 서로 짝지어진 포탈이 있어야 발광 이펙트가 켜지지만, PotalMap은 맵 클릭 텔레포트 방식이라 짝이 없어도 근처에 다가가면 포탈이 빛납니다

포탈 연료 (선택 기능, 기본 꺼짐)

• 켜면 텔레포트할 때마다 인벤토리에서 지정한 아이템(기본: 그레이드워프의 눈)을 소모합니다
• 소모 아이템 종류·수량 모두 Config로 조절 가능

부가 기능 온오프

• 포탈 브라우저 패널, 포탈 연료, 포탈 근접 발광은 전부 개별 온오프 설정이 있습니다
• 서버 관리자가 "Lock Configuration"으로 설정을 잠글 수 있습니다

모드 순환의 수정키(Shift)는 F1 ConfigurationManager의 1 - General 섹션에서 자유롭게 재배정할 수 있습니다.

ConfigurationManager (F1 키)를 사용하면 게임 내에서 GUI로 모든 설정을 조정할 수 있습니다.

Config 파일 위치

BepInEx/config/com.korcaptain.potalmap.cfg

⚠️ 서버 동기화(Server Sync): 핫키 항목(모드 순환 수정키)을 제외한 모든 설정은 서버와 동기화됩니다. "Lock Configuration"이 켜져 있으면(기본값) 서버 관리자만 값을 바꿀 수 있고, 서버 접속 시 서버의 값이 강제 적용됩니다.

1. 권장: r2modman / Thunderstore Mod Manager에서 자동 설치
2. 수동: BepInEx/plugins/PotalMap/ 폴더에 PotalMap.dll + GuildsAPI.dll + ServerSync.dll 복사

포탈 접근 모드는 서버(ZDO)에 저장되는 값이라, 원하는 경험(맵 클릭 텔레포트·모드 색상 구분)을 온전히 누리려면 서버와 참여하는 클라이언트 모두에 설치하는 것을 권장합니다.

All other features work fine without Guilds installed.

🌟 Categorized Portal List — Find Any Portal Instantly, Even With Dozens of Them

• This is PotalMap's signature feature, built to directly solve the problem of an ever-growing pile of portal pins becoming impossible to tell apart on the map
• Opening the large map shows every portal you have access to on the left side, automatically sorted into Public (yellow) / Private (blue) / Guild (red) categories
• No more squinting at overlapping pins — click a name in the list and you teleport there instantly
• The list scrolls instead of overflowing no matter how many portals exist, and pins clustered together on the map itself are automatically spread apart so they never overlap either

Map-Click Teleportation

• Entering a portal automatically opens the large map (distinct from opening the map with the M key, which does not trigger click-teleport)
• Left-click a portal pin on the map, or click a name in the left-side list, to teleport there instantly
• Leaving the portal trigger closes the map automatically

Three Access Modes (Public · Private · Guild)

• While looking at your own portal, cycle modes with Shift+E: Public → Private → Guild
• Public: anyone can use it
• Private: owner only
• Guild: same-guild members only (requires Guilds)
• The default mode for newly placed portals is configurable

Automatic Minimap Pins & Auto-Declutter

• Every portal gets a pin and name label colored by its access mode (same colors as the browser panel)
• Portals clustered close together (e.g. in one base) are automatically spread apart slightly so icons and labels never overlap

Proximity Glow Without a Paired Portal

• Vanilla only lights up a portal's glow effect once it has a matched target portal. Since PotalMap teleports via map-click instead of pairing, portals now glow whenever a player gets close, paired or not

Portal Fuel (optional, off by default)

• When enabled, teleporting consumes an item from your inventory (default: Greydwarf Eye)
• Item type and amount are both configurable

Every Optional Feature Has Its Own Toggle

• Portal Browser Panel, Portal Fuel, and Proximity VFX each have an independent enable/disable setting
• Server admins can lock the whole config via "Lock Configuration"

The mode-cycle modifier key (Shift) can be freely rebound in the 1 - General section of the F1 ConfigurationManager.

Use ConfigurationManager (F1 key) to adjust all settings in-game via GUI.

Config file location

BepInEx/config/com.korcaptain.potalmap.cfg

⚠️ Server Sync: Every setting except the hotkey (mode-cycle modifier key) is synchronized with the server. With "Lock Configuration" on (default), only server admins can change values, and the server's values are force-applied to connecting clients.

1. Recommended: Install via r2modman / Thunderstore Mod Manager
2. Manual: Copy PotalMap.dll + GuildsAPI.dll + ServerSync.dll into BepInEx/plugins/PotalMap/

Portal access modes are stored server-side (in the ZDO), so for the full intended experience (map-click teleport, color-coded modes) it's recommended that both the server and every participating client have this installed.