영토 와드 시스템

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

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

와드를 업그레이드하면 반경·연료·연료 창고 크기가 함께 커집니다.
모든 수치는 F1 Config에서 서버 관리자가 조정 가능합니다.

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

1. 설치한 와드에 가까이 접근
2. Shift+E 키로 멤버 관리 패널 열기
3. 허용된 멤버 목록에서 [추방] 버튼으로 제거
4. 온라인 플레이어 추가 목록에서 [+ 이름] 버튼으로 즉시 추가

비설치자가 Shift+E를 누르면 가입/탈퇴 전환

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

⚠️ 서버 동기화(Server Sync): 모든 설정 항목은 서버 어드민 전용입니다. 서버 관리자(발헤임 adminlist에 등록된 계정)가 F1에서 값을 바꾸면 그 값이 접속 중인 모든 클라이언트에 즉시 강제 적용됩니다. 비관리자 클라이언트는 F1에서 이 항목들을 수정할 수 없으며(잠김), 자신의 로컬 .cfg 파일에 다른 값을 저장해뒀더라도 서버 접속 시 서버의 값으로 무시되고 덮어써집니다.

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

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

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

All 4 keys (U/K/R/Q) can be freely rebound in the General section of the F1 ConfigurationManager.

Upgrading the ward grows its radius, fuel requirement, and storage size together.
All values are adjustable by server admins via F1 Config.

Secondary fuel is always 1x Resin at every level. A ward can only use its Lv1 fuel or its own level's fuel.

1. Upgrade the ward to Lv5 or higher
2. Place 1x SurtlingCore in the ward's fuel storage
3. Stand near the ward and press K (default) → consumes 1x SurtlingCore, starts 1 hour of protection
4. Shield dome VFX appears + activation message displayed (radius automatically matches the ward's level)
5. Remaining time shown in hover text for all players
6. HUD at screen bottom shows remaining time while inside the zone
7. Press K again to deactivate immediately — the remaining time is banked, not discarded
8. Reactivating while banked time remains resumes for free; once it runs out, SurtlingCore is required again

Use ConfigurationManager (F1 key) to adjust all settings in-game via GUI.

Config file location

BepInEx/config/KorCaptain_territorial_ward.cfg

⚠️ 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.

1. Recommended: Install via r2modman / Thunderstore
2. 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).