[Skript-Addon] SkEtcR - SkEtcR 多功能扩展

💡关于 SkEtcR

SkEtcR 是一个功能丰富的 Minecraft 插件，旨在为服务器提供一系列实用工具和增强功能。如需获取完整文档、最新更新或寻求帮助，请访问其官方文档网站或联系开发者。

🎮重要链接

• 官方文档: https://mu-developers.github.io/SkEtcR-Docs/
• 开发者 Discord: _R#8668

SkEtcR 插件文档

SkEtcR 是一个功能强大的 Minecraft 插件，它允许你通过简单的脚本（.sk 文件）来创建复杂的游戏机制、自定义物品、NPC 对话、任务系统等。它基于 Skript 语法，但提供了更丰富的扩展功能和更便捷的集成方式，是服务器自定义玩法的理想工具。

💡快速开始

前置要求

在安装 SkEtcR 之前，请确保你的服务器满足以下条件：

• 服务器核心为 Paper、Spigot 或 Bukkit（推荐使用 Paper 以获得最佳性能）。
• 已安装 Skript（版本 2.6+ 或 2.7+）。
• 已安装 PlaceholderAPI（PAPI）（可选，但推荐用于变量扩展）。

安装步骤

• 将下载的 SkEtcR.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件会自动生成配置文件和脚本文件夹 (plugins/SkEtcR/scripts)。
• 将你的 .sk 脚本文件放入 plugins/SkEtcR/scripts 文件夹中。
• 使用命令 /sketcr reload 重载脚本，或重启服务器使脚本生效。

🎮主要功能

SkEtcR 扩展了 Skript 的功能，提供了大量新的效果、条件和表达式。

自定义物品与 GUI

• 轻松创建具有自定义名称、描述、附魔、NBT 数据的物品。
• 创建功能丰富的图形用户界面（GUI），用于商店、菜单、背包等。
• 支持在 GUI 中处理点击事件、拖拽事件和物品更新。

NPC 与对话系统

• 创建可交互的 NPC，支持右键点击触发对话或事件。
• 构建分支对话树，玩家的选择可以影响后续剧情和奖励。
• 为 NPC 添加自定义外观、名称和交互范围。

任务与进度系统

• 设计多阶段的任务链，包含目标、奖励和完成条件。
• 跟踪玩家的任务进度并在侧边栏或 ActionBar 中显示。
• 设置任务依赖，确保玩家按顺序完成挑战。

区域与世界管理

• 定义自定义区域（Region），并在玩家进入、离开或在区域内时触发事件。
• 创建保护区域，防止破坏、建造或 PVP。
• 管理世界属性，如时间、天气、游戏规则。

高级变量与数据存储

• 使用强大的变量系统存储玩家、服务器甚至全局数据。
• 支持将数据持久化保存到 YAML 或 SQL 数据库，重启服务器不丢失。
• 与 PlaceholderAPI 深度集成，可在其他插件中使用 SkEtcR 的变量。

🔧命令与权限

命令列表

• /sketcr - 显示插件帮助信息。
• /sketcr reload - 重载所有脚本和配置文件（需要权限）。
• /sketcr scripts - 列出所有已加载的脚本。
• /sketcr script <脚本名> - 查看特定脚本的信息或执行相关操作（如禁用/启用）。
• /sketcr version - 检查插件版本。

权限节点

• sketcr.admin - 允许使用所有 SkEtcR 管理命令（如重载）。
• sketcr.command.<命令名> - 允许使用特定命令（例如 sketcr.command.reload）。

❓脚本编写基础

脚本结构

一个典型的 SkEtcR 脚本以事件监听开始，包含条件和效果。

on right click on a villager:
    if name of clicked entity is "&a任务管理员":
        open chest inventory with 3 rows named "&6任务大厅" to player
        wait 1 tick
        set slot 10 of player's current inventory to emerald named "&a新手任务"

• 事件：如 on right click， on join。
• 条件：如 if name of clicked entity is ...。
• 效果：如 open chest inventory ...， send message。

常用事件

• on join / on quit：玩家加入/退出服务器。
• on break / on place：破坏/放置方块。
• on inventory click：点击库存（包括 GUI）。
• on command：监听玩家命令。
• on chat：玩家发送聊天消息。
• on damage / on death：实体受到伤害/死亡。

变量使用

• 局部变量：{_temp}，仅在当前触发器内有效。
• 玩家变量：{%player%.money}，与特定玩家绑定。
• 全局变量：{@server_motd}，所有玩家共享。
• 持久化变量：使用 yaml 或 mysql 效果存储，例如 set yaml value "players.%player%.level" to 10。

✨进阶与集成

与 PlaceholderAPI 集成

安装 PAPI 和 SkEtcR 的扩展后，你可以在其他支持 PAPI 的插件中使用 SkEtcR 的变量。

• 格式：%sketcr_<变量名>%
• 示例：在计分板中显示玩家的金币：%sketcr_money%

创建自定义函数

你可以封装常用的逻辑为函数，方便重复调用。

function giveStartKit(p: player):
    give diamond sword named "&b新手剑" to {_p}
    give 16 cooked beef to {_p}
    send "&a你获得了新手礼包！" to {_p}

command /kit:
    trigger:
        execute function giveStartKit(player)

错误排查

• 使用 /sketcr scripts 检查脚本是否成功加载。
• 查看服务器控制台 (logs/latest.log) 或 plugins/SkEtcR/debug.log 获取详细的错误信息。
• 确保 Skript 的语法正确，特别是缩进和冒号。
• 检查所有依赖插件（如 WorldGuard, Vault）是否已正确安装并运行。

⭐资源与支持

• 官方文档：本页面即为主要文档来源。
• GitHub 仓库：获取源代码、提交问题或贡献代码：https://github.com/mu-developers/SkEtcR
• Discord 社区：加入开发者社区获取实时帮助和讨论（如果提供）。
• 示例脚本：查看 plugins/SkEtcR/examples 文件夹（如果存在）或官方 Wiki 获取学习脚本。

---

提示：SkEtcR 的功能非常庞大，最佳学习方式是结合文档、示例脚本和社区实践。从修改一个小脚本开始，逐步构建你的自定义游戏内容。