AntiSpam with web panel - AntiSpam - 聊天防刷屏插件

AntiSpam 是一款功能全面、高度可配置的 Minecraft 插件，它能有效监控聊天，防止刷屏、重复消息、使用违禁词以及其他不受欢迎的玩家行为。该插件设计注重性能、清晰度和灵活性，适用于小型服务器和大型网络。

💡核心功能

• 重复消息防护：检测玩家是否重复发送相同或高度相似的消息，违规消息将被阻止。
• 违禁词过滤：可在配置文件中定义违禁词或短语列表，玩家使用违禁词时消息将无法发送。
• 重复字符检测：阻止包含过多连续相同字符的消息（例如“!!!!”或“aaaaaa”），最大重复字符数可配置。
• 聊天冷却（消息延迟）：设定玩家发送消息之间的最短等待时间，有效防止快速刷屏。
• 模块化系统：每个功能都可在 config.yml 中独立启用或禁用，轻松适应不同服务器的需求。

✨自动惩罚系统

AntiSpam 包含一套先进的自动惩罚系统，用于处理屡次违反聊天规则的玩家。

• 可开关的自动惩罚：可选择是否启用自动惩罚。
• 可配置的违规阈值：可设定触发惩罚所需的违规次数。
• 完全可配置的惩罚指令：可执行任何指令（如 mute、warn、tempmute、ban 等）。
• 可设定的惩罚执行者名称：例如可显示为“AntiSpam”而非“Console”。
• 完整的惩罚记录：插件发出的所有惩罚都会被自动记录。

独特的惩罚 ID

• 每条惩罚都会被分配一个唯一的 ID，用于清晰标识聊天违规行为。
• 惩罚执行时会显示此 ID。
• 管理员可使用此 ID 在日后查询惩罚记录。
• 该 ID 也用于网页界面中，为管理员提供完整的控制权和清晰的惩罚历史概览。

🔧网页界面

插件内置一个网页界面，允许管理员通过惩罚 ID 进行搜索，并查看聊天违规的详细信息。

• 安全的登录系统：确保界面访问安全。
• 主管理员权限：第一个访问网站的人将被设为主管理员，拥有添加、编辑和删除用户的完整权限，从而完全控制系统的访问者。
• 数据库要求：使用网页界面需要 MySQL 数据库支持。

🎮数据库支持

AntiSpam 支持多种数据存储方式

• SQLite 数据库 (data.db)：适用于小型服务器。
• MySQL 数据库：推荐大型服务器使用，且为网页界面所必需。

所有数据库设置均可在配置文件中完全配置。

⭐命令与权限

命令

• /antispam reload

重新加载插件配置和语言文件，无需重启服务器。

所需权限： antispam.reload

• /antispam check <ID>

使用唯一的惩罚 ID 搜索特定的惩罚记录。

所需权限： antispam.check

权限

• antispam.reload – 允许使用 /antispam reload 命令。
• antispam.check – 允许使用 /antispam check <ID> 命令。
• antispam.bypass – 拥有此权限的玩家将被 AntiSpam 完全忽略，不受任何聊天检查的影响。
• antispam.notify – 允许在插件新版本发布时接收更新通知。

❓多语言支持

插件包含三种默认语言文件

• 英语 (EN)
• 捷克语 (CZ)
• 德语 (DE)

您可以根据服务器需求，自由编辑或翻译成自定义语言。

✨配置说明

配置文件 config.yml 清晰且易于编辑，无需修改源代码即可实现以下配置：

• 启用或禁用各项独立功能。
• 配置限制、延迟和惩罚规则。

config.yml 示例摘要

# 选择插件语言。可用选项：EN, CZ, DE。您可以在 /languages/ 文件夹中编辑这些文件。
language: EN

# 数据库配置。类型可选 "SQLITE"（本地文件）或 "MYSQL"（外部数据库）。
database:
  type: "SQLITE"
  host: "localhost"
  port: 3306
  database: "minecraft_db"
  username: "root"
  password: "password"
  useSSL: false

# 聊天限制
block-repeated-messages: true  # 是否阻止重复消息
repeat-message-delay: 60       # 允许再次发送相同消息前的等待秒数
delay: 3                       # 任意聊天消息之间的全局冷却秒数
block-repeated-characters: true # 是否阻止重复字符
max-repeating-characters: 3    # 允许的最大连续相同字符数

# 惩罚设置
punishment-issuer: "AntiSpam"  # 惩罚指令的执行者显示名称

# 惩罚类别配置
punishments:
  blocked-word:                # 违禁词违规
    enabled: true
    threshold: 3               # 触发惩罚的违规次数
    command: "tempmute %player% 2h Inappropriate behavior (#%punish_id%)"
  spam:                        # 刷屏违规
    enabled: true
    threshold: 5
    command: "tempmute %player% 30m Spamming (#%punish_id%)"
  flood:                       # 消息洪水违规
    enabled: true
    threshold: 5
    command: "tempmute %player% 15m Flood (#%punish_id%)"

# 违禁词列表
blocked-words:
  - "badword1"
  - "badword2"

语言文件示例（Locale_EN.yml）

prefix: "§6AntiSpam §8» "
blocked-word-message: "§7Your message contains a blocked word."
reload-message: "§7Plugin reloaded successfully."
wait-message: "§7You need to wait §6%remaining_time% §7seconds before sending another message."
repeat-message: "§7Do not send the same message twice in a row."
no-permission-message: "§cYou do not have permission to use this command."
repeat-character-message: "§7Your message contains too many repeating characters."
invalid-id-message: "§cID must be a number."
punish-check-not-found: "§cPunishment with this ID not found."
punish-check-found: |-
  §7Punishment Lookup
  §7Punishment ID: §6%id%
  §7Player: §e%player%
  §7Category: §c%category%
  §7Message: §f%content%

（捷克语 Locale_CZ.yml 和德语 Locale_DE.yml 文件结构类似，此处省略。）

---

重要提示：下载此文件即表示您同意不出售此插件或将其作为自己的产品展示。请勿通过评价来报告错误，如有任何问题请直接在我的 Discord 服务器上报告。如果您有新的功能建议，也欢迎在 Discord 服务器上联系我。