영토 와드 시스템

• 와드를 설치해 반경 내 영토를 정의 (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/R/Q 4개 키 모두 F1 ConfigurationManager의 General 섹션에서 자유롭게 재배정할 수 있습니다.

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

보조 연료는 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

⚠️ 서버 동기화(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 1x Resin at every level except Lv5, which uses GreydwarfEye instead
• 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 — shows every character that has ever connected to the server, online or offline, in a single list (allowed = ✔, not allowed = ☐). Click a name to instantly toggle allow/kick; an "(Online)" tag appears next to currently connected players
• Shift+R (non-creator): Join/leave the ward yourself (moved from Shift+E, which conflicted with vanilla E/Use input and misfired)
• When an unauthorized player attempts to use a chest or crafting station inside the zone (simply walking into the zone does NOT trigger this; 10s cooldown per alert):
  • Alert sound (sfx_morgen_alert)
  • Center-screen warning message for every whitelist member (owner + permitted members)
  • 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
  • Projectiles (arrows, etc.) are blocked at the dome boundary
  • Monsters near the boundary turn and flee in advance, and any that still get inside are immediately pushed back outside — monsters effectively cannot exist inside the zone
  • 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, except Lv5 which uses 1x GreydwarfEye instead. 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).