MessageFilter

插件

· 作者 fromgate

消息过滤器

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

最新 MessageFilter v0.3.3 · 1.12

一键开服(送7天)

MessageFilter

该插件为您提供控制来自任何来源的聊天消息的能力。您可以隐藏令人烦恼的插件消息(永久隐藏或使用冷却时间显示),或将任意消息替换为其他内容。您甚至可以将 MessageFilter 用作翻译工具,用于那些自身不提供翻译机制的插件。

为什么我需要这个插件?

  • 您希望隐藏服务器上使用的某些插件产生的垃圾信息;
  • 您希望将一条消息替换为另一条消息;
  • 您打算翻译某插件的消息,但该插件未提供可编辑的语言文件;

功能特性

  • 隐藏消息
  • 替换消息
  • 消息冷却(例如,您不喜欢看到大量相同的信息,并希望在一定时间内只查看其中一条)
  • 支持正则表达式(及其他类型的字符串匹配方式)

工作原理

所有添加到 MessageFilter 的规则都存储在 "MessageFilter/rules" 文件夹中的文件里。您可以通过命令或编辑规则文件来添加、修改或删除规则。

每条规则基于以下参数:

  • Type(类型) — 定义用于确定消息文本的方法(在屏幕上显示之前)。共有五种类型:
    • EQUAL — 不区分大小写的比较(示例:"Aaaa Bbbb" 等同于 "aaaa bbbb")
    • CONTAINS — 在输入消息中查找子串
    • START — 检查消息是否以提供的文本开头
    • END — 检查消息是否以提供的文本结尾
    • REGEX — 使用正则表达式进行匹配查找
  • message-mask(消息掩码) — 定义输入掩码,用于在原消息中查找匹配项
  • replace-to(替换为目标) — 定义替换内容。替换支持占位符 %word1% ... %wordN%,它们将被原消息中对应的词替换
  • cooldown-time(冷却时间) — 时间格式类似于 ReActions 插件中使用的时间格式。冷却时间用于设置显示烦人消息的时间限制。例如,如果冷却时间设置为 5 秒,且 "replace-to" 掩码为空,则该烦人消息每五秒仅显示一次。

当插件(或其他来源)发送消息时,此消息会由 MessageFilter 进行管控,并根据已定义的规则进行修改。玩家看到的将是替换后的消息而非原始消息。这种方法甚至允许翻译那些未内置您所需语言翻译功能的插件。您只需找到相关消息并创建规则将其替换即可。 以下是规则文件示例:

命令

插件的主命令是 msgfilter(别名:mfilter, filter)。

  • /msgfilter help — 帮助... h
  • /msgfilter add <RuleId> [GroupId] — 创建新规则
  • /msgfilter set <RuleId> type|input|output|cooldown|group <Value> — 将参数(类型、输入掩码、输出掩码、冷却时间或组)设置为 <Value>
  • /msgfilter remove <RuleId> — 删除规则
  • /msgfilter list [Mask] [PageNumber] — 显示规则列表
  • /msgfilter info <RuleId> — 显示规则参数
  • /msgfilter save <GroupId> [<Number>|<Time>] — 将消息保存到文件 <GroupId>.yml 中。
  • /msgfilter reload — 重新加载规则
  • /msgfilter test — 测试 MessageFilter。

创建规则

您可以通过以下方式创建新规则:命令行、接收到的聊天消息以及手动编辑文件。

示例:

使用命令

  1. /msgfilter add newrule
  2. /msgfilter set newrule type EQUAL
  3. /msgfilter set newrule input this is the input message
  4. /msgfilter set newrule output &6this is the output message

保存接收到的聊天消息

  • /msgfilter save test1 — 将下一条(仅一条)接收到的消息保存到文件 test1.yml
  • /msgfilter save test2 15 — 将接下来 15 条接收到的消息保存到文件 test1.yml
  • /msgfilter save test2 10m — 在 10 分钟内将所有接收到的消息保存到文件 test1.yml

手动配置

MessageFilter 支持多个规则定义文件。它们是位于 "rules" 文件夹中的 "YAML" 文件 (*.yml)。您可以手动编辑(或创建)这些文件。 示例如下:

roadprotector: # rule Id
  type: EQUAL  # rule type
  message-mask: '&3[RP]&cThisplaceisprotected!' # incoming message (with color code)
  replace-to: '&6Здесьнельзяломатьистроить!'  #outgoing (translated) message
  cooldown-time: '' # cooldown time
  use-formating: true # use formatting (colors)
removejoing: # rule Id
  type: REGEX #rule type
  message-mask: '\w+joinedtheserver\.'   # incoming message, I'm going to hide it
  replace-to: '' # Empty line
  cooldown-time: ''

use-formating: false # 忽略格式化 annoying: type: EQUAL
message-mask: 'Youcan't build here!' replace-to: '' # 空行 cooldown-time: '5s' # 在五秒内你只会看到这条消息一次 use-formating: false # 忽略格式化

MessageFilter 自测

你可以使用命令 /msgfilter test 来确认 MessageFilter 是否正常工作。只需在聊天栏输入此命令即可。如果收到消息“MessageFilter test failed!”,通常你需要安装或更新 ProtocolLib。

权限

  • messagefilter.config — 仅一个用于访问命令的权限。
  • messagefilter.test — 当玩家加入服务器时执行 MessageFilter 测试。

依赖项

本插件需要你的服务器上已安装 ProtocolLib。

更新检查器

MessageFilter 包含一个更新检测器,它会使用您服务器的互联网连接。更新检测器每小时会检查 dev.bukkit.org,以查找插件的新发布版本。您可以轻松禁用它:只需在 config.yml 中将参数 "version-check" 设置为 "false" 即可。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源