TaCZ 1.1.4-hotfix를 사용하는 Minecraft 클라이언트에서 리스폰이나 차원 이동 후 ClientChunkCache에서 ServerChunkCache로의 ClassCastException이 발생하면, 부착물 캐시가 제대로 갱신되지 않을 수 있어. 우리가 만든 추가 모드는 테스트한 Forge 1.19.2 환경에서 바로 이 오류 경로를 해결해 줘. 이 모드를 Minecraft 인스턴스의 mods 폴더에 추가로 넣고, 기존 TaCZ 파일은 그대로 유지하면 돼.
필요한 것: Minecraft 1.19.2, Forge 43.x, TaCZ 1.1.4-hotfix. 우리는 Forge 43.5.0과 Java 17로 테스트했어. 이 추가 모드는 영향을 받는 모든 플레이어의 클라이언트에 설치해야 해. 이 모드는 mcfreehost이 만든 자체 호환성 수정이며 공식 TaCZ 릴리스가 아니야.
이 TaCZ 오류는 어떻게 알아볼까?
문제가 발생한 리스폰 직후 Minecraft 인스턴스 안의 logs/latest.log 파일을 열어 봐. 핵심 메시지에는 두 클래스가 모두 나와: ClientChunkCache cannot be cast to ServerChunkCache. 관련 스택에는 PacketDistributor.trackingEntity, NetworkHandler.sendToTrackingEntity, LivingEntityDrawGun.draw, RefreshClonePlayerDataEvent가 나타나. 서버에서만 오류 메시지가 보이거나 다른 내용의 크래시라면 이 진단에는 해당하지 않아.
TaCZ는 로컬 플레이어 객체가 교체될 때 무기 데이터를 갱신해. 확인한 버전에서는 이 클라이언트 경로가 서버 측에서 추적 중인 플레이어에게 전송하는 함수를 호출해. 이때 Forge는 서버 청크 캐시를 기대하지만 클라이언트 청크 캐시를 받게 돼. 이 예외 때문에 부착물 캐시가 완전히 다시 만들어지기 전에 함수가 중단돼.
이것은 이 코드 경로의 오류야. 서버 RAM을 늘려도 잘못된 타입 변환은 해결되지 않아. 반대로 이 로그 메시지가 없는 무기 문제라면 같은 오류라고 단정할 수 없어. 그럴 때는 버전, 다른 모드, 실제 크래시 리포트를 확인해 봐.
추가 모드 다운로드 및 확인
tacz-clonefix-1.19.2-1.0.0.jar를 다운로드해. 파일 크기는 2,613바이트야. SHA-256은 다음과 같아:
4211368ec9461ad28f1c90d3d2faff7c9ad2b974bbc8b730008d730338bbcdc7
Windows에서는 PowerShell의 Get-FileHash -Algorithm SHA256에 다운로드한 파일 경로를 넣어 확인할 수 있어. macOS에서는 해당 파일 경로와 함께 shasum -a 256을 사용하면 돼. 해시 전체를 비교해 봐. 16진수 출력의 대소문자는 상관없어. 해시가 다르면 검증된 파일과 같은 파일이 아니라는 뜻이야. 이 경우 파일을 설치하지 말고 링크된 출처에서 다시 다운로드해.
이 추가 모드는 TaCZ JAR를 대체하지 않아. 원본 파일 tacz-1.19.2-1.1.4-hotfix-all.jar는 그대로 설치된 상태여야 해. 인스턴스에 없다면 Modrinth에서 알맞은 원본 버전을 받아. Minecraft 1.20.1, NeoForge, 다른 TaCZ 버전에 대해서는 이 추가 모드를 배포하지 않았어.
기술적으로 다시 검증하고 싶다면 빌드 안내가 포함된 소스 패키지와 소스 패키지 체크섬을 확인할 수 있어. ZIP의 SHA-256은 484b50152fa905e9959d8bf2e3cb9b700d8cd35fb77bb50c79beba5d47a878bb야. 자체 소스는 MIT 라이선스이며, Minecraft, Forge, 원본 TaCZ는 포함되어 있지 않아. 원인과 수정 제안은 TaCZ 프로젝트의 GitHub 버그 리포트로 제출했어. 그곳에 정리된 비교 증빙이 링크되어 있어.
올바른 Minecraft 클라이언트에 설치하기
- Minecraft를 완전히 종료해. 런처에서 모드가 적용된 서버에 접속할 때 실제로 사용하는 인스턴스의 폴더를 열어. 프로필이 여러 개라면 각각 다른
mods폴더를 가질 수 있어. - 추가 JAR 파일만 이
mods폴더에 복사해. 나머지 모드와 기존 TaCZ 파일은 그대로 둬. 우리 추가 모드를 두 개 동시에 설치하지 마. - 같은 인스턴스를 Minecraft 1.19.2와 Forge로 실행해. 모드 목록에서 TaCZ와
TaCZ 1.19.2 client clone refresh fix항목이 로드되었는지 확인해. - 가능하면 별도의 테스트 서버에서 시험해 봐. 리스폰하기 전에 월드를 백업하고, 소중한 아이템은 인벤토리에서 보관함으로 옮겨 둬. 게임 규칙에 따라 사망 시 잃어버릴 수 있어. 서버에 접속해서 먼저 안전한 곳에서 무기를 테스트해 봐. 그다음 일반 리스폰과 차원 이동을 해 봐. 무기, 부착물, 그리고 새로운
logs/latest.log에 앞서 설명한 오류 경로가 있는지 확인해.
영향을 받는 모든 동료 플레이어는 자신의 클라이언트에 이 추가 모드를 설치해야 해. 서버의 mods 폴더에만 업로드해서는 클라이언트 기능이 고쳐지지 않아. 우리 비교용 서버는 변경 없는 원본 TaCZ로, 추가 모드 없이 실행했어. 이 수정을 위해 월드를 변경하거나 서버 권한을 추가할 필요는 없어.
실제로 무엇을 테스트했을까?
2026년 10월 9일에 같은 Forge 1.19.2 환경에서 원본 버전과 추가 모드를 비교했어. 의도적으로 발생시킨 캐시 갱신 4회에서 원본은 설명한 예외와 함께 중단되었고, 추가 모드는 4회 모두 완료하며 소음기 캐시를 다시 만들었어. 기능 테스트에서는 클라이언트와 전용 서버가 AK47과 tacz:muzzle_silencer_ursus 부착물로 쏜 동일한 28발을 확인했어. 리스폰과 오버월드-네더 이동도 포함되었어.
첫 번째 그래픽 비교는 모드 파일 58개가 있는 더 큰 구성에서 진행했어. 의도적으로 발생시킨 4회의 갱신은 실제 TaCZ 플레이어 경로를 확인했고, 이를 위해 호출 전에 캐시를 비웠어. 일반적으로 플레이할 때는 이 확인 절차를 할 필요가 없어. 이 비교에서는 원본도 사격은 할 수 있었어. 그래서 이 추가 모드로 모든 사격 문제가 사라진다고 약속하지는 않아. 다른 무기, 다른 부착물, 싱글플레이는 완전히 검증하지 않았어.
추가로 진행한 격리 비교에서는 콘텐츠 모드로 TaCZ만 사용했고 자체 측정 도구를 함께 썼어. TaCZ 없는 Forge에서는 설명한 오류가 나타나지 않았어. 원본에서는 일반적인 플레이어 교체 때 발생했고 추가 모드에서는 발생하지 않았어. 여기서도 의도적으로 발생시킨 캐시 갱신 4회는 원본에서 실패했고 추가 모드에서는 4회 모두 성공했어. 이 Linux 테스트는 월드 렌더링을 중지한 상태에서 네트워크와 플레이어 데이터를 확인한 것으로, 별도의 그래픽 벤치마크는 아니야. 추가 사격 측정에서는 로컬 성공 보고 22건과 서버 이벤트 21건이 나왔어. 네더 이동 후 확인되지 않은 사격 1건의 원인은 아직 밝혀지지 않았어. 위에서 말한 확인된 28발은 별도의 그래픽 테스트에서 나온 결과야.
원인은 원본 TaCZ 1.19.2 코드에서 직접 따라가 볼 수 있어. 이 수정은 논리적 클라이언트 측에서 서버 이벤트와 서버 전송만 건너뛰고, 리셋, 무기 매핑, 부착물 갱신은 계속 실행돼.
FAQ
추가 모드는 어떻게 다시 제거하나요?
Minecraft를 종료하고 해당 인스턴스에서 tacz-clonefix-1.19.2-1.0.0.jar만 제거해. TaCZ와 나머지 모드는 그대로 둬. 다음 실행부터는 다시 원래 경로가 활성화돼.
다른 오류가 나거나 새 TaCZ 버전이 나오면 어떻게 하나요?
먼저 정확한 메시지와 로드된 버전을 비교해 봐. 다른 오류라면 이 가이드는 검증된 해결 방법이 아니야. 공식 버전에서 같은 오류가 수정되면 버전 상태를 확인하고 권장 사항을 업데이트할게. 다른 TaCZ 버전과 함께 이 추가 모드를 검증 없이 설치하지 마.
이를 위해 더 큰 호스팅 요금제가 필요한가요?
이 타입 변환 오류에는 요금제를 바꿔도 도움이 되지 않아. 대형 모드팩은 자체적으로 RAM 요구 사항이 있을 수 있어. 새 모드 서버를 만들기 전에 사용하려는 모드팩의 최소 요구 사항을 확인해. 더 간단한 구성이라면 mcfreehost의 무료 Minecraft 서버를 이용할 수 있어. 다만 이것이 모드팩 호환성을 보장하지는 않아. 가이드와 추가 모드 다운로드는 계속 무료로 이용할 수 있어.
편집 및 검증 현황: mcfreehost, 2026년 10월 9일 기술 검증. 테스트한 버전 범위를 공개하고, 알맞은 공식 수정이 확인되면 권장 사항을 조정할게. 다른 오류는 버전 정보와 정리한 로그를 첨부해 문의 양식으로 알려 줘.