비동기 ... 이벤트와 동기화 감지기
플러그인이 다른 스레드에서 게임 API에 접근했어요: 어떤 위험이 있는지, 원인을 찾는 방법을 알아봐요.
업데이트 2026년 8월 13일
java.lang.IllegalStateException: Asynchronous player tracker update!
[WARN]: Plugin ExamplePlugin tried to register listener ... asynchronously
Paper가 비동기 스레드에서 게임 월드에 접근하는 것을 감지하면 데이터를 조용히 손상시키는 대신 오류를 출력해요.
왜 중요한가요
게임 월드는 동시 접근을 고려해 설계되지 않았어요. 비동기 쓰기는 다음과 같은 문제를 일으켜요:
- 아이템 중복 및 소실;
- 잘못된 상태의 엔티티;
- 청크 손상 — 손상된 월드.
오류는 무해해 보이지만, 그 결과는 나중에 나타나며 원인과 연결되지 않아요.
어떻게 해야 하나요
- 스택 트레이스에서 플러그인을 찾아요.
- 업데이트해요: 최신 버전에서는 보통 제작자가 이 문제를 수정해요.
- 그래도 해결되지 않으면 해당 플러그인을 제거하고 대체 플러그인으로 교체한 뒤 제작자에게 알려요.
하지 말아야 할 것
코어 설정으로 검사를 비활성화하지 마세요. 검사는 문제를 만들지 않고 드러낼 뿐이에요.
관련 문서
ConcurrentModificationException — 같은 문제의 관련 증상이에요.
Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기
