Captain territorial

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)

연료 시스템 (지역별 나무 + 수지)

• 보조 연료는 Lv5(그레이드워프 눈)를 제외한 모든 레벨에서 수지(Resin) 1개로 통일
• 주 연료는 바이옴에 맞는 지역별 나무(나무/원목/고대나무껍질/경목/이그드라실 나무). 나무가 없는 산/바다/애쉬랜드는 흑요석 또는 나무 2종 조합으로 대체
• 와드는 기본(Lv1) 연료 또는 현재 레벨 자신의 연료, 이 두 가지 중 재고가 있는 쪽으로 자동 소모 (중간 레벨의 연료는 사용 불가)
• 연료 소모 시 와드 위에 오라 VFX + 완료 효과음 재생

화이트리스트 & 침입자 경고

• Shift+E (설치자): 멤버 관리 UI 열기 — 서버에 한 번이라도 접속했던 모든 캐릭터가 온라인/오프라인 상관없이 한 목록에 표시되며(허용됨 ✔ / 미허용 ☐), 이름을 클릭하면 즉시 허용·추방이 토글됨. 현재 접속 중이면 이름 옆에 "(온라인)" 표시
• Shift+R (비설치자): 와드 스스로 가입/탈퇴 (예전엔 Shift+E였으나, 바닐라 E(사용) 입력과 겹쳐 오작동하는 문제로 Shift+R로 변경됨)
• 승인되지 않은 플레이어가 구역 내 상자 또는 작업대를 사용하려 시도하면 (단순히 구역 안으로 걸어 들어오는 것만으로는 발동하지 않음, 10초 쿨다운):
• 경고음(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 이내에서만) |

| Shift+R | 비설치자 | 와드 가입 / 탈퇴 |

| Q | 누구나 (와드 호버 중) | 연료 창고 열기 |

| Shift+E | 설치자 | 화이트리스트 멤버 관리 UI 열기 |

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분 |

보조 연료는 Lv5(그레이드워프 눈 1개)를 제외한 모든 레벨에서 수지(Resin) 1개로 공통. 와드는 Lv1 연료 또는 자신의 레벨 연료, 두 가지만 선택해 쓸 수 있습니다.

👥 화이트리스트 UI 사용법

• 설치한 와드에 가까이 접근 (설치자만 가능)
• Shift+E 키로 멤버 관리 패널 열기
• 알려진 캐릭터 목록에 서버에 한 번이라도 접속했던 모든 캐릭터가 표시됨 — 허용된 멤버는 ✔, 아직 허용 안 된 캐릭터는 ☐로 표시되고, 현재 접속 중이면 이름 옆에 "(온라인)"이 붙음
• 이름을 클릭하면 즉시 허용/추방이 토글됨 (오프라인 캐릭터도 클릭해서 미리 추가 가능)
• 닫기 버튼으로 패널 종료

비설치자는 Shift+E 대신 Shift+R을 눌러 스스로 가입/탈퇴할 수 있습니다.

🛡️ 영토 실드 사용법

• 와드를 Lv5 이상으로 업그레이드
• 와드 연료 창고에 SurtlingCore 1개 보관
• 와드 근처에서 K키(기본값) 클릭 → SurtlingCore 1개 소모, 1시간 보호 시작
• 실드 돔 VFX 생성 + 화면에 활성 메시지 표시 (반경은 와드 레벨에 자동으로 맞춰짐)
• 호버 텍스트에 남은 시간 실시간 표시 (모든 플레이어)
• 구역 안에 있으면 화면 하단에 잔여 시간 HUD 표시
• 다시 K키를 누르면 즉시 비활성화 — 남은 시간은 버려지지 않고 저장됨
• 저장된 시간이 남아있는 동안 재활성화하면 아이템 소모 없이 재개, 다 쓰면 다시 SurtlingCore 필요

⚙️ 설정 관리 (Configuration)

ConfigurationManager (F1 키)를