按边界排错,而不是反复重装
从运行基线、持久化、玩家事件、电网和云端契约依次缩小问题范围;每一步都保留可回滚的证据。
操作步骤
插件无法启用
核对 Java 25、Paper 26.1.2.build.74-stable、JAR 来源和 MySQL 连接。连接失败会阻止 BaseTalex.enable 继续完成。
玩家没有向导书或机器无响应
确认 PlayerData 是否载入、玩家是否通过保护检查,以及交互物品或方块是否经过系统事件入口。
机器状态丢失
区分正常禁用时的缓存保存与异常中断;先恢复数据库和 plugins/TalexSoulTech 备份,再检查机器缓存是否匹配当前版本。
电网异常
读取最近周期的网络数、未满足需求、损耗与超大网络情况,先拆分或限流,再调整产能。
控制台看不到服务器
检查当前浏览器会话的 owner 边界;服务器列表、详情、配对和快照都不会跨 user_id 返回数据。
配对或同步失败
检查配对码是否已用或过期、serverId 是否与 API Key 一致、Bearer 头是否存在以及 sequence 是否按服务器顺序递增。
扩展无法启动或更新
按审计记录检查 Context 的服务器归属、依赖拓扑、能力授权、Lua/JavaScript 沙箱装载和 LIFO disposer;失败候选应保留 last-known-good,而不是用全局权限强行启动。