API 事件

HuskSync 提供了可供你的插件监听的三个 API 事件，可以在插件同步玩家数据的过程中触发。这些事件涉及不同的 HuskSync 类，所以在阅读本章之前建议先熟悉 API 基础章节。有两个事件是可取消的（但是也会将数据同步的过程阻断），一些事件可以使用方法来修改它们的结果（例如修改保存时的数据）

阅读 Javadoc 来获得更多信息。请注意在这些事件的执行期间不应取消，因为这么做不仅花销巨大，而且可能会影响到插件运行的效率。

API 事件列表

提示

不要忘记了在监听事件调用时注册你的监听器。

Bukkit 事件类名	是否可取消	描述
BukkitDataSaveEvent	✅	在快照被创建、保存或因 DataSaveCause 而被缓存时调用
BukkitPreSync	✅	在玩家登录后通过缓存或数据库更新数据时调用
BukkitSyncCompleteEvent	❌	在玩家完成数据同步或登录后调用†

† 该事件也可在玩家登入游戏并更新数据后触发；例如，当管理员回档一名玩家、通过命令更新背包或末影箱内容或 API 强制玩家更新数据。