Captain territorial

| 모드 | 버전 | 필수 여부 | |------|------|----------| | 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에서 켜면 설치 개수 제한·설치 재료비·업그레이드 재료/골드 비용을 전부 무시하고 즉시 설치·업그레이드 가능
• 연료 유지비는 그대로 적용됨 — 테스트/운영 목적의 관리자 전용 스위치

| 키 (기본값) | 대상 | 설명 | |----|------|------| | U | 설치자 | 영토 와드 업그레이드 (재료 소모) | | K | 설치자 (Lv5+) | 영토 실드 활성화/비활성화 | | R | 누구나 | 범위 링 수동 ON/OFF (와드 5m 이내에서만) | | Shift+R | 비설치자 | 와드 가입 / 탈퇴 | | Q | 누구나 (와드 호버 중) | 연료 창고 열기 | | Shift+E | 설치자 | 화이트리스트 멤버 관리 UI 열기 |

> U/K/R/Q 4개 키 모두 F1 ConfigurationManager의 General 섹션에서 자유롭게 재배정할 수 있습니다.

와드를 업그레이드하면 반경·연료·연료 창고 크기가 함께 커집니다. 모든 수치는 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 연료 또는 자신의 레벨 연료, 두 가지만 선택해 쓸 수 있습니다.

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

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

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

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 파일에 다른 값을 저장해뒀더라도 서버 접속 시 서버의 값으로 무시되고 덮어써집니다.

1. 권장: r2modman / Thunderstore에서 자동 설치
2. 수동: BepInEx/plugins/Captain_territorial/ 폴더에 DLL 복사

> ⚠️ 서버와 클라이언트(플레이어) 양쪽 모두 이 모드를 설치해야 합니다. 한쪽만 설치하면 접속이 거부되거나 정상 동작하지 않습니다 (NetworkCompatibility: EveryoneMustHaveMod).