Spyglass

插件

· 作者 CapyBara_Man69

为您的服务器提供自定义 Discord 斜杠命令,以及游戏中所有执行命令的实时动态。

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

最新 1.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

Spyglass

通过 Discord 管理你的服务器,并实时查看每一条输入的命令。 在单个配置块中定义你自己的斜杠命令。无需编写代码,不向外部回传数据。

功能特性

  • 自定义斜杠命令:配置键即命令名,因此 /ban 仅需三行配置
  • 实时命令流:游戏中执行的每条命令都会镜像到你指定的 Discord 频道
  • 约 85 个占位符:支持玩家、位置、世界、生命值、延迟、命令、Discord 用户、服务器统计等
  • 智能过滤器:支持带通配符的忽略列表、仅包含白名单、忽略特定玩家、权限绕过
  • 密码安全:默认忽略 login、register 和私聊命令
  • 防速率限制:消息会被分批合并为一条发送(每隔几秒),避免刷屏 Discord
  • 自解释的配置错误:文件损坏时会提示具体的行号、列号和修复方法,且不会应用任何更改
  • MiniMessage 格式支持:渐变、悬停文本和可点击命令均可在 messages.yml 中实现
  • 注入防护:名为 <red> 的玩家无法给管理员频道上色或植入可点击命令
  • 一键命令设置检查:运行 /spyglass test 即可一次性验证令牌、频道 ID 和机器人权限
  • 零遥测数据:无更新检查器,无分析工具,唯一的外部连接是 Discord

你的命令,你的配置

配置键同时充当命令名称及其签名。以下是一个能正常工作的 /ban 命令的全部配置:

commands:
  "ban {username}":
    discord-command-description: "用于封禁成员"
    minecraft-command: "/ban {username}"

当某个选项需要接收整句话时,请在最后一个参数后添加三个点,并利用 Discord 自动补全功能从实时在线玩家列表中选择:

  "kick {username} {reason...}":
    discord-command-description: "将玩家踢出服务器"
    minecraft-command: "/kick {username} {reason}"
    arguments:
      username:
        suggest-online-players: true
      reason:
        required: false

一个斜杠命令可以按顺序执行多个 Minecraft 命令,锁定特定角色、用户或频道,设置冷却时间,以控制台身份或玩家身份运行,并回复私信。

参数类型包括:string(字符串)、integer(整数)、number(数字)、boolean(布尔值)、user(用户)、channel(频道)、role(角色),并支持可选的固定选项。

监视每条命令

command-monitor:
  enabled: true
  channel-id: "1234567890123456789"
  format: "{username}: {command}"

所有占位符均适用于该格式,你可以选择在 Discord 中显示多少详细信息:

  format: "`{time}` **{username}** ran `{command}`"
  format: "[{world}] {username} ({x}, {y}, {z}) ran {command}"

玩家、控制台、RCON 以及来自 Discord 的命令均被涵盖。来自 Discord 的命令会归因于对应的 Discord 用户,而非控制台。

配置出错时告诉你如何修复

两个文件在应用任何更改之前都会被解析。语法错误不会改变当前状态,正在运行的设置保持生效,你会看到如下信息而不是堆栈跟踪:

[Spyglass] config.yml could not be loaded - it has a YAML syntax error.
[Spyglass]   Line 83, column 22: mapping values are not allowed here
[Spyglass]   83 |     text: Now playing: survival mode
[Spyglass]      |                      ^
[Spyglass]   Fix: this value contains a colon. Wrap the whole value in "double quotes"

它能识别未加引号的冒号、Tab 缩进、缩进不对齐、未闭合的引号、重复的键以及以花括号开头的键。

命令

命令 描述
/spyglass reload 重载 config.yml 和 messages.yml
/spyglass status 查看 Discord 连接状态、监控统计、配置警告
/spyglass commands 列出所有已配置的 Discord 命令
/spyglass test 向监控频道发送一行测试消息
/spyglass help 在游戏中显示命令列表
/sg /spyglass 的别名
/glass /spyglass 的别名

权限

权限节点 默认值 描述
spyglass.admin op 完全访问所有子命令
spyglass.reload op 使用 /spyglass reload
spyglass.status op 使用 /spyglass status
spyglass.commands op 使用 /spyglass commands
spyglass.test op 使用 /spyglass test
spyglass.monitor.bypass false 该玩家的命令永远不会被转发

谁可以使用斜杠命令是在 config.yml 中通过 Discord 角色、用户或频道设置的,而不是通过 Minecraft 权限。

安装步骤

  1. 将 jar 包放入 plugins/ 目录并启动服务器一次
  2. 在 Discord 开发者门户创建机器人,打开 Bot 选项卡,点击 Reset Token
  3. 通过 OAuth2 > URL Generator 邀请它,勾选 bot 和 applications.commands
  4. 在 Discord 中开启 Developer Mode(开发者模式),然后右键点击以 Copy ID(复制 ID)
  5. 将你的令牌和服务器 ID 填入 config.yml
  6. 运行 /spyglass reload,然后运行 /spyglass test

无需启用特权意图。

要求

  • Bukkit / Spigot / Paper / Purpur 1.21 至 26.2
  • Java 21+
  • 一个 Discord 机器人令牌

Spyglass 仅使用标准的 Bukkit API,因此同一个 jar 包可以在上述四种服务端软件上无需修改地运行。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源