教程 08 / 08

按边界排错,而不是反复重装

从运行基线、持久化、玩家事件、电网和云端契约依次缩小问题范围;每一步都保留可回滚的证据。

按边界排错,而不是反复重装

从运行基线、持久化、玩家事件、电网和云端契约依次缩小问题范围;每一步都保留可回滚的证据。

操作步骤

  1. 插件无法启用

    核对 Java 25、Paper 26.1.2.build.74-stable、JAR 来源和 MySQL 连接。连接失败会阻止 BaseTalex.enable 继续完成。

  2. 玩家没有向导书或机器无响应

    确认 PlayerData 是否载入、玩家是否通过保护检查,以及交互物品或方块是否经过系统事件入口。

  3. 机器状态丢失

    区分正常禁用时的缓存保存与异常中断;先恢复数据库和 plugins/TalexSoulTech 备份,再检查机器缓存是否匹配当前版本。

  4. 电网异常

    读取最近周期的网络数、未满足需求、损耗与超大网络情况,先拆分或限流,再调整产能。

  5. 控制台看不到服务器

    检查当前浏览器会话的 owner 边界;服务器列表、详情、配对和快照都不会跨 user_id 返回数据。

  6. 配对或同步失败

    检查配对码是否已用或过期、serverId 是否与 API Key 一致、Bearer 头是否存在以及 sequence 是否按服务器顺序递增。

  7. 扩展无法启动或更新

    按审计记录检查 Context 的服务器归属、依赖拓扑、能力授权、Lua/JavaScript 沙箱装载和 LIFO disposer;失败候选应保留 last-known-good,而不是用全局权限强行启动。