Skip to content
托管 · 错误解析

Asynchronous ... Event 与同步捕获器

插件从另一个线程访问了游戏 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 托管您离线时服务器仍在运行创建服务器