Skip to content

事件 API

Strengthen 有两组 pre/post 事件,均同步发布在玩家 owner thread;post 事件只读且不可取消。

事件触发时机Cancellable可修改字段取消/结果效果
StrengthenPreAttemptEvent预览/条件通过后,摇点、重建和扣费前successRate,clamp 0–100阻止摇点、重建和扣费
StrengthenAttemptEvent尝试完全解析后;成功、失败摇点及可报告的早期失败均可发post,读取 AttemptResult、committed、outcome、operationId
StrengthenTransferEvent计算可转移星级后、目标重建前transferredStar,随后按目标上限重新限制取消或最终 <=0 阻止目标重建
StrengthenTransferCompletedEvent转移成功且目标物品重建后post;失败或取消不触发

事件中的 ItemStack 是防御性快照,不是库存槽写入口。公开操作返回的新 stack 仍由调用方写回。错误线程的公开 API 返回 WRONG_THREAD,不会通过跳过事件继续提交。