중요: 전용 서버와 모든 클라이언트 양쪽에 설치하세요. 모드가 없는 유저도 패널에는 표시되지만(핑, 오브젝트, 트래픽) FPS / 모드 정보가 없고 안내 메시지를 받을 수 없습니다. 관리자는 서버 adminlist.txt에 등록된 유저입니다.

관리자 랙 패널

• 기본 단축키 F10 (컨피그 [Client] PanelHotkey에서 변경), 관리자만 열 수 있습니다.
• 접속자 한 명이 한 줄: 핑 / FPS / 소유 오브젝트 / 송신 대기 / 트래픽 / 설치 모드 수 / 상태
• 나쁜 상태의 유저가 맨 위에 오도록 자동 정렬됩니다.
• 서버가 변화가 있을 때 보내주는 방식이라 패널을 열어 두어도 매 프레임 조회하지 않습니다.
• 행을 클릭하면 아래에 상세 정보(핑 평균/최대, FPS 평균/최저, 상위 소유 오브젝트, 설치 모드 목록)가 표시됩니다.

신호등 상태

색만으로 구분하지 않도록 신호등 색 + 글자 라벨을 함께 표시합니다. 가장 나쁜 지표가 종합 상태가 됩니다.

기본값은 아직 서버 환경에 맞게 조정되지 않은 시작값입니다. [Thresholds]에서 서버에 맞게 바꿔 주세요.

안내 메시지 보내기

• 행의 안내 보내기 버튼을 누르면 해당 유저에게 어떤 종류의 랙을 유발하는지와 게임을 종료하고 조치한 뒤 다시 접속해 달라는 요청이 전송됩니다.
• 메시지는 받는 유저의 게임 언어(한국어 / 영어)에 맞춰 자동으로 표시됩니다.
• 원인별 조치 안내가 함께 표시됩니다: 네트워크 불안정, 주변 오브젝트 과다, 낮은 FPS, 송신 대기, 과다 트래픽
• 같은 유저에게 반복 전송되지 않도록 쿨타임이 적용됩니다.

자동 경고 (선택)

• 상태가 빨강인 유저에게 안내를 자동으로 보냅니다. 기본 꺼짐이며 관리자가 패널 상단 버튼이나 컨피그([Server] AutoWarnEnabled)로 켜고 끌 수 있습니다.
• 자동 킥/차단은 하지 않습니다.

서버 진단 기록 (선택)

• 서버 랙의 원인을 나중에 분석할 수 있도록 서버 부하 요소와 자주 나는 에러를 파일로 기록합니다. 기본 꺼짐, 컨피그 [Diagnostics] Enabled로 켜고 끄며 서버 재시작이 필요 없습니다.
• 기록 위치: 서버의 BepInEx/LagWatch/diag-날짜.jsonl (주기마다 한 줄)
• 기록 항목: 서버 프레임 평균/최대 시간, 끊김 횟수, GC 메모리, 씬 오브젝트 수, ZDO 총 개수와 상위 프리팹, 자주 나는 에러 상위 10개(어느 플러그인에서 났는지 포함), 접속자별 상태
• 서버에 부하를 주지 않도록 초당 로그 처리 상한, 에러 종류 개수 상한, 하루 파일 크기 상한, 보관 일수(기본 7일)가 내장되어 있습니다. 꺼져 있으면 로그 수집 자체를 하지 않습니다.

설정 파일: BepInEx/config/captain.LagWatch.cfg (서버와 클라이언트 각각)

• 클라이언트는 평균/최저 FPS와 설치된 모드 이름(이름+버전) 을 서버로 보냅니다. 다른 정보는 보내지 않으며, 유저는 [Client] ReportEnabled = false로 끌 수 있습니다.
• FPS와 모드 목록은 클라이언트가 직접 보고한 값이라 조작될 수 있습니다. 참고용으로만 사용하세요.
• 신호등은 원인 후보를 보여주는 참고 지표이며 원인을 단정하지 않습니다.
• 패널은 마우스 조작을 위해 열 때 인벤토리를 함께 엽니다(발헤임은 인벤토리가 열려야 마우스가 동작합니다). 게임패드 조작은 아직 검증되지 않았습니다.
• 서버와 클라이언트의 통신 규약 버전이 다르면 서로의 메시지를 무시하고 로그에 경고를 남깁니다. 통신 규약이 바뀌는 업데이트는 양쪽을 함께 업데이트하세요.

Important: install on both the dedicated server and every client. Players without the mod still appear in the panel (ping, objects, traffic) but have no FPS / mod data and cannot receive notices. Admins are the players listed in the server's adminlist.txt.

Admin lag panel

• Default hotkey F10 (change it in [Client] PanelHotkey). Admins only.
• One row per player: ping / FPS / owned objects / send queue / traffic / installed mods / status
• Worst players are sorted to the top.
• The server pushes updates when data changes, so the panel does not poll every frame while open.
• Click a row to see details below: ping avg / max, FPS avg / min, top owned objects and the installed mod list.

Traffic-light status

Each row shows a light color plus a text label so the state is not conveyed by color alone. The worst metric decides the overall status.

The defaults are untuned starting points. Adjust them under [Thresholds] for your server.

Send a notice

• Press Send notice on a row to tell that player what kind of lag they cause and ask them to quit the game, fix it and rejoin.
• The text is shown automatically in the receiving player's own game language (Korean / English).
• Each cause comes with a fix hint: unstable network, too many objects nearby, low FPS, send queue, heavy traffic.
• A cooldown prevents sending to the same player repeatedly.

Auto warning (optional)

• Automatically sends the notice to players whose status is red. Off by default; admins toggle it with the button at the top of the panel or in the config ([Server] AutoWarnEnabled).
• It never kicks or bans anyone.

Server diagnostics (optional)

• Records server load factors and frequent error messages to a file for later analysis. Off by default; toggle [Diagnostics] Enabled in the config, no restart needed.
• Location: BepInEx/LagWatch/diag-YYYY-MM-DD.jsonl on the server (one line per interval)
• Recorded: server frame avg / max time, hitch count, GC memory, scene object count, total ZDOs and top prefabs, the top 10 frequent errors (including which plugin logged them) and per-player status
• Built to not load the server: a per-second log processing cap, a cap on distinct error types, a daily file size cap and retention days (default 7). When off, no log collection happens at all.

Config file: BepInEx/config/captain.LagWatch.cfg (on the server and on each client)

• Clients send their average / minimum FPS and installed mod names (name + version) to the server. Nothing else is sent, and players can turn it off with [Client] ReportEnabled = false.
• FPS and the mod list are self-reported by the client and can be faked. Use them as hints only.
• The traffic light shows likely causes for reference; it does not prove one.
• The panel opens the inventory with it so the mouse works (Valheim only accepts mouse input while the inventory is open). Gamepad use has not been verified.
• If the server and client use different protocol versions they ignore each other's messages and log a warning. Update both sides together when an update changes the protocol.