Asynchronous ... Event 与同步捕获器
插件从另一个线程访问了游戏 API:这会带来哪些风险,以及如何找出罪魁祸首。
更新于 2026年8月13日
java.lang.IllegalStateException: Asynchronous player tracker update!
[WARN]: Plugin ExamplePlugin tried to register listener ... asynchronously
Paper 会捕获来自异步线程的游戏世界访问,并输出错误,而不是静默地损坏数据。
为什么这很重要
游戏世界并非为并发访问而设计。异步写入会导致:
- 物品重复和丢失;
- 实体处于无效状态;
- 区块损坏——世界损坏。
这个错误看起来无害,但后果会在之后出现,并且与原因没有关联。
该怎么做
- 从堆栈跟踪中找到对应的插件。
- 更新它:在较新的版本中,作者通常会修复这个问题。
- 如果这没有帮助,请移除它并替换为替代方案,并向作者报告。
不该做什么
不要通过核心设置禁用该检查。它不会制造问题,而是揭示问题。
相关
ConcurrentModificationException——同一病症的相关症状。
Minecraft 托管您离线时服务器仍在运行创建服务器
