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

⭐ 즐겨찾기 — 이 모드의 핵심 편의 기능

• 자주 쓰는 포탈일수록 편해지는 기능입니다. 좌측 목록에서 포탈 이름을 우클릭하기만 하면 즐겨찾기로 등록되어 맨 위 "즐겨찾기" 그룹으로 올라가고, 원래 있던 분류(공개/개인/길드)에서는 빠집니다
• 한 번 등록해두면 "이게 공개였나 개인이었나" 분류를 따질 필요 없이 목록 맨 위에서 바로 클릭하면 됩니다 — 광산 셔틀, 상점, 집 포탈처럼 하루에도 몇 번씩 오가는 포탈에 등록해두면 체감 효과가 가장 큽니다
• 즐겨찾기 항목은 원래 분류를 알 수 있도록 "분류 - 포탈명"(예: 개인 - 자원창고) 형식으로 표시됩니다
• 즐겨찾기한 항목을 다시 우클릭하면 즐겨찾기가 해제되고 원래 분류로 돌아갑니다
• 좌클릭은 여전히 텔레포트 — 좌클릭/우클릭 역할이 겹치지 않아 등록과 이동을 헷갈릴 일이 없습니다
• 즐겨찾기는 나만 보이는 개인 설정입니다(클라이언트에 로컬로 저장) — 다른 플레이어의 목록에는 영향을 주지 않고, 재접속해도 그대로 유지됩니다

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

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

맵 클릭 텔레포트

• 포탈에 들어가면 큰 지도가 자동으로 열립니다 (M키로 직접 연 지도와는 구분됨 — 이땐 클릭 텔레포트가 동작하지 않음)
• 지도에서 포탈 핀을 왼쪽 클릭하거나 좌측 목록에서 이름을 클릭하면 그 포탈로 즉시 이동
• 포탈 목적지를 고르는 지도에서는 포탈 핀 클릭·좌측 목록 클릭 외의 다른 클릭(빈 곳 클릭, 우클릭, 더블클릭 등)은 아무 동작도 하지 않습니다 — 바닐라 지도 마킹 기능과 섞이지 않도록 막아둔 것입니다
• 포탈 트리거 밖으로 나가면 지도가 자동으로 닫힘

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

• 자기 포탈을 보며 Shift+E로 공개→개인→길드 순으로 순환
• 공개: 누구나 접근 가능
• 개인: 소유자만 접근 가능
• 길드: 같은 길드원만 접근 가능 (Guilds 모드 필요)
• 새로 설치한 포탈의 기본 모드는 Config에서 지정 가능
• 접근 모드는 맵 표시뿐 아니라 실제 텔레포트 가능 여부도 함께 제한합니다 — 개인 포탈은 소유자만, 길드 포탈은 같은 길드원만 이용할 수 있습니다

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

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

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

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

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

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

부가 기능 온오프

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

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

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

Config 파일 위치

BepInEx/config/com.korcaptain.portalmap.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.

⭐ Favorites — PortalMap's Core Convenience Feature

• The more you use a portal, the more this feature pays off. Right-click a portal's name in the left-side list to favorite it — it moves into a dedicated "Favorites" group at the top and disappears from its original category (Public/Private/Guild)
• Once favorited, you never have to remember which category it was in — just click it at the top of the list. Portals you visit several times a day (a mining shuttle, your shop, your home base) are where this feels the most useful
• Favorited entries are labeled "Category - Portal Name" (e.g. Private - Storage Base) so you can still tell which category they came from
• Right-click a favorited entry again to unfavorite it and send it back to its original category
• Left-click still teleports — left- and right-click never overlap in function, so registering a favorite and teleporting never get mixed up
• Favorites are a personal, client-local setting — they're saved locally and persist across sessions, but never affect what other players see in their own list

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

• Solves the problem of an ever-growing pile of portal pins becoming impossible to tell apart on the map, and is what makes Favorites work well in the first place
• Opening the large map shows every portal you have access to on the left side, automatically sorted into Favorites → Guild (yellow) → Private (blue) → Public (magenta) groups
• 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
• While picking a destination on this map, nothing else does anything — clicking empty space, right-click, middle-click, and double-click are all disabled so they never trigger vanilla map-marking behavior
• 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
• Access mode restricts both map visibility and actual teleport eligibility — Private portals can only be used by their owner, Guild portals only by fellow guild members

Automatic Minimap Pins & Auto-Declutter

• Every portal gets a pin and name label colored by its access mode (same colors as the browser panel: Public = magenta, Private = blue, Guild = yellow)
• 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 PortalMap 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.portalmap.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.