DiSky

插件

· 作者 Sky

最佳的 Skript 插件,用于 Discord 管理!支持斜杠命令、交互、组件、模态框等更多功能!

0 本站下载 0 关注 更新于 3 周前

需要前置:Skript

最新 5.0.0-b1 · 26.3 · Paper / Purpur

一键开服(送7天)

DiSky

DiSky 是一个 Skript 插件,允许你在 Minecraft 服务器中使用 Skript 编写 Discord 机器人。它基于 JDA 构建:任何 JDA 机器人能做的事,DiSky 都力求通过 Skript 语法暴露出来。

此分支是 DiSky 5,是对 DiSky 4 的重写。目前处于公开测试阶段:DiSky 4 的大部分内容已涵盖,语法相近但并非完全相同,且 V4 脚本需要进行少量更改(请参阅迁移指南)。

要求

  • Paper 服务器,1.21.5 或更高版本(或 Purpur 等 Paper 分支)
  • Java 21 或更高版本
  • Skript 2.16.1 或更高版本,且其 config.sk 中开启了 use type properties: true(默认设置)
  • 来自 Discord Developer Portal 的机器人令牌(token)

安装

  1. 将 DiSky-<version>.jar 放入服务器的 plugins/ 文件夹中,与 Skript 放在一起。
  2. 重启服务器。

DiSky 没有配置文件。每次启动时,它会写入 plugins/DiSky/disky-syntax.json,列出它注册的所有语法;你无需触碰该文件。

匿名统计信息 (FastStats)

DiSky 会向 FastStats 报告匿名使用统计信息和错误。首次启动期间不会发送任何数据:提交操作在下次重启后开始,因此你可以在之前选择退出。

发送的内容包括:

  • 使用情况:一个随机生成的服务器 ID(如果删除则会重新生成)、DiSky 版本、Minecraft 版本、服务器软件及其版本、在线模式、玩家数量、Java 供应商及版本、操作系统名称、版本和架构,以及 CPU 核心数。
  • 错误:运行时由 DiSky 语法引发的错误(异常类型、截断至 500 字符的消息以及缩短后的堆栈跟踪)。

不会收集任何 IP 地址、玩家数据、机器人令牌、Discord 内容或脚本源代码。

若要选择退出,请编辑 plugins/faststats/config.properties(所有使用 FastStats 的插件共享此文件)并重启:

  • enabled=false 将完全关闭 FastStats;
  • submitMetrics=false 仅停止使用统计信息的提交;
  • submitErrors=false 仅停止错误报告的提交。

JVM 参数 -Dfaststats.enabled=false 也能将其关闭。

第一个机器人

将此代码保存为 plugins/Skript/scripts/bot.sk,在其中填入你的令牌,然后运行 /sk reload bot:

options:
    token: "YOUR-BOT-TOKEN"

on load:
    set {_bot} to a new discord bot
    set token of {_bot} to {@token}
    login {_bot} as "my-bot"

on unload:
    shutdown the bot named "my-bot"

# Slash commands are declared in the script, then sent to Discord explicitly.
on guild ready:
    update the discord commands (all structured application commands) in event-guild

slash command ping:
    description: Check that the bot is alive
    trigger:
        reply with hidden "Pong!"

slash command ban <target: member> [<reason: string>]:
    description: Ban a member
    enabled for: ban members
    trigger:
        try:
            ban {_target} because of {_reason}
        catch {_errors::*} and stop:
            reply with hidden "Could not ban %{_target}%: %error meaning of {_errors::1}%"
        reply with hidden "%{_target}% was banned."

on message received seen by "my-bot":
    discord content of event-message is "!about"
    set {_e} to a new discord embed
    set title of {_e} to name of event-guild
    set description of {_e} to "%member count of event-guild% members"
    set color of {_e} to orange
    reply with {_e}

hidden 使回复仅对运行命令的用户可见。如果封禁失败(缺少权限、成员等级高于机器人),catch 块会获取可读的错误信息,而不是控制台中的堆栈跟踪。

你能做什么

  • 机器人:同时运行多个机器人、意图(intents)、缓存设置、分片(sharding)、状态显示(presence)。
  • 消息:发送、回复、编辑、删除、置顶、反应、读取历史记录;嵌入(embeds)、文件上传和下载、投票。
  • 命令:带有类型化选项、自动补全、子命令、冷却时间和翻译的斜杠命令;用户和消息(右键单击)命令;带有前缀的经典文本命令。
  • 组件:按钮、选择菜单、模态框(modals),以及较新的布局组件(容器、部分、画廊)。
  • 服务器管理:成员、角色及其排序、频道和线程、权限和频道覆盖、表情符号和贴纸、邀请链接、预定事件、欢迎界面、AutoMod 规则、Webhook。
  • Moderation:封禁、踢出、超时、清理、审计日志原因。
  • 事件:约 130 个 Discord 事件,从消息和反应到语音、角色和 AutoMod。

Atlas 列出了每种语法的模式及示例。

与纯 Skript 不同的三件事

与 Discord 通信需要时间。 任何向 Discord 发送内容的操作(发布消息、封禁成员)都在服务器线程之外运行,因此你的服务器永远不会因为等待 Discord 而卡顿。DiSky 内存中已有的值会直接读取;需要向 Discord 查询的值则需使用 await 读取,这会等待响应:

await set {_bans::*} to bans of event-guild

在不使用 await 的情况下读取此类值会在脚本加载时报错,而不是静默返回 <none>。

构建器(Builders)。 要在 Discord 上创建某物(如角色、频道或多部分消息),你先填充一个构建器,然后再发送:

set {_b} to a new role builder named "Helpers" in event-guild
set color of {_b} to light blue
await set {_role} to the build result of {_b}

错误处理。 失败的 Discord 操作会将可读的消息打印到控制台中。你可以将其放在 try 块中以自行处理,如上文的 ban 命令所示,或者监听 on discord error 来捕获未被任何 try 处理的错误。

来自 DiSky 4

DiSky 5 取代 DiSky 4:插件名称相同,Modrinth 页面不变,依赖 DiSky 的附加组件仍可正常使用其名称。V4 脚本无法直接运行。

在切换机器人之前,请先阅读 Atlas 上的 迁移指南。 该指南提供了脚本移植的步骤顺序、每项变更的前后对比示例(如 retrieve 变为 await、构建器、discord 前缀、命令、组件、事件等),以及 DiSky 5 尚未包含的功能列表。

从源代码构建

./gradlew build

需要 JDK 21。生成的插件文件为 build/libs/DiSky-<version>.jar(旁边的 -thin jar 不包含 JDA,因此无法加载)。

许可证

Apache License 2.0

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源