Server Tutorial Plus - 服务器新手教程插件

ServerTutorialPlus 是一款功能强大的新手引导插件，允许你为服务器创建无限的自定义教程，通过多种互动方式引导新玩家，并提供丰富的自定义选项与奖励系统。

💡版本须知

• 对于 1.20 以下的 Minecraft 版本，请使用此链接下载资源，或访问版本页面。
• 新功能与错误修复将仅适用于 1.20 或更高版本。

🎮核心特性

• 无限教程与引导点：创建不限数量的服务器教程，每个教程可包含无限个引导点。
• 高度可定制：每个引导点都拥有独特的设置。
• 多种触发方式：
• 玩家首次加入服务器时自动开始。
• 右键点击特定方块时开始。
• 右键点击 NPC 时开始。
• 内置游戏编辑器：通过命令即可轻松创建和编辑教程。
• 数据统计：记录每个教程的完成情况。
• 权限控制：可为每个教程设置独立权限。
• 轻量高效：后台无持续运行的任务，节省服务器资源。
• 奖励系统：玩家首次完成教程时可获得奖励（支持 MySQL）。
• 命令限制：可在教程进行中屏蔽玩家的其他命令。
• PlaceholderAPI 支持：完美兼容，提供多种占位符。

引导点支持的操作

每个引导点可以执行以下一项或多项操作

• 发送标题（Title）
• 发送聊天信息
• 发送动作栏信息（Action Bar）
• 播放音效
• 设置玩家飞行模式
• 锁定玩家位置
• 执行控制台命令
• 生成烟花
• 添加药水效果

引导点类型

• 定时点：经过设定的时间间隔后自动进入下一点。
• 检查点：玩家走入特定区域后进入下一点。
• 点击方块点：玩家点击指定方块（如告示牌）后进入下一点。
• 命令点：玩家执行命令 /st next 后进入下一点。适用于需要与其他插件联动的场景。

🔧命令与权限

主要命令

• /st help - 显示你有权使用的所有命令帮助。
• /st create <id> - 创建一个新的服务器教程。
• /st remove <id> - 删除一个服务器教程。
• /st addpoint <id> - 为教程添加一个引导点。
• /st removepoint <id> <point index> - 从教程中移除一个引导点。
• /st info <id> - 显示所有教程列表，或指定教程的详细信息。
• /st player <username> - 在聊天栏显示玩家的教程统计信息。
• /st play <id> (playername) - 开始一个教程。（玩家名可选）
• /st quit - 退出你当前正在进行的教程。
• /st playpoint <id> <point> - 仅播放教程的某一个特定引导点。
• /st setblock <id> - 设置一个点击后可开始教程的交互方块。
• /st reload - 从配置文件重载插件（不会自动保存当前数据！）。
• /st save - 将当前数据保存到配置文件（不会先执行重载！）。
• /st npc <add/remove/bind/text/height> <value> - 管理 NPC 相关设置。
• /st edit <id> <invisible/rewards/permission/blockcommands/commands/chatblock> - 设置教程的整体属性。
• /st editpoint <id> <point> <args> - 编辑指定引导点的参数。

权限列表

命令权限：

• servertutorialplus.command.help
• servertutorialplus.command.create
• servertutorialplus.command.remove
• servertutorialplus.command.addpoint
• servertutorialplus.command.removepoint
• servertutorialplus.command.play
• servertutorialplus.command.player
• servertutorialplus.command.quit
• servertutorialplus.command.playpoint
• servertutorialplus.command.setblock
• servertutorialplus.command.edit
• servertutorialplus.command.npc
• servertutorialplus.command.info
• servertutorialplus.command.reload
• servertutorialplus.command.save

教程权限：

• servertutorialplus.tutorials.<教程ID>
• servertutorial.tutorial.bypass - 允许绕过所有限制（例如被屏蔽的命令）。

操作权限：

• servertutorial.action.removeblock

❓引导点编辑参数

使用 /st editpoint 命令时，可使用以下参数。

通用参数（适用于所有点类型）

• time <seconds> - 设置进入下一点前的等待时间（秒）。
• fly <true/false> - 设置玩家的飞行模式。
• lockplayer <true/false> - 阻止玩家移动。
• lockview <true/false> - 锁定玩家的视角。
• messages <add/remove/list/clear> - 为该点添加、移除、列出或清空聊天信息。
• commands <add/remove/list/clear> - 添加、移除、列出或清空在该点播放时执行的命令。
• 注意：输入命令时不要包含起始的 /。
• actionbar <set/clear> - 设置或清除在该点播放时显示的动作栏信息。
• firework - （手持烟花）在你添加此参数时所站的位置，于该点播放时生成烟花。
• location - 将你当前的位置设置为该点的新位置。
• title <title/subtitle/fadein/fadeout/stay/reset> - 设置在该点播放的标题或副标题。
• sound <set/clear> - 设置或清除在该点播放的音效。
• 设置时参数：<sound> <volume> <pitch>
• 所有音效列表可在此处查找。
• potion <add/remove/list/clear> - 为玩家添加药水效果。
• 如果玩家手持药水，则添加该药水效果。否则参数格式为：<potioneffect> <time (in S)> <level>
• switch <point index> - 将该点与给定索引的点交换位置。
• infront <point index> - 将该点移动到另一个点的前面。

特定点类型参数

检查点：

• distance <value (blocks)> - 玩家与检查点之间的最小触发距离（方块数）。
• repeatActionbar <true/false> - 是否持续显示动作栏提示（适用于提示玩家移动至检查点）。
• colour <red> <green> <blue> - 设置检查点的颜色。
• 提示：使用大于 255 的值将开始随机颜色！

点击方块点：

• colour <red> <green> <blue> - 设置方块高亮的颜色。
• 提示：使用大于 255 的值将开始随机颜色！
• setblock - 允许你设置目标方块。
• repeatActionbar <true/false> - 是否显示粒子效果。
• teleport <true/false> - 是否将玩家传送至该点。

✨开发者 API

ServerTutorialPlus 为开发者提供了实用的 API。

获取 API 实例

ServerTutorialApi stApi = ServerTutorialApi.getApi();
// TODO: 将此实例存储在方便访问的地方。

主要 API 方法

• startTutorial(String id, Player player) - 为指定玩家开始一个教程。成功返回 true。
• isInTutorial(UUID uuid) - 检查玩家是否正在进行教程。
• getCurrentTutorial(UUID uuid) - 获取玩家当前的教程对象，未进行则返回 null。
• getController(UUID uuid) - 获取管理玩家教程的控制器对象，未进行则返回 null。

事件监听

API 提供了以下事件可供监听

• TutorialStartEvent - 教程开始时触发。
• TutorialEndEvent - 教程结束时触发。
• TutorialPlayPointEvent - 播放某个引导点时触发。

Java 文档：

• http://servertutorialplus.martenm.nl/index
• （注：仅包含使用 API 时应使用的对象说明）

PlaceholderAPI 占位符

插件支持以下占位符

• %servertutorialplus_inTutorialBoolean%
• %servertutorialplus_getTutorial%
• %servertutorialplus_getPoint%
• %servertutorialplus_getMaxPoints%

内置占位符（无需 PlaceholderAPI）：

• %username%

⭐视频教程与说明

请注意：以下两个视频使用了正确的命令，请以此为准。

• 教程/展示视频
• Soulstriker 制作的教程
• BrandsPickled 制作的教程

**过时视频（仅命令部分参考）**

• 这些视频中的命令可能已过时，请以本页面说明为准。

**带语音的教程（非作者制作）**

• 英语教程
• 西班牙语教程
• 注意：此展示视频缺少后续添加的新功能。

🔧开发计划与统计

• 已完成：在教程中屏蔽特定命令、多语言文件、更多自定义点类型、命令重做、绑定任意实体（适用于 Citizens 等）、添加 PlaceholderAPI 支持、可右键点击的 NPC。
• 计划中：新的引导点类型。

本插件使用 bstats.org 提供匿名统计，你可以在任何时候选择退出此服务。

---

如果你喜欢这个插件，请考虑留下评论或捐赠以支持开发者。此插件是开发者在业余时间维护的，你的支持将帮助支付开发工具的费用，我们深表感谢。

查看我的另一个插件