좀보이드 File Doesn't Exist on the Client 오류 해결 (Project Zomboid)

Published on

좀보이드 Build 42에서 File doesn't exist on the client나 on the server 오류로 튕길 때, 메시지 읽는 법과 Host 서버, 전용 서버별 해결 순서, DoLuaChecksum을 끄기 전에 알아둘 점을 정리했어요.

비 내리는 밤, 배낭을 멘 Spiffo 뒤로 좀비들이 다가오는 Project Zomboid 일러스트

친구 서버에 접속하거나 메인 메뉴의 Host로 서버를 열었는데, 캐릭터를 만들자마자 빨간 글씨로 이런 메시지가 뜨고 튕기나요?

File doesn't exist on the client: media/lua/shared/...

같은 상황에서 File doesn't exist on the server가 뜨기도 해요. 둘 다 좀보이드 멀티플레이에서 모드를 쓸 때 가장 흔한 접속 오류이고, 원인은 대부분 하나로 모여요. 서버와 접속하는 PC가 가진 파일이 서로 다르다는 거예요. 이 글은 현재 안정판인 Build 42.21을 기준으로, The Indie Stone의 패치 노트와 Steam 공식 Project Zomboid 포럼에서 운영진이 남긴 답변을 바탕으로 정리했어요. 게임 메뉴 이름은 영어 UI 기준으로 적었어요.

빠른 답변: 좀보이드 File doesn't exist on the client는 서버에 있는 파일이 접속한 PC(클라이언트)에 없다는 뜻이고, File doesn't exist on the server는 그 반대예요. Host로 연 서버라면 메인 메뉴의 Mods에서 켜 둔 모드를 모두 끄고, 서버 설정의 Steam Workshop 탭에서만 모드를 켠 다음 다시 시작하세요. 전용 서버라면 서버와 모든 플레이어가 같은 게임 버전, 같은 브랜치인지 확인하고, 모드가 업데이트됐다면 서버를 재시작하세요. 그래도 안 되면 서버 .ini 파일에서 DoLuaChecksum=false로 바꾸면 이 검사가 꺼지지만, 진짜 불일치를 숨길 뿐이라 친구끼리 쓰는 비공개 서버에서만 쓰는 마지막 수단이에요.

오류 메시지부터 읽어 보세요

접속할 때 게임은 서버와 클라이언트의 파일을 서로 비교해요. Lua 파일이 기본이고, 42.20.0 패치 노트(2026년 7월 29일)부터는 XML 파일도 이 검사에 들어갔어요. 그래서 요즘은 .lua뿐 아니라 .xml 경로가 찍힌 오류도 자주 보여요.

메시지는 보통 두 줄이에요. 아래는 42.21에서 Steam 포럼에 올라온 실제 예시예요.

File doesn't exist on the client:
media/lua/shared/toc/basetimedactionoverride.lua
D:\Steam\steamapps\workshop\content\108600\3580276809\mods\The-Only-Cure\42\media\lua\shared\TOC\BaseTimedActionOverride.lua
  • 첫 번째 경로는 게임이 비교한 파일 이름이에요. 보통 전부 소문자로 적혀 있어요.
  • 두 번째 경로는 실제 파일 위치예요. workshop\content\108600\ 바로 뒤의 숫자가 그 모드의 창작마당(Workshop) ID예요. 위 예시의 3580276809를 https://steamcommunity.com/sharedfiles/filedetails/?id=3580276809에 넣으면 The Only Cure 모드 페이지가 열려요. 어떤 모드가 문제인지 바로 알 수 있죠.
  • 두 번째 경로가 steamapps\common\ProjectZomboid처럼 게임 폴더를 가리키면 모드가 아니라 게임 파일 문제예요. 아래 "모드 없이도 뜬다면"으로 가세요.
메시지뜻먼저 볼 곳
File doesn't exist on the client서버에 있는 파일이 접속한 PC에 없음Host 서버의 메인 메뉴 모드, 서버에 남은 옛 파일, 모드 버전
File doesn't exist on the server접속한 PC에 있는 파일이 서버에 없음클라이언트에 남은 옛 파일, 서버 쪽 모드 업데이트
File doesn't match the one on the server양쪽에 다 있지만 내용이 다름게임 버전과 모드 버전

Steam 포럼의 사례가 이 읽는 법을 뒷받침해요. 42.20에서 media/lua/shared/joypad/joypadsetup.lua가 없다는 on the client 오류가 났을 때, 운영진 ABH는 Host로 연 서버라면 호스트가 게임을 깨끗하게 다시 설치해야 한다고 답했어요. 서버 쪽에 남은 옛 파일이 원인이라는 거죠. 반대로 클라이언트에 Build 41 시절 파일이 남아 있으면 on the server 오류가 났다는 답변도 있었어요.

Host 버튼으로 연 서버: 메인 메뉴의 모드를 끄세요

친구들과 할 때 가장 많이 쓰는 방식이 메인 메뉴의 Host예요. 이때는 내 PC가 서버이면서 동시에 클라이언트예요. 2026년 6월부터 10월까지 Steam 포럼에는 "싱글플레이에서는 같은 모드가 멀쩡한데, Host로 열면 캐릭터를 만든 뒤 on the client나 on the server 오류가 뜬다"는 글이 계속 올라왔어요. 이런 글에 Officer 배지를 단 포럼 운영진 ABH가 안내한 방법은 이래요.

  1. 메인 메뉴의 Mods 화면에서 켜 둔 모드를 모두 끄세요.
  2. Host > Manage Settings에서 쓰는 설정을 열고, Steam Workshop 탭에 서버에서 쓸 모드가 모두 들어가 있고 켜져 있는지 확인하세요.
  3. 저장하고 서버를 시작하세요.

42.20에서 질문한 사람은 "모드를 끄니까 됐다"고 답했고, 42.21이 나온 뒤인 9월 30일 글에서도 The Only Cure로 이 오류를 겪은 사람이 "서버를 시작하기 전에 모드를 모두 끄니 정말 해결됐다"고 남겼어요.

한 가지 예외가 있어요. 모드를 구독한 상태에서 새 설정을 만들 때 화면이 멈추거나 모드 목록이 비어 있으면, ABH는 설정을 만드는 동안에는 메인 메뉴에서 모드를 켜 두라고 안내했어요. 두 답변을 합치면 순서는 이래요. 메인 메뉴에서 모드를 켜고 설정을 만들어 저장한 뒤, 서버를 시작하기 전에 메인 메뉴의 모드를 다시 끄세요.

버전이나 브랜치가 다를 때

서버와 플레이어의 게임 버전이 다르면 파일도 달라요. 2026년 11월 3일 기준 기본 브랜치(Stable)는 2026년 9월 28일에 나온 42.21이에요. 10월 27일에는 42.22가 새 Pre-Release 브랜치에 올라왔어요. Pre-Release는 기존 Unstable을 대신하는 테스트 브랜치예요. 서버와 모든 플레이어가 같은 브랜치에 있어야 해요. 42.21 패치 노트에 따르면 이제는 게임 버전이 다른 서버에 접속하려 하면 알림이 떠요.

내 PC의 브랜치 확인: Steam 라이브러리에서 Project Zomboid를 우클릭하고 속성 > 게임 버전 및 베타(Game Versions & Betas)로 가세요. 서버와 같은 브랜치를 고르면 돼요. 보통의 서버라면 기본 Stable이에요.

전용 서버 업데이트: Project Zomboid Dedicated Server의 Steam 앱 ID는 380870이에요. SteamCMD로 직접 돌리는 서버라면 설치할 때 쓴 폴더를 지정해서 다시 받으세요. 아래 경로는 예시이니 내 설치 폴더로 바꾸세요.

steamcmd +force_install_dir /home/pzserver/pzserver +login anonymous +app_update 380870 validate +quit

Pre-Release를 테스트하는 서버라면 +app_update 380870 -beta pre-release validate로 받아요. 이 경우 플레이어도 모두 Pre-Release여야 해요.

모드 업데이트: 모드 제작자가 새 버전을 올리면 플레이어 PC의 모드는 Steam이 알아서 업데이트해요. 서버는 재시작할 때 모드를 내려받으니, 모드 업데이트 뒤에는 서버를 다시 시작하세요.

File doesn't match the one on the server도 대부분 여기에 해당해요. 이 오류를 묻는 8월 27일 글에 운영진 Beard는 "클라이언트와 서버가 정확히 같은 버전인지 확인하라"고 답했어요.

모드 없이도 뜬다면: 남은 옛 파일 정리

업데이트 뒤에 예전 파일이 남아 있으면 모드가 없어도 이 오류가 나요. 앞에서 본 joypadsetup.lua가 그런 경우예요. 포럼의 다른 답변에 따르면 42.20에서 이 파일은 lua/client로 옮겨졌는데, 옛 위치에 남은 파일 때문에 접속이 막혔어요. ABH가 안내한 깨끗한 재설치 순서는 이래요. 1번은 제가 덧붙인 안전장치예요.

  1. %UserProfile%\Zomboid\Saves 폴더를 다른 곳에 복사해 두세요. Host 서버 설정을 지키려면 %UserProfile%\Zomboid\Server 폴더도 같이 복사하세요.
  2. Steam에서 게임을 삭제하세요.
  3. Steam\steamapps\common\ProjectZomboid 폴더에 남은 파일이나 폴더가 없는지 확인하고, 있으면 지우세요.
  4. %UserProfile%\Zomboid에서 Saves 폴더만 남기고 모두 지우세요.
  5. 게임을 다시 설치하세요.

누가 하느냐는 메시지에 달려 있어요. on the client라면 서버 쪽, 즉 Host로 연 호스트가 하고, on the server라면 접속하는 플레이어가 해요. 전용 서버에 옛 파일이 남은 것 같으면 서버 설치 폴더를 비우고 위의 SteamCMD 명령으로 새로 받는 게 가장 확실해요.

모드가 꼬였을 때: 구독을 취소하고 다시 받기

한 명만 계속 튕긴다면 그 플레이어의 모드 파일이 서버와 다를 가능성이 커요. 이런 글에 Beard는 모든 모드의 구독을 취소하고, 다시 구독하지 말고 그대로 서버에 접속하라고 안내했어요. 서버의 모드와 내 모드가 맞지 않기 때문이라면서, 서버 주인도 모드를 다시 설치해야 할 수 있다고 덧붙였어요. 그래도 안 되면 Steam에서 속성 > 설치된 파일 > 게임 파일 무결성 검사(Verify integrity of game files)도 해 보세요.

같은 모드의 재업로드판이나 그 모드가 들어 있는 모드팩을 함께 구독하고 있다면 하나만 남기세요. The Indie Stone은 2023년 10월 개발 블로그에서, Mod ID가 같은 여러 버전 때문에 접속할 때 파일 불일치 오류가 난다며 Build 42부터는 Mod ID 뒤에 창작마당 ID를 붙이도록 바꿨다고 설명했어요.

파일이 분명히 있는데도 뜰 때: DoLuaChecksum

가장 답답한 경우예요. 파일은 분명히 있는데도 오류가 나요. 포럼 사례를 보면 첫 번째 경로와 두 번째 경로가 대소문자만 다른 경우가 많아요. media/animsets/...와 media\AnimSets\..., toc와 TOC처럼요. 5월 13일 글에서는 Windows로 서버를 연 사람이 "두 파일은 대문자 하나만 다른데 게임이 모드가 없다고 한다"고 썼어요. 파일 이름을 바꾸면 다음 모드에서 또 막혔고, 결국 Lua 체크섬을 끄자 해결됐대요. 이 글에 ABH가 처음 던진 질문은 "리눅스를 쓰시나요?"였어요. 42.15.0 패치 노트(3월 9일)에 "클라이언트와 서버 사이의 잘못된 모드 파일 비교"를 고쳤다는 항목이 있지만, 그 뒤에도 비슷한 신고는 이어졌어요. The Indie Stone이 이 현상을 따로 설명한 공지는 찾지 못했어요.

이럴 때 쓰는 마지막 수단이 DoLuaChecksum 설정이에요. 서버와 클라이언트의 파일을 비교하는 검사를 켜고 끄는 값이에요.

Host 서버: Host > Manage Settings에서 설정을 열고, Other 항목에 있는 DoLuaChecksum을 끄세요. 8월 9일 글에서 that DAMN Library의 .xml 파일로 이 오류를 겪은 사람이 이렇게 해결했어요.

.ini 파일로 직접: 서버를 멈춘 상태에서 설정 파일을 열고 이 줄을 바꾼 뒤 서버를 다시 시작하세요.

DoLuaChecksum=false

Host 서버의 설정 파일은 %UserProfile%\Zomboid\Server 폴더에 설정 이름으로 저장돼요. 전용 서버는 서버를 실행하는 계정의 Zomboid/Server 폴더에 있고, 서버 이름을 따로 정하지 않았다면 servertest.ini예요.

끄면 무엇을 잃나요: 42.20.1 패치 노트는 Lua 체크섬 검사를 멀티플레이 안티치트의 일부로 소개해요. 끄면 서버는 플레이어가 같은 파일을 쓰는지 더 이상 확인하지 않아요. 파일을 고친 클라이언트도 들어올 수 있고, 진짜 버전 불일치가 있으면 접속할 때 분명한 메시지 대신 나중에 이상한 버그로 나타나요. 포럼에서도 "체크섬을 끄는 건 증상을 누르는 것일 뿐 해결이 아니다"라는 글이 있었어요. 그러니 친구끼리 쓰는 비공개 서버에서, 위의 방법을 다 해 본 뒤에만 쓰세요.

전용 서버라면 이 순서로 확인하세요

  1. 설정을 고치기 전에 서버를 멈추세요.
  2. 서버와 모든 플레이어가 같은 버전, 같은 브랜치(현재 Stable 42.21)인지 확인하세요.
  3. 모든 모드가 WorkshopItems=에 창작마당 ID로, Mods=에 Mod ID로 들어가 있는지 확인하세요. 자세한 방법은 Build 42 모드 설치 가이드(영어)에 있어요.
  4. 모드가 업데이트됐다면 서버를 재시작하세요.
  5. 한 명만 안 되면 그 플레이어가 모드 구독을 취소하고 다시 접속하게 하세요.
  6. 모두 안 되면 서버의 게임 파일과 모드를 다시 받으세요.
  7. 그래도 안 되고 비공개 서버라면 DoLuaChecksum=false로 바꾸세요.

Space-Node의 Project Zomboid 호스팅은 현재 안정판 브랜치로 돌아가요. 패널에서 서버 설정에 창작마당 ID와 Mod ID를 넣으면 서버를 시작할 때 모드를 자동으로 내려받고, 위의 설정도 패널에서 직접 고칠 수 있어요.

자주 묻는 질문

좀보이드 file doesn't exist on the client 오류는 왜 생기나요? 접속할 때 게임이 서버와 클라이언트의 Lua 파일, 그리고 42.20부터는 XML 파일까지 비교하는데, 서버에 있는 파일이 클라이언트에 없다고 판단하면 이 메시지를 띄우고 연결을 끊어요. 흔한 원인은 Host 서버에서 메인 메뉴의 모드가 켜져 있는 경우, 서버와 플레이어의 버전이나 모드 버전이 다른 경우, 업데이트 뒤에 남은 옛 파일이에요.

좀보이드 file doesn't exist on the server는 뭐가 다른가요? 방향만 반대예요. 접속한 PC에는 있는 파일이 서버에 없다는 뜻이에요. 클라이언트에 남은 옛 파일, 서버가 아직 받지 않은 모드 업데이트를 먼저 보세요. Host 서버라면 해결법은 같아요. 메인 메뉴의 모드를 끄고 서버 설정의 Steam Workshop 탭에서만 켜세요.

DoLuaChecksum을 꺼도 괜찮나요? 친구끼리 쓰는 비공개 서버라면 마지막 수단으로 괜찮아요. 다만 이 검사는 멀티플레이 안티치트의 일부라서, 끄면 파일을 고친 클라이언트도 들어올 수 있어요. 공개 서버라면 원인을 찾아 고치세요.

모드를 하나도 안 쓰는데 이 오류가 떠요. 업데이트 뒤에 남은 옛 게임 파일 때문일 가능성이 커요. 두 번째 경로가 게임 폴더를 가리킨다면 세이브를 백업한 뒤, 위의 깨끗한 재설치 순서대로 다시 설치하세요.

친구 한 명만 접속이 안 되고 나머지는 잘 들어와요. 그 친구의 파일 문제일 가능성이 커요. 게임 브랜치가 서버와 같은지 확인하고, 모드 구독을 모두 취소한 뒤 다시 접속하게 하세요. 그래도 안 되면 게임 파일 무결성 검사를 해 보세요.

오류 경로에 .xml 파일이 나와요. 42.20.0부터 XML 파일도 검사 대상이라서 그래요. 해결 순서는 .lua 파일일 때와 같아요.

관련 글: File Doesn't Exist On The Client 가이드(영어), Build 42 서버 모드 설치(영어)

출처

모두 2026년 11월 3일에 확인했어요.