Chestnut - Discord Webhooks

插件

· 作者 Penicilin

追踪特定方块,并在它们被使用、打开或交互时发送完全可自定义的 Discord Webhook 警报。

0 本站下载 0 关注 更新于 1 年前

最新 0.1.1 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

Chestnut

Chestnut 是一款 Minecraft 插件,它会监控特定方块,并在这些方块发生变动时发送可自定义的 Discord Webhook 消息。 你可以用它来监视邮箱、红石火把等,警报内容可根据你的风格和需求完全定制。

为什么叫 "Chestnut"(栗子)?
嗯,它最初的名字是 “Chest-Nut”——因为你知道,它在盯着箱子(chests)。

Alpha 版本通知: Chestnut 目前处于 Alpha 阶段!——你可能会遇到一些 Bug 或缺失的功能。 欢迎提供反馈!请随时在 GitHub 仓库 提交问题或建议。

功能

  • 通过站在支持的方块旁并运行命令来跟踪它们(储物容器、红石火把、讲台)。
  • 内置触发器,如 storage、redstone_torch 和 lectern。
  • 支持带有 <name>、<world>、<time> 或 <page> 等占位符的自定义消息模板。
  • 可为每个事件设置可选的嵌入颜色(embed color)和缩略图图片。
  • 异步发送 Discord Webhook,具备速率限制和重试机制。

支持的方块类型:

  • 储物容器(例如箱子、 barrels、潜影盒)
  • 红石火把
  • 讲台

未来可能会根据时间推移或用户请求添加更多方块类型。

命令

命令 描述
/settracker <name> <trigger> 开始创建追踪器,为其命名并选择触发器。你将有 15 秒的时间右键点击合适的方块以将其绑定。
/edittracker <name> … 更改消息、颜色、缩略图等。
/trackerlist [page] 显示所有追踪器,并提供交互式菜单以便快速对追踪器进行简单更改(基于 Husk Homes)。
/deltracker <name|all> 删除追踪器。
/chestnut <help|reload|status> 管理操作。

触发器参考

所有触发器都支持基本标签,如 <name>、<trigger>、<event>、<world>、<x>、<y>、<z> 和 <time>。
部分触发器会添加以下列出的额外标签。

注意:<name> 默认使用追踪器给定的标题;否则将使用追踪器的 ID 名称。

触发器 事件 额外标签
storage open, close <user>, <uuid>, <items>
redstone_torch on, off <state> (lit 或 unlit)
lectern insert_book, remove_book, page_change, open, close <user>, <uuid>, <page>, <book_title>, <book_author>, <book_pages>, <has_book>

示例:监视邮箱

假设出生点有一个箱子,玩家会把物品丢进去。每当有人打开这个箱子时,你都希望收到一条 Discord 警报。

  1. 站在箱子旁并输入:

    /settracker mailbox storage  
    
    • mailbox = 你为此追踪器起的名字

    • storage = 要监控的内容。你可以从以下选项中选择:

      • storage – 储物方块,如箱子、木桶、潜影盒
      • redstone_torch – 红石火把的开启/关闭
      • lectern – 讲台的书籍操作和阅读行为

    运行命令后,你将有 15 秒 的时间右键点击该箱子以将其绑定到追踪器。

  2. 自定义通过 Webhook 发送的消息:

    /edittracker mailbox msg open "<user> checked the <name>!"  
    /edittracker mailbox msg close "<user> closed the <name>. Items: <items>"  
    
  3. 添加颜色和图标:

    /edittracker mailbox color open #00FF00  
    /edittracker mailbox color close #FF0000  
    /edittracker mailbox thumbnail open https://example.com/open.png  
    /edittracker mailbox thumbnail close https://example.com/close.png  
    
  4. 通过测试事件来尝试一下:

    /edittracker mailbox test open  
    

现在,每次使用该箱子时,都会向你的 Webhook 发送一个嵌入消息,其中包含配置好的标题、描述、颜色和缩略图。

示例:微调事件消息

假设你为图书馆里的一个讲台设置了追踪器,但只关心书籍插入或移除的情况,而不需要关注每一次翻页。以下是简化方法:

  1. 照常创建追踪器(如果尚未创建):

    /settracker library_lectern lectern  
    
  • library_lectern = 你为这个追踪器起的名称
    • lectern = 要追踪的方块类型
  1. 禁用你不想要的事件:

    /edittracker library_lectern msg --disable page_change  
    /edittracker library_lectern msg --disable open  
    /edittracker library_lectern msg --disable close  
    

    这告诉 Chestnut 完全忽略这些事件。

  2. 将自定义消息恢复为默认值:

    也许你对 insert_book 尝试了自定义消息,但后来发现还是更喜欢默认的消息:

    /edittracker library_lectern msg --clear insert_book  
    
  3. 稍后重新启用某个事件:

    如果你改变主意,希望再次接收 page_change 事件:

    /edittracker library_lectern msg --enable page_change  
    
  4. 检查你的设置:

    /edittracker library_lectern view  
    

    这将显示哪些事件已启用/禁用,以及它们会发送什么消息。

提示:想一键清空所有设置?
使用 --clear all 可立即将该追踪器的所有事件重置为默认消息。

结果: 你的讲台追踪器现在仅在插入书籍或翻页时发送警报,在保持 Discord 频道整洁的同时,依然跟踪重要的操作。

权限

  • chestnut.use – 允许玩家创建和管理追踪器。
  • chestnut.admin – 授予访问管理命令(如重载)的权限。

配置

config.yml 包含全局设置,例如默认嵌入颜色、Webhook URL 和速率限制。

常见问题

Q:我可以在已经拥有 Discord 机器人的服务器上使用该插件吗?
当然可以。Chestnut 独立运行,它直接向 Discord 发送 Webhook 消息。它不需要连接或控制现有的机器人,因此不会干扰你的机器人正在执行的任何操作。

Q:Chestnut 是否仅支持 Discord?
是的。目前,Chestnut 以专为 Discord 设计的格式发送 Webhook 消息。未来可能会扩展以支持其他服务。

Q:如果我追踪大量方块,它会拖慢服务器性能吗?
有可能。我尚未对极限情况进行压力测试,但像大多数插件一样,追踪极大量的方块可能会影响性能。建议从少量开始,并在监控服务器 TPS 的同时逐步增加。不过,你可能会先遇到 Discord 的速率限制,而不是出现性能问题。

Q:我可以将 Webhook 发送到多个频道吗?
目前不支持。Chestnut 每个服务器配置仅支持单个 Webhook URL。我希望未来能添加对多频道的支持。

Q:为什么我的警报看起来与示例截图不一样?
开箱即用,Chestnut 使用简单的默认消息,没有自定义颜色或缩略图。示例截图中展示的是通过 /edittracker 命令配置的自定义设置效果。

Q:如果我追踪的方块被破坏或移动了会发生什么?
Chestnut 通过方块的精确位置进行追踪,而不是根据该位置上是什么类型的方块。因此,如果你破坏了一个被追踪的箱子,并在同一位置替换成木桶(或其他任何东西),追踪器仍将处于活动状态,并可能对新的方块做出响应。如果方块被移动或完全移除,追踪器将继续在该位置监听,直到你删除或重新分配它。

Q:为什么 Chestnut 允许我选择非支持的方块(如草或梯子)作为目标?
因为 Chestnut 仅绑定到你右键点击的方块的精确 XYZ 坐标,它并不关心具体是什么方块。这意味着你可以使用任何方块,即使那些实际上不会触发事件的方块,作为占位符。例如,你可以在临时方块上设置追踪器,之后将其移除,再在那里放置其他方块用于追踪,而无需重新运行命令。

Q:我发现了一堆 Bug!?
哈哈,确实……这是我第一次正式尝试制作插件,也是第一次认真写 Java/Kotlin 代码。我自己更偏向于 Python。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源