Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
Captain TargetPortal
Valheim Portal Mod - Restrict portal connections by Public/Private/Group/Admin/Guild mode
| Date uploaded | 2 days ago |
| Version | 1.0.11 |
| Download link | korCaptain-Captain_TargetPortal-1.0.11.zip |
| Downloads | 32 |
| Dependency string | korCaptain-Captain_TargetPortal-1.0.11 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2333README
TargetPortal - Valheim Portal Mod
한국어 설명 보기 | English Description
🇰🇷 한국어 (Korean)
개요
TargetPortal은 발헤임 포탈을 확장해, 굳이 두 포탈을 짝지어 연결하지 않아도 지도에서 목적지 포탈을 직접 클릭해 순간이동할 수 있게 해주는 모드입니다. 포탈마다 Public / Private / Group / Admin / Guild 5가지 모드를 지정해 누가 그 포탈을 사용할 수 있는지 제어할 수 있습니다.
본 모드는 Smoothbrain의 TargetPortal을 기반으로 수정 및 보완하여 제작되었습니다.
📦 필수/선택 모드 (Dependencies)
| 모드 | 버전 | 필수 여부 |
|---|---|---|
| BepInExPack_Valheim | 5.4.2333+ | 필수 |
| Groups | 최신 | 선택 (설치 시 Group 모드 사용 가능) |
| Guilds | 최신 | 선택 (설치 시 Guild 모드 사용 가능) |
Groups/Guilds는 설치하지 않아도 모드 자체는 정상 동작합니다 — 해당 포탈 모드만 다음 단계(보통 Private)로 자동 강등됩니다.
✨ 주요 특징
포탈 5종 모드
- Public: 누구나 사용 가능 (기본값)
- Private: 설치자 본인만 사용 가능
- Group(Groups 모드 필요): 설치 당시 파티 + 현재 온라인 파티원만 사용 가능
- Admin: 서버 관리자만 사용 가능
- Guild(Guilds 모드 필요): 설치자와 같은 길드원만 사용 가능
포탈 앞에서 **설정된 수정키(기본 Left Shift) + 사용키(E)**를 누르면 모드가 순서대로 전환됩니다. 호버 텍스트에 현재 모드와 소유자가 표시됩니다.
연결 없이 바로 이동
발헤임 기본 포탈처럼 이름표를 맞춰 짝지을 필요가 없습니다. 포탈에 들어가면 지도가 자동으로 열리고, 사용 권한이 있는 목적지 포탈을 클릭하면 즉시 그 위치로 이동합니다.
지도 핀 필터링
지도에는 내가 실제로 사용 가능한 포탈만 핀으로 표시됩니다(Public/내 Private/내 Group/내 Guild/내가 관리자면 Admin까지). 파티장이나 길드장이 잠깐 접속을 끊어도, 저장된 파티/길드 소속 정보로 연속성을 판단하므로 포탈 연결이 끊기지 않습니다.
즐겨찾기
지도에서 포탈 핀을 우클릭하면 즐겨찾기에 추가/제거됩니다. 즐겨찾기한 포탈은 지도 좌측에 목록으로 표시되어 바로 클릭해 이동할 수 있습니다.
설정 가능 항목
- 포탈 최대 개수 제한 (0 = 무제한)
- 포탈 이름 최대 길이
- 아이템 제한 무시 여부 (텔레포트 금지 아이템 소지 시)
- 새로 지어지는 포탈의 기본 모드
- 지도가 닫혀 있어도 포탈 아이콘 토글 단축키 사용 허용 여부
- 포탈 회전 애니메이션 표시 여부
- 포탈 선택용 지도에서 다른 핀 숨기기 / 플레이어 핀 표시 여부
⌨️ 키 바인딩 (F1 Config에서 재배정 가능)
| 키 (기본값) | 대상 | 설명 |
|---|---|---|
| 수정키(Left Shift) + E | 포탈 앞 | 포탈 모드 순환 전환 |
| P | 지도 열림 중 | 포탈 아이콘 표시 ON/OFF 토글 |
| 좌클릭 | 목적지 선택 모드 | 클릭한 포탈로 순간이동 |
| 우클릭 | 목적지 선택 모드 | 포탈 즐겨찾기 추가/제거 |
⚙️ 설정 관리 (Configuration)
ConfigurationManager (F1 키)를 사용하면 게임 내에서 GUI로 모든 설정을 조정할 수 있습니다.
⚠️ 서버 동기화(Server Sync): 잠금 설정된 항목은 서버 관리자만 변경할 수 있으며, 변경 시 접속 중인 모든 클라이언트에 즉시 강제 적용됩니다.
📥 설치 방법
- 권장: r2modman / Thunderstore에서 자동 설치
- 수동:
BepInEx/plugins/폴더에 DLL 복사
⚠️ 서버와 클라이언트(플레이어) 양쪽 모두 이 모드를 설치해야 합니다.
🌐 English
Overview
TargetPortal extends Valheim's portals so you no longer need to name-match two portals to connect them — just click a destination portal directly on the map to teleport there. Each portal can be set to one of five modes (Public / Private / Group / Admin / Guild) controlling who is allowed to use it.
This mod is based on TargetPortal by Smoothbrain, modified and improved upon.
📦 Dependencies
| Mod | Version | Required |
|---|---|---|
| BepInExPack_Valheim | 5.4.2333+ | Required |
| Groups | Latest | Optional (enables Group mode) |
| Guilds | Latest | Optional (enables Guild mode) |
The mod works fine without Groups/Guilds installed — those specific portal modes are simply demoted to the next available mode.
✨ Key Features
Five Portal Modes
- Public: Anyone can use it (default)
- Private: Only the owner can use it
- Group (requires Groups): Usable by the party the portal was created with, plus currently online party members
- Admin: Only server admins can use it
- Guild (requires Guilds): Usable by anyone in the owner's guild
Press the configured modifier key (default Left Shift) + interact (E) in front of a portal to cycle through the modes. Hover text shows the current mode and owner.
Teleport Without Connecting Portals
No need to name-match two portals like vanilla. Walking into a portal auto-opens the map — click any destination portal you have permission to use and you're teleported there instantly.
Filtered Map Pins
Only portals you can actually use are shown on the map (Public / your Private / your Group's / your Guild's / Admin if you are one). Party and guild continuity is tracked so a portal doesn't lose connection just because the party leader or guild leader briefly logs out.
Favorites
Right-click a portal pin on the map to add/remove it from your favorites. Favorited portals appear as a quick-click list on the side of the large map.
Configurable Options
- Maximum number of portals in the world (0 = unlimited)
- Maximum portal name length
- Ignore item teleport restrictions (for items that normally block teleporting)
- Default mode for newly built portals
- Allow toggling portal icons even while the map is closed
- Toggle the portal whirl animation
- Hide other map pins / show player pins while selecting a destination
⌨️ Key Bindings (rebindable in F1 Config)
| Key (default) | Context | Description |
|---|---|---|
| Modifier (Left Shift) + E | At a portal | Cycle portal mode |
| P | Map open | Toggle portal icons ON/OFF |
| Left Click | Destination-select mode | Teleport to clicked portal |
| Right Click | Destination-select mode | Add/remove favorite |
⚙️ Configuration
Use ConfigurationManager (F1 key) to adjust all settings in-game via GUI.
⚠️ Server Sync: Locked settings are server-admin-only and are force-applied to all connected clients when changed.
📥 Installation
- Recommended: Install via r2modman / Thunderstore
- Manual: Copy the DLL to
BepInEx/plugins/
⚠️ Both the server and every client (player) must install this mod.
CHANGELOG
Changelog / 변경 로그
[1.2.4] - 2026-07-26
Files Modified / 수정 파일
Map.cs · TargetPortal.cs
- ✅fix1 : [Map.cs] Group-mode portals lost their connection when the party leader briefly logged out, since access was checked by "is the owner currently online" — switched to a party-continuity check based on the group membership recorded when the portal's mode was set (owner online-in-my-party OR my ID/any currently online party member overlaps with the recorded membership)
- ✅fix2 : [Map.cs] Guild-mode access check compared owner by both ID and name (a struct equality check) instead of ID alone, which could incorrectly deny access after a display-name change
- ✅improve1 : [TargetPortal.cs]
SetPortalMode()now also records the current party's member IDs on the portal's ZDO (TargetPortal GroupMembers) when switching to Group mode, and theTargetPortals ChangePortalModeRPC signature was extended to carry this data - ✅fix1 : [Map.cs] 파티장이 잠깐 접속을 끊으면 Group 모드 포탈 연결이 끊기던 문제 수정 — "소유자가 현재 온라인인가"로 판정하던 것을, 포탈 모드 설정 당시 기록된 파티원 정보 기반의 파티 연속성 체크(소유자가 내 파티에 온라인 중이거나, 내 ID/현재 온라인 파티원 중 하나가 기록된 멤버 목록과 겹침)로 변경
- ✅fix2 : [Map.cs] 길드 모드 접근 판정이 소유자를 ID+이름 동시 비교(구조체 비교)로 하고 있어, 표시 이름이 바뀌면 정상 길드원인데도 접근이 거부될 수 있던 문제 수정 — ID만으로 비교하도록 변경
- ✅improve1 : [TargetPortal.cs] Group 모드로 전환할 때 현재 파티원 ID 목록을 포탈 ZDO(
TargetPortal GroupMembers)에 함께 기록하도록 개선,TargetPortals ChangePortalModeRPC 시그니처를 이 데이터를 담도록 확장