PotalMap

| 모드 | 필수 여부 | |------|----------| | BepInExPack_Valheim | 필수 | | Guilds | 선택 (길드 모드 사용 시에만 필요) |

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

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

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

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

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

맵 클릭 텔레포트

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

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

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

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

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

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

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

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

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

부가 기능 온오프

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

| 키 (기본값) | 대상 | 설명 | |----|------|------| | Shift+E (내 포탈을 보며) | 소유자 / 같은 길드원(Guild 모드일 때) | 접근 모드 순환 (공개→개인→길드) | | 좌클릭 (큰 지도에서 포탈 핀, 또는 좌측 목록) | 누구나 | 클릭한 포탈로 텔레포트 | | 우클릭 (좌측 목록에서 포탈 이름) | 누구나 | 즐겨찾기 등록/해제 |

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

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

Config 파일 위치

BepInEx/config/com.korcaptain.portalmap.cfg

| 카테고리 | 설명 | |----------|------| | 1 - General | 잠금 설정, 접근 모드 변경 허용 여부, 바닐라 포탈 전용 제한, 기본 접근 모드, 핀 자동 분산 온오프·반경, 모드 순환 키 | | 3 - Portal Fuel | 포탈 연료 소모 온오프, 소모 아이템, 소모 수량 | | 5 - Portal Browser | 좌측 포탈 목록 패널 온오프 | | 6 - Portal Proximity VFX | 짝 없는 포탈의 근접 발광 온오프 |

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

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

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