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

관리자 랙 패널

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

신호등 상태

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

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

서버 상태 줄

패널 맨 위에서 서버 자체의 상태를 좋음(녹색) / 보통(노랑) / 힘듦(빨강) 신호등으로 보여줍니다.

• 패널을 연 관리자가 있을 때만 측정하므로, 아무도 패널을 열지 않으면 서버 부담이 없습니다.
• 서버와 서버 자신 사이의 핑은 의미가 없어서, 패널을 보는 관리자 PC에서 서버까지의 핑을 보여줍니다.
• 전용 서버가 아니라 플레이어 PC에서 게임을 호스트하는 경우에는 호스트 본인의 PC도 접속자 목록에 표시됩니다.

서버 클리어 (관리자 전용)

패널 오른쪽 아래 서버 클리어 버튼으로 서버에 쌓인 불필요한 오브젝트를 정리합니다. 되돌릴 수 없는 작업이라 아래 순서로만 실행됩니다.

1. 버튼을 누르면 서버가 먼저 지울 개수를 세어 미리보기로 보여줍니다: "안정적인 서버 운영을 위해 필드의 아이템 N개, 몬스터 M마리를 지웁니다."
2. 관리자가 실행을 눌러 확인해야 지워집니다(확인은 60초 안에).
3. 실행이 시작되면 접속 중인 모든 유저에게 같은 안내가 표시됩니다(모드가 설치된 유저).
4. 서버가 멈추지 않도록 프레임마다 일정 개수씩 나눠서 지웁니다.

바닥에 떨어진 아이템에는 플레이어가 일부러 바닥에 둔 물건도 포함됩니다. 서버 컨피그 [Maintenance] AllowServerClear = false로 이 기능을 완전히 끌 수 있습니다.

메모리 정리 (관리자 전용)

메모리 정리 버튼은 ① LagWatch가 쌓은 에러 기록 비우기 ② 사용하지 않는 에셋 해제 ③ GC(가비지 컬렉션) 실행을 하고, 정리 전후의 프로세스 메모리와 관리 힙(GC) 을 보여줍니다.

• 서버가 1~2초 멈출 수 있어 자동 실행은 하지 않고 관리자가 직접 누를 때만 실행됩니다(쿨타임 60초).
• 프로세스 메모리는 OS로 바로 반환되지 않아 줄지 않을 수 있습니다. 줄어드는 것은 주로 관리 힙입니다.
• 다른 모드가 가진 캐시는 비울 수 없습니다.

안내 메시지 보내기

• 행의 안내 보내기 버튼을 누르면 해당 유저에게 어떤 종류의 랙을 유발하는지와 게임을 종료하고 조치한 뒤 다시 접속해 달라는 요청이 전송됩니다.
• 메시지는 받는 유저의 게임 언어(한국어 / 영어)에 맞춰 자동으로 표시됩니다.
• 원인별 조치 안내가 함께 표시됩니다: 네트워크 불안정, 주변 오브젝트 과다, 낮은 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
• Owned objects is the number of objects the server has handed to that player to simulate. Static player-built pieces, containers and tombstones are excluded, so standing in a big base does not inflate the number (trees, monsters, items and so on are counted).
• 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.

Server status bar

The top of the panel shows the server itself with a Good (green) / Fair (yellow) / Struggling (red) light.

• It only measures while an admin has the panel open, so it costs the server nothing when nobody is looking.
• A ping from the server to itself is meaningless, so the bar shows the ping from the admin's own PC to the server.
• When the game is hosted from a player's PC instead of a dedicated server, the host's own PC also appears in the player list.

Server Clear (admins only)

The Server clear button at the bottom right of the panel removes junk objects from the server. Because it cannot be undone, it only runs in this order:

1. Pressing the button makes the server count what would be removed and show a preview: "For stable server operation, N items and M monsters in the field will be cleared."
2. The admin must press Run to confirm (within 60 seconds).
3. When it starts, every online player sees the same notice (players with the mod).
4. It deletes a fixed number of objects per frame so the server does not stall.

Ground items include things a player deliberately dropped on the floor. Set [Maintenance] AllowServerClear = false in the server config to disable the feature completely.

Free memory (admins only)

The Free memory button (1) clears LagWatch's error records, (2) unloads unused assets and (3) runs garbage collection, then shows process memory and the managed (GC) heap before and after.

• It can stall the server for a second or two, so it never runs automatically; it only runs when an admin presses it (60 second cooldown).
• Process memory is not always returned to the OS right away and may not shrink; the managed heap is what usually drops.
• It cannot clear caches held by other mods.

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.