Captain Territorial - Valheim Territory Ward Mod
한국어 설명 보기 | English Description
📸 ScreenShot~!
🏰 Territory Ward Overview
(스크린샷 준비 중 / Screenshots coming soon)
🇰🇷 한국어 (Korean)
개요
Captain Territorial은 발헤임에 영토 관리 시스템을 추가하는 모드입니다.
와드를 설치하고 연료를 공급해 영토를 활성화하면, 구역 내 건설·상호작용·침입자 제어를 모두 관리할 수 있습니다.
Lv1~8 전 레벨이 완전히 구현되어 있으며, 레벨이 오를수록 반경·연료·연료 창고 크기가 함께 커집니다.
Lv5 이상에서는 실드로 구역 내 모든 건물과 플레이어를 완전히 보호하세요!
📦 필수 모드 (Dependencies)
| 모드 |
버전 |
필수 여부 |
| BepInExPack_Valheim |
5.4.2200+ |
필수 |
| Jotunn |
2.20.0+ |
필수 |
| ConfigurationManager |
최신 |
권장 (GUI 설정용) |
✨ 주요 특징
영토 와드 시스템
- 와드를 설치해 반경 내 영토를 정의 (Lv1 10m ~ Lv8 30m)
- 연료를 소모해 와드를 ON 상태 유지
- ON 상태에서만 구역 내 건설 및 상호작용 가능
- OFF 시 구역 내 모든 건설/사용 차단
- 레벨이 오를수록 연료 창고 크기도 자동으로 커짐 (Lv1 2x2 → Lv8 5x6)
연료 시스템 (지역별 나무 + 수지)
- 보조 연료는 모든 레벨에서 수지(Resin) 1개로 통일
- 주 연료는 바이옴에 맞는 지역별 나무(나무/원목/고대나무껍질/경목/이그드라실 나무). 나무가 없는 산/바다/애쉬랜드는 흑요석 또는 나무 2종 조합으로 대체
- 와드는 기본(Lv1) 연료 또는 현재 레벨 자신의 연료, 이 두 가지 중 재고가 있는 쪽으로 자동 소모 (중간 레벨의 연료는 사용 불가)
- 연료 소모 시 와드 위에 오라 VFX + 완료 효과음 재생
화이트리스트 & 침입자 경고
- Shift+E (설치자): 멤버 관리 UI 열기
- 접속 중인 플레이어를 직접 화이트리스트에 추가
- 승인되지 않은 플레이어 진입 시:
- 경고음(sfx_morgen_alert) 재생
- 화면 중앙 경고 메시지
- 침입자 머리 위 빨간 "침입자" 레이블 (1시간 유지)
- 화이트리스트 전원 채팅창 알림 전송
범위 링 & 미니맵 핀
- 건설(피스 배치) 중 와드 근처에 있으면 범위 링 자동 표시
- R키: 와드 5m 이내에서 범위 링 수동 ON/OFF 토글
- 와드 로드 / 레벨업 / 파괴 시 미니맵 핀 자동 갱신
문 자동 닫힘
- 구역 내 문을 열면 5초 후 자동으로 닫힘 (설치자 전용)
- Config에서 딜레이 시간 조정 가능
Lv5+ 영토 실드
- K키(기본값): SurtlingCore 1개 소모 → 1시간 보호 시작
- 실드 활성 중 다시 K키를 누르면 즉시 비활성화 — 이때 남은 시간은 사라지지 않고 저장됨(배너킹)
- 저장된 시간이 남아있는 동안 재활성화하면 아이템 소모 없이 그 시간부터 재개
- 실드 반경은 와드의 현재 레벨 반경과 항상 동기화 — 실드를 켠 채로 업그레이드해도 즉시 커짐
- 실드 활성 중:
- 구역 내 모든 건물(WearNTear) 데미지 차단
- 구역 내 플레이어 데미지 차단
- 구역 내 몬스터 타겟 획득 불가
- 화려한 실드 VFX 돔 표시
- 실드 남은 시간: 와드 호버 텍스트에 모든 플레이어에게 표시
- 구역 안에 있을 때 화면 하단에 HUD로 잔여 시간 표시
업그레이드 VFX/SFX
- 와드 업그레이드 성공 시 이펙트 + 효과음 재생
관리자 바이패스 (Admin Bypass)
- F1 Config에서 켜면 설치 개수 제한·설치 재료비·업그레이드 재료/골드 비용을 전부 무시하고 즉시 설치·업그레이드 가능
- 연료 유지비는 그대로 적용됨 — 테스트/운영 목적의 관리자 전용 스위치
⌨️ 키 바인딩 (F1 Config에서 재배정 가능)
| 키 (기본값) |
대상 |
설명 |
| U |
설치자 |
영토 와드 업그레이드 (재료 소모) |
| K |
설치자 (Lv5+) |
영토 실드 활성화/비활성화 |
| R |
설치자 |
범위 링 수동 ON/OFF (와드 5m 이내에서만) |
| Q |
누구나 (와드 호버 중) |
연료 창고 열기 |
| Shift+E |
설치자 |
화이트리스트 멤버 관리 UI 열기 |
| Shift+E |
비설치자 |
와드 가입 / 탈퇴 |
U/K/R/Q 4개 키 모두 F1 ConfigurationManager의 General 섹션에서 자유롭게 재배정할 수 있습니다.
🏰 레벨 시스템 (Lv1~8, 전 레벨 완전 구현)
와드를 업그레이드하면 반경·연료·연료 창고 크기가 함께 커집니다.
모든 수치는 F1 Config에서 서버 관리자가 조정 가능합니다.
| 레벨 |
바이옴 |
기본 반경 |
주 연료 |
소모 간격 |
| Lv1 |
초원 |
10m |
나무 |
3분 |
| Lv2 |
검은숲 |
13m |
원목 |
4분 |
| Lv3 |
늪지 |
16m |
고대나무껍질 |
5분 |
| Lv4 |
산 |
19m |
흑요석 |
6분 |
| Lv5 |
평원 — 실드 해금 |
22m |
경목 |
7분 |
| Lv6 |
바다 |
25m |
나무 + 원목 |
8분 |
| Lv7 |
미스트랜드 |
28m |
이그드라실 나무 |
9분 |
| Lv8 |
애쉬랜드 |
30m |
나무 + 이그드라실 나무 |
10분 |
보조 연료는 모든 레벨에서 수지(Resin) 1개로 공통. 와드는 Lv1 연료 또는 자신의 레벨 연료, 두 가지만 선택해 쓸 수 있습니다.
👥 화이트리스트 UI 사용법
- 설치한 와드에 가까이 접근
- Shift+E 키로 멤버 관리 패널 열기
- 허용된 멤버 목록에서 [추방] 버튼으로 제거
- 온라인 플레이어 추가 목록에서 [+ 이름] 버튼으로 즉시 추가
비설치자가 Shift+E를 누르면 가입/탈퇴 전환
🛡️ 영토 실드 사용법
- 와드를 Lv5 이상으로 업그레이드
- 와드 연료 창고에 SurtlingCore 1개 보관
- 와드 근처에서 K키(기본값) 클릭 → SurtlingCore 1개 소모, 1시간 보호 시작
- 실드 돔 VFX 생성 + 화면에 활성 메시지 표시 (반경은 와드 레벨에 자동으로 맞춰짐)
- 호버 텍스트에 남은 시간 실시간 표시 (모든 플레이어)
- 구역 안에 있으면 화면 하단에 잔여 시간 HUD 표시
- 다시 K키를 누르면 즉시 비활성화 — 남은 시간은 버려지지 않고 저장됨
- 저장된 시간이 남아있는 동안 재활성화하면 아이템 소모 없이 재개, 다 쓰면 다시 SurtlingCore 필요
⚙️ 설정 관리 (Configuration)
ConfigurationManager (F1 키)를 사용하면 게임 내에서 GUI로 모든 설정을 조정할 수 있습니다.
Config 파일 위치
BepInEx/config/KorCaptain_territorial_ward.cfg
| 카테고리 |
설명 |
| General |
시스템 ON/OFF, 와드 최대 설치 수, 문 자동 닫힘 딜레이, 보호막 아이템, 키 바인딩(U/K/R/Q), 관리자 바이패스 |
| Level 1 ~ Level 8 |
반경, 연료(주/보조/추가) 종류·수량, 소모 간격, 업그레이드 재료·골드 |
⚠️ 서버 동기화(Server Sync): 모든 설정 항목은 서버 어드민 전용입니다. 서버 관리자(발헤임 adminlist에 등록된 계정)가 F1에서 값을 바꾸면 그 값이 접속 중인 모든 클라이언트에 즉시 강제 적용됩니다. 비관리자 클라이언트는 F1에서 이 항목들을 수정할 수 없으며(잠김), 자신의 로컬 .cfg 파일에 다른 값을 저장해뒀더라도 서버 접속 시 서버의 값으로 무시되고 덮어써집니다.
📥 설치 방법
- 권장: r2modman / Thunderstore에서 자동 설치
- 수동:
BepInEx/plugins/Captain_territorial/ 폴더에 DLL 복사
⚠️ 서버와 클라이언트(플레이어) 양쪽 모두 이 모드를 설치해야 합니다. 한쪽만 설치하면 접속이 거부되거나 정상 동작하지 않습니다 (NetworkCompatibility: EveryoneMustHaveMod).
🌐 English
Overview
Captain Territorial is a territory management mod for Valheim.
Place a Territory Ward, supply fuel to keep it active, and control who can build, interact, and enter your zone.
All levels (Lv1–8) are fully implemented — radius, fuel, and storage size all scale up as the ward levels up.
At Lv5+, activate the Shield to fully protect all structures and players inside!
📦 Dependencies
| Mod |
Version |
Required |
| BepInExPack_Valheim |
5.4.2200+ |
Required |
| Jotunn |
2.20.0+ |
Required |
| ConfigurationManager |
Latest |
Recommended (GUI settings) |
✨ Key Features
Territory Ward System
- Place a ward to define a radius-based territory (10m at Lv1 up to 30m at Lv8)
- Consume fuel to keep the ward ON
- Building and interaction only allowed inside an active ward zone
- Ward OFF = all construction and item use blocked
- Fuel storage size grows automatically with level (2x2 at Lv1 → 5x6 at Lv8)
Fuel System (Regional Wood + Resin)
- Secondary fuel is unified to 1x Resin at every level
- Primary fuel is a biome-appropriate regional wood (Wood / RoundLog / ElderBark / FineWood / YggdrasilWood). Biomes without a natural wood (Mountain / Ocean / Ashlands) use Obsidian or a combination of two wood types instead
- A ward can consume either its base (Lv1) fuel or its own current-level fuel, whichever is in stock (intermediate levels' fuel cannot be used)
- Consuming fuel plays an aura VFX and completion sound above the ward
Whitelist & Intrusion Alerts
- Shift+E (creator): Open member management UI
- Add online players directly to the whitelist
- Unauthorized player enters zone triggers:
- Alert sound (sfx_morgen_alert)
- Center-screen warning message
- Red "침입자 / Intruder" label above their head (lasts 1 hour)
- Chat notification broadcast to all whitelist members
Range Ring & Minimap Pin
- Ward radius ring auto-displays during construction near the ward
- R key: Manually toggle range ring within 5m of the ward
- Minimap pin auto-updated on ward load / level-up / destruction
Door Auto-Close
- Doors inside the ward zone automatically close after 5 seconds (owner only)
- Delay configurable via Config
Lv5+ Territory Shield
- K key (default): Consume 1x SurtlingCore → starts 1 hour of protection
- Pressing K again while active deactivates immediately — the remaining time is banked, not lost
- Reactivating while banked time remains resumes for free (no item consumed)
- Shield radius always stays in sync with the ward's current level radius — upgrading while shielded grows it instantly
- While shield is active:
- All structures (WearNTear) in zone: damage blocked
- All players in zone: damage blocked
- Monsters inside zone: cannot acquire targets
- Shield VFX dome displayed
- Shield remaining time shown in hover text to all players
- HUD displayed at screen bottom when inside the zone
Upgrade VFX/SFX
- Plays a visual effect and sound cue when the ward upgrade succeeds
Admin Bypass
- Toggle in F1 Config to ignore the placement limit, placement material cost, and upgrade material/gold cost entirely — instant placement/upgrade
- Fuel upkeep still applies as normal — an admin-only switch for testing/operations
⌨️ Key Bindings (rebindable in F1 Config)
| Key (default) |
Target |
Description |
| U |
Creator |
Upgrade Territory Ward (consumes materials) |
| K |
Creator (Lv5+) |
Activate/deactivate Territory Shield |
| R |
Creator |
Toggle range ring ON/OFF (within 5m of ward) |
| Q |
Anyone (hovering the ward) |
Open fuel storage |
| Shift+E |
Creator |
Open whitelist member management UI |
| Shift+E |
Non-creator |
Join / leave ward |
All 4 keys (U/K/R/Q) can be freely rebound in the General section of the F1 ConfigurationManager.
🏰 Level System (Lv1~8, fully implemented)
Upgrading the ward grows its radius, fuel requirement, and storage size together.
All values are adjustable by server admins via F1 Config.
| Level |
Biome |
Default Radius |
Primary Fuel |
Interval |
| Lv1 |
Meadows |
10m |
Wood |
3 min |
| Lv2 |
Black Forest |
13m |
RoundLog |
4 min |
| Lv3 |
Swamp |
16m |
ElderBark |
5 min |
| Lv4 |
Mountain |
19m |
Obsidian |
6 min |
| Lv5 |
Plains — Shield unlocked |
22m |
FineWood |
7 min |
| Lv6 |
Ocean |
25m |
Wood + RoundLog |
8 min |
| Lv7 |
Mistlands |
28m |
YggdrasilWood |
9 min |
| Lv8 |
Ashlands |
30m |
Wood + YggdrasilWood |
10 min |
Secondary fuel is always 1x Resin at every level. A ward can only use its Lv1 fuel or its own level's fuel.
🛡️ How to Use the Shield
- Upgrade the ward to Lv5 or higher
- Place 1x SurtlingCore in the ward's fuel storage
- Stand near the ward and press K (default) → consumes 1x SurtlingCore, starts 1 hour of protection
- Shield dome VFX appears + activation message displayed (radius automatically matches the ward's level)
- Remaining time shown in hover text for all players
- HUD at screen bottom shows remaining time while inside the zone
- Press K again to deactivate immediately — the remaining time is banked, not discarded
- Reactivating while banked time remains resumes for free; once it runs out, SurtlingCore is required again
⚙️ Configuration
Use ConfigurationManager (F1 key) to adjust all settings in-game via GUI.
Config file location
BepInEx/config/KorCaptain_territorial_ward.cfg
| Category |
Description |
| General |
System on/off, max ward count, door auto-close delay, shield item, key bindings (U/K/R/Q), Admin Bypass |
| Level 1 ~ Level 8 |
Radius, fuel (primary/secondary/tertiary) type & amount, consumption interval, upgrade materials & gold |
⚠️ Server Sync: Every setting is server-admin-only. When the server admin (an account listed in Valheim's adminlist) changes a value in F1, it is immediately force-applied to all connected clients. Non-admin clients cannot edit these settings in F1 (locked), and even if a client has a different value saved in their own local .cfg file, it is ignored and overwritten by the server's value upon connecting.
📥 Installation
- Recommended: Install via r2modman / Thunderstore
- Manual: Copy DLL to
BepInEx/plugins/Captain_territorial/
⚠️ Both the server and every client (player) must install this mod. If only one side has it, connections will be rejected or the mod won't function correctly (NetworkCompatibility: EveryoneMustHaveMod).
