Skip to content
호스팅 · 오류 분석

비동기 ... 이벤트와 동기화 감지기

플러그인이 다른 스레드에서 게임 API에 접근했어요: 어떤 위험이 있는지, 원인을 찾는 방법을 알아봐요.

업데이트 2026년 8월 13일

java.lang.IllegalStateException: Asynchronous player tracker update!
[WARN]: Plugin ExamplePlugin tried to register listener ... asynchronously

Paper가 비동기 스레드에서 게임 월드에 접근하는 것을 감지하면 데이터를 조용히 손상시키는 대신 오류를 출력해요.

왜 중요한가요

게임 월드는 동시 접근을 고려해 설계되지 않았어요. 비동기 쓰기는 다음과 같은 문제를 일으켜요:

  • 아이템 중복 및 소실;
  • 잘못된 상태의 엔티티;
  • 청크 손상 — 손상된 월드.

오류는 무해해 보이지만, 그 결과는 나중에 나타나며 원인과 연결되지 않아요.

어떻게 해야 하나요

  1. 스택 트레이스에서 플러그인을 찾아요.
  2. 업데이트해요: 최신 버전에서는 보통 제작자가 이 문제를 수정해요.
  3. 그래도 해결되지 않으면 해당 플러그인을 제거하고 대체 플러그인으로 교체한 뒤 제작자에게 알려요.

하지 말아야 할 것

코어 설정으로 검사를 비활성화하지 마세요. 검사는 문제를 만들지 않고 드러낼 뿐이에요.

관련 문서

ConcurrentModificationException — 같은 문제의 관련 증상이에요.

Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기