korCaptain-Captain_TargetPortal icon

Captain TargetPortal

Valheim Portal Mod - Restrict portal connections by Public/Private/Group/Admin/Guild mode

Last updated 2 days ago
Total downloads 33
Total rating 1 
Categories Mods Server-side Client-side AI Generated
Dependency string korCaptain-Captain_TargetPortal-1.0.11
Dependants 2 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 icon
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.2333

README

TargetPortal - Valheim Portal Mod

Ko-fi Discord

한국어 설명 보기 | 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): 잠금 설정된 항목은 서버 관리자만 변경할 수 있으며, 변경 시 접속 중인 모든 클라이언트에 즉시 강제 적용됩니다.


📥 설치 방법
  1. 권장: r2modman / Thunderstore에서 자동 설치
  2. 수동: 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
  1. Recommended: Install via r2modman / Thunderstore
  2. Manual: Copy the DLL to BepInEx/plugins/

⚠️ Both the server and every client (player) must install this mod.