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

[原创] WarZShiTu — 高自定义重制版师徒系统 | 全中文GUI | 名师商店 | Folia适配 | 旧数据兼容
插件名称：WarZShiTu
插件版本：2.0.0
适配核心：Bukkit / Spigot / Paper / Folia（全适配）
适配版本：1.7+ 全版本通用
前置依赖：无（PlaceholderAPI 可选）
简介：WarZShiTu 是基于 SFmentorReloaded 核心玩法重构的全新轻量化师徒系统插件，修复旧版各类BUG，新增海量自定义功能。主打全中文可视化配置、GUI可视化操作、音效特效交互、阶梯出师奖励、名师点商店、完整PAPI变量，同时完美兼容旧版数据与权限，支持Folia异步调度，是目前兼容性、自定义程度最高的免费师徒插件之一。

---

插件核心亮点​

• 全中文高度自定义：所有提示文案、GUI界面、商店内容、配色排版均可在 config.yml 一键修改，无需改源码
• 可视化GUI系统：师徒信息、徒弟列表、出师申请、名师商店全部支持GUI点击操作，适配新手玩家
• 完整名师点体系：师徒互动、徒弟出师可获取名师点，支持自定义获取规则、奖励提示，自带名师点商店
• 阶梯出师奖励：支持多档位出师奖励，可选择最高档位/全部档位发放，控制台指令执行，权限无限制
• 全版本完美兼容：向下兼容1.7低版本服务端，原生适配Folia，自动适配新旧版本物品、音效、特效
• 旧数据无缝迁移：自动读取 SFmentorReloaded 旧版玩家数据、师徒关系，无需手动迁移
• 旧权限兼容：可开启旧版权限节点兼容，无需修改原有权限组配置
• 完善PAPI变量：内置数十种师徒状态变量，支持菜单、计分板、公告自定义展示
• 交互音效特效：拜师、出师、解除关系等操作自带特效音效，多候选资源容错不报错

---

安装与升级教程​

基础安装步骤​

1. 下载插件 WarZShiTu-2.0.0.jar（Java8编译，全版本通用）
2. 将Jar文件放入服务器 plugins 文件夹
3. 启动服务器，插件自动生成配置文件夹与 config.yml
4. 修改配置后，执行指令 /shitu reload 热重载生效
5. 若修改指令别名、权限节点，必须重启服务器

旧版数据迁移​

插件启动自动检测旧版 SFmentorReloaded 数据：

• 旧数据读取路径：plugins/SFmentorReloaded/Player
• 新版数据保存路径：plugins/WarZShiTu/playerdata

---

全部指令大全​

玩家通用指令​

[TABLE=ace-table]
[TR]
[th]
指令

[/th]
[th]
功能说明

[/th]
[/TR]
[TR]
[td]/shitu help[/td]
[td]查看师徒系统帮助菜单[/td]
[/TR]
[TR]
[td]/shitu add <玩家>[/td]
[td]向指定玩家发起拜师申请[/td]
[/TR]
[TR]
[td]/shitu accept[/td]
[td]同意当前拜师申请[/td]
[/TR]
[TR]
[td]/shitu deny[/td]
[td]拒绝当前拜师申请[/td]
[/TR]
[TR]
[td]/shitu gui[/td]
[td]打开师徒系统GUI主菜单[/td]
[/TR]
[TR]
[td]/shitu shop[/td]
[td]打开名师点商店[/td]
[/TR]
[TR]
[td]/shitu points[/td]
[td]查看自身名师点余额[/td]
[/TR]
[TR]
[td]/shitu info[/td]
[td]查看个人师徒档案、亲密度、出师条件[/td]
[/TR]
[TR]
[td]/shitu graduate[/td]
[td]满足条件手动出师[/td]
[/TR]
[TR]
[td]/shitu lift[/td]
[td]发起解除师徒关系申请[/td]
[/TR]
[TR]
[td]/shitu liftconfirm[/td]
[td]确认解除师徒关系[/td]
[/TR]
[TR]
[td]/shitu gift <徒弟>[/td]
[td]手持物品赠送给指定徒弟[/td]
[/TR]
[TR]
[td]/shitu tp <徒弟>[/td]
[td]传送到徒弟身边[/td]
[/TR]
[TR]
[td]/shitu version[/td]
[td]查看插件版本与适配信息[/td]
[/TR]
[/TABLE]

管理员指令​

[TABLE=ace-table]
[TR]
[th]
指令

[/th]
[th]
功能说明

[/th]
[/TR]
[TR]
[td]/shitu reload[/td]
[td]热重载全部插件配置[/td]
[/TR]
[TR]
[td]/shitu points <玩家>[/td]
[td]查询指定玩家名师点[/td]
[/TR]
[TR]
[td]/shitu points give/take/set <玩家> <数量>[/td]
[td]增减/重置玩家名师点[/td]
[/TR]
[/TABLE]

通用指令别名​

所有主指令通用别名：/warzshitu、/wzst、/mentor、/sfmentor，完全兼容旧版指令习惯。

---

权限节点​

玩家默认权限（全员开启）​

warzshitu.use、warzshitu.add、warzshitu.accept、warzshitu.deny、warzshitu.gui、warzshitu.shop、warzshitu.points、warzshitu.info、warzshitu.graduate、warzshitu.lift、warzshitu.gift、warzshitu.tp、warzshitu.version

管理员权限（仅OP）​

warzshitu.admin.reload、warzshitu.admin.points、warzshitu.admin、warzshitu.*

旧权限兼容​

开启配置 settings.legacy-permissions: true 即可兼容旧版 SFmentorreloaded.* 权限节点。

---

PlaceholderAPI 变量（可选前置）​

安装 PlaceholderAPI 后自动注册全部变量，可用于计分板、菜单、公告、称号等场景，常用核心变量如下：

• %warzshitu_master%：玩家师傅名称
• %warzshitu_has_master%：是否有师傅（true/false）
• %warzshitu_disciple_count%：徒弟数量
• %warzshitu_intimacy%：当前师徒亲密度
• %warzshitu_mentor_points%：当前名师点余额
• %warzshitu_can_graduate%：是否满足出师条件
• %warzshitu_role%：当前角色（师傅/徒弟/无）

更多全套变量可查阅插件Wiki文档，覆盖全部师徒状态展示需求。

---

核心功能介绍​

1. 亲密度系统​

支持自定义挖矿、钓鱼、击杀怪物等互动行为增加亲密度，可单独开关、设置点数、冷却时间，支持距离限制（师徒需在指定方块内才可触发）。

2. 名师点&商店系统​

默认师徒互动师傅+1名师点、徒弟出师师傅+30名师点，可自定义收徒奖励开关。名师商店完全自定义，支持设置商品图标、价格、执行命令，支持控制台/玩家双模式执行。

3. 阶梯出师奖励​

支持多档位亲密度奖励，两种发放模式：highest（仅最高达标档位）、all（全部达标档位），师徒双向奖励，助力服务器活跃度。

4. 高度自定义GUI​

主菜单支持字符布局自定义，自由调整按钮位置、填充物品、分页按钮，物品支持多版本兼容写法，适配1.7-最新版本所有服务端。

---

配置特色​

• 所有文案、颜色、排版、提示语气可自定义
• 拜师时效、等级上限、收徒等级、出师条件自由配置
• 音效、特效多候选适配，单个资源失效不影响插件运行
• Folia/Bukkit双调度自动适配，高并发不卡顿
• 热重载配置，无需频繁重启服务器

---

常见问题​

Q：没有安装PlaceholderAPI插件会报错吗？ A：不会，PAPI为可选前置，未安装不影响插件所有核心功能，仅变量无法使用。
Q：1.7版本可以正常使用吗？ A：完美兼容，插件未声明高版本API，材质、音效、物品均做低版本适配。
Q：旧版师徒数据可以完全迁移吗？ A：可以，插件启动自动读取旧版数据，师徒关系、亲密度全部保留。
Q：修改配置后不生效？ A：常规配置执行 /shitu reload 即可；修改指令、权限、别名需重启服务器。

---

更新日志 - V2.0.0​

• 全新重构核心代码，修复旧版SFmentorReloaded全部已知BUG
• 新增全中文可视化配置，所有文案可自定义
• 新增完整GUI师徒菜单、名师商店系统
• 新增阶梯式出师奖励、名师点体系
• 新增数十种PAPI变量，适配全场景展示
• 原生支持Folia异步适配，兼容各类服务端
• 新增交互音效特效、多版本资源容错机制
• 支持旧数据、旧权限无缝兼容

---

最后说明：插件完全免费开源，无付费功能、无后门、无广告，适合生存服、RPG服、公益服各类服务器使用，如有功能建议或BUG反馈可随时联系作者。