事件 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,不会通过跳过事件继续提交。