二次开发 娱乐 [全版本] WarZShiTu — 高自定义重制版师徒系统 | 全中文GUI | 名师商店 | Folia适配 | 旧数据兼容 2.2.3

[MD] ## v2.2.3 — 2026-10-20 ### 修复 1. **修复 1.20.x 及以下版本 `/shitu gui` 后台报错** - 修复 `IncompatibleClassChangeError: Found class org.bukkit.inventory.InventoryView, but interface was expected`。 - 原因为 1.21+ API 将 `InventoryView` 由抽象类改为接口，编译期生成的 `invokeinterface` 调用在旧版服务端（InventoryView 仍为类）无法解析。 - 改为通过 `Inventory#getViewers()` 判断玩家是否仍在浏览菜单，全版本通用，不再触碰 `InventoryView` 方法。 ### 其他 - 无配置项变更，`config-version` 保持 `5`。 - 产物：`WarZShiTu-2.2.3.jar` ### 升级提示（2.2.2 → 2.2.3） 1. 替换 jar 并重启服务器。 2. 无需合并或重置 `config.yml`。 [/MD]

• GUI 先显示普通头颅，皮肤加载完全异步。
• 皮肤纹理缓存到 skull-cache.properties。
• 网络失败或超时不会阻塞主线程。
• 支持配置皮肤 API 代理地址。
• 主菜单、徒弟列表、商店均避免同步 SkullMeta owner 解析。

[MD] ### 修复 1. **修复 1.12.2 首次打开 `/shitu gui` 卡顿** - 规避旧版 Bukkit/Spigot 在 `SkullMeta#setOwner` 首次解析玩家头像/档案时可能阻塞主线程的问题。 - GUI 玩家头颅优先使用在线玩家已有 profile，避免触发同步查询。 - 旧版服务端遇到离线或未缓存玩家名时跳过 owner 绑定，显示普通头颅，优先保证服务器不卡顿。 - 修复主菜单“我的档案”和徒弟列表头像可能导致首次打开 GUI 卡服的问题。 [/MD]

[MD] ## v2.2.0 — 2026-07-16 ### 新增 1. **同 IP 拜师限制** - 配置：`settings.same-ip-restrict.enabled`（默认 `true`） - 绕过权限：`warzshitu.bypass.sameip`（可配置 `bypass-permission`） - 申请拜师与收徒确认时都会校验 - 无法获取 IP 时放行，避免代理环境误伤 - 消息：`messages.same-ip-blocked`、`messages.same-ip-blocked-master` 2. **名师商店限购** - 商品可配置： ```yaml limit: amount: 2 period: weekly # daily / weekly / monthly / lifetime ``` - `amount: 0` 或不写 `limit` = 不限购 - 进度写入玩家数据 `shop-purchases` - 消息：`messages.mentor-shop-limit-reached` - GUI lore 支持：`%limit%`、`%bought%`、`%remaining%`、`%period%` 3. **每个徒弟互动名师点上限（可开关）** - 配置： ```yaml mentor-points: gain: intimacy: per-apprentice-limit: enabled: true points: 100 notify: true ``` - 与每日上限同时生效，取更严格剩余 - 新徒弟独立重新计数 - 出师/解除关系不清空历史累计，防反复拜师刷点 - 消息：`messages.mentor-points-apprentice-limit` ### PlaceholderAPI - `%warzshitu_per_apprentice_limit_enabled%` - `%warzshitu_per_apprentice_limit%` - `%warzshitu_apprentice_intimacy_points_<徒弟名>%` - `%warzshitu_shop_bought_<商品ID>%` - `%warzshitu_shop_limit_<商品ID>%` - `%warzshitu_shop_remaining_<商品ID>%` ### 其他 - `config-version` → `5` - 产物：`WarZShiTu-2.2.0.jar` ### 升级提示（2.1.x → 2.2.0） 1. 替换 jar 并重启服务器（`plugin.yml` 新增权限节点）。 2. 建议合并配置： - `settings.same-ip-restrict` - `mentor-points.gain.intimacy.per-apprentice-limit` - 商店商品 `limit` 段 - 消息键：`same-ip-blocked`、`same-ip-blocked-master`、`mentor-points-apprentice-limit`、`mentor-shop-limit-reached` 3. 未合并时使用代码默认值（同 IP 限制开、每徒弟上限 100、示例商品自带限购）。 --- [/MD]

[MD] ### v2.1.0 - **新增**：师徒互动获取名师点支持**每日上限**，防止挂机/刷怪无限刷名师点。 - 配置项：`mentor-points.gain.intimacy.daily-limit`（默认 `50`，`0` = 不限制）。 - 配置项：`mentor-points.gain.intimacy.notify-daily-limit`（达上限时每天最多提示师傅一次）。 - 消息：`messages.mentor-points-daily-limit`。 - 仅限制「互动」来源；出师、收徒、管理员调整名师点不受影响；亲密度仍正常增加。 - 玩家数据新增字段：`daily-intimacy-mentor-points`、`daily-intimacy-mentor-day`、`daily-intimacy-limit-notify-day`。 - PlaceholderAPI 新增：`%warzshitu_daily_intimacy_points%`、`%warzshitu_daily_intimacy_limit%`、`%warzshitu_daily_intimacy_remaining%`。 - 配置版本号 `config-version` 调整为 `4`（旧服可直接用代码默认值，也可手动合并配置段）。 [/MD]