DuckySkript

插件

· 作者 DuckDev120

DuckySkript 是一款功能强大且轻量级的 Spigot/Paper Minecraft 插件,允许管理员创建基于 YAML 的自定义脚本,并通过 Citizens NPC 交互或手动触发来执行动态的条件命令。

0 本站下载 0 关注 更新于 4 个月前

最新 2.1 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? DuckySkript

DuckySkript 是一款功能强大且轻量级的 Spigot/Paper Minecraft 插件,允许管理员通过简单的 YAML 文件创建自定义脚本,并在玩家与 Citizens NPC 互动或手动执行时运行动态命令。

使用 DuckySkript,您可以根据玩家权限配置条件命令执行,以控制台、玩家或临时 OP(管理员)身份执行命令,并轻松个性化玩家交互体验。


重要提示:需要安装 Citizens 插件!


✨ 特性

  • Citizens 集成: 当玩家右键点击 Citizens NPC 时执行脚本序列。
  • YAML 脚本编写: 使用标准 YAML 格式进行简单、可读性强且高度可定制的脚本创建。
  • 条件执行: 根据权限节点从上到下评估脚本步骤。支持默认回退块(fallback block)。
  • 灵活的执行上下文:
    • 以控制台发送者身份运行命令。
    • 以玩家身份运行命令。
    • 以操作员(OP)身份临时运行命令,安全地绕过权限限制。
  • 占位符支持: 使用 %player% 动态注入正在互动的玩家名称。
  • 命令回退与别名: 完全向后兼容现有设置(支持 /duckyskript、/ds、/ducky 和 /pn)。
  • 权限回退: 无缝支持旧版 parlanpccmd.xxx 和新版 duckyskript.xxx 权限结构。
  • 多语言支持: 开箱即用,提供英语和希伯来语本地化文件。

? 安装与设置

  1. 确保您的服务器上已安装 Citizens(可选,但强烈建议用于 NPC 功能)。
  2. 下载 DuckySkript.jar 并将其放入服务器的 plugins 文件夹中。
  3. 重启或重载服务器以生成配置文件。
  4. 在 plugins/DuckySkript/config.yml 中自定义设置,并在 plugins/DuckySkript/scripts/ 目录中添加脚本。

⚙️ 命令与权限

命令

  • /duckyskript help - 显示帮助菜单。
  • /duckyskript reload - 重新加载所有配置文件和脚本。
  • /duckyskript run <script> [player] - 为玩家手动触发脚本序列。

注意:您可以使用 /ds、/ducky 或 /pn 别名来代替 /duckyskript。

权限

  • duckyskript.use - 使用帮助命令所需。(默认:true)
  • duckyskript.admin - 重载插件所需。(默认:op)
  • duckyskript.run - 手动运行脚本所需。(默认:op)

注意:以 parlanpccmd. 开头的旧版权限会自动识别为回退权限。


? 脚本编写指南

所有脚本均位于 plugins/DuckySkript/scripts/ 中。每个 YAML 脚本文件可以包含不同的命令序列,这些序列将根据玩家权限进行匹配。插件会从上到下解析这些权限,并执行第一个匹配的块。

执行上下文

  • 控制台命令(默认): 从控制台运行命令。
    - "give %player% diamond 5"
    
  • 玩家命令: 以互动的玩家身份运行命令。
    - "say Hello!":
        config:
          asPlayer: true
    
  • OP 命令: 以玩家身份运行命令,临时授予其 OP 状态以执行该命令(适用于需要管理员权限的命令)。
    - "gamemode creative":
        config:
          asPlayer: true
          asOP: true
    

示例脚本 (scripts/example.yml)

# DuckySkript 示例脚本
scripts:
  # 检查玩家是否具有 VIP 权限
  duckyskript.vip:
    - "say I am a VIP!":
        config:
           asPlayer: true
           asOP: false
    - "give %player% diamond 5"
    - "broadcast %player% just talked to the VIP NPC!"
    
  # 检查玩家是否具有成员权限
  duckyskript.member:
    - "say Hello, I am a member!":
        config:
           asPlayer: true
    - "give %player% iron_ingot 10"
    
  # 如果没有权限节点匹配,则使用默认回退
  default:
    - "say I don't have any special permissions yet.":
        config:
           asPlayer: true

? 将脚本分配给 NPC

要将脚本绑定到 Citizens NPC,请选择该 NPC 并使用 Citizens 命令应用元数据:

/npc select
/npc metadata --set duckyskript-script <script_name>

(将 <script_name> 替换为您的脚本文件名,不包括 .yml 扩展名)

为了向后兼容,插件还会检查 parlanpc-script 元数据键。


? 本地化

DuckySkript 开箱即用支持希伯来语和英语。您可以在 config.yml 中配置您的语言:

# 用于消息的语言
# 支持:en, he
language: en

在 messages_en.yml 或 messages_he.yml 中自定义所有消息。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源