SendMSG

插件

· 作者 zamber

SendMSG – 为你的服务器提供私密消息功能

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

最新 2.1.0 · 26.3 · Paper

一键开服(送7天)

SendMSG – 服务器的私聊插件

SendMSG

发送消息 接收消息 副标题

轻量级、多语言且完全可定制的私聊插件,适用于 Paper 1.21+ 和 26.1+ 独立运行,无需其他插件。


✨ 功能

功能 描述
? 5种发送命令 /msg, /m, /tell, /w, /pm
? 快速回复 /r 或 /reply – 回复最后一条消息的发送者,即使对方离线(当启用离线消息时)
? 3种语言 英语、乌克兰语、俄语(通过 /sendmsg lang 切换)
?️ 防垃圾信息 可配置的消息间隔时间,并拥有绕过权限
? 声音提醒 发送和接收时可自定义声音
? 副标题 收到消息时的弹窗通知
? 屏蔽私聊 /msgtoggle – 禁用收到的私聊消息
?️ 社交间谍 /spy – 查看所有私聊消息(仅限管理员)
? 忽略系统 /ignore 和 /ignore list – 忽略特定玩家,支持自动过期
? 离线消息 (可选) 发送给离线玩家的消息会在其上线时显示
? 链接与IP过滤 (可选) 隐藏或阻止私聊中的链接和 IP 地址
?️ LuckPerms 前缀 (可选) 显示发送者的组前缀,例如 [Admin] Alex -> Bob
? PlaceholderAPI (可选) 未读数量、上次联系等占位符
?️ 可点击回复 (可选) 回复提示是一个按钮,点击后会自动填入 /r
? Discord 日志记录 (可选) 将每条私聊消息发送到 Discord 频道(通过 Webhook)
? 消息日志记录 所有私聊消息保存至 logs/private.log
? 存储方式 SQLite 数据库(默认)或 YAML 文件
? 自动清理 每分钟移除过期的忽略列表;每小时清理旧的离线消息
? 更新通知 启动时检查 Modrinth 并在有新版本时通知管理员
? 完全可定制 所有消息位于 messages/*.yml 中,支持颜色代码
⚡ EssentialsX 兼容 接管 EssentialsX 的私聊功能

可选功能默认处于关闭状态。 请在 config.yml 中开启它们。该插件在不启用任何可选功能的情况下也能正常工作。


? 游戏内效果

当你发送消息时:

✉ You -> Player: Hello!

当你接收消息时:

  • ? 副标题:✉ You have a message
  • ? 聊天栏:✉ Player writes you: Hello!
  • ? 回复提示:→ Reply with: /r (text)
  • ? 声音:ENTITY_EXPERIENCE_ORB_PICKUP

⚠️ 所有文本、声音、副标题和颜色均可在配置文件中更改。


? 命令

命令 描述 别名
/msg <player> <message> 发送私聊消息 /m, /w, /tell, /pm
/r <message> 回复你最后交谈过的玩家 /reply
/ignore <player> 忽略或取消忽略某位玩家(切换) /ig
/ignore list 显示你忽略的玩家以及每个忽略状态的持续时间 –
/msgtoggle 开启或关闭接收到的私聊消息 –
/spy 切换社交间谍模式(查看所有私聊) –
/sendmsg lang <code> 更改插件语言 –
/sendmsg spies 显示当前谁开启了社交间谍模式 –
/sendmsg reload 重新加载配置 –
/sendmsg help 显示帮助信息 –

语言代码: EN(英语)、UA(乌克兰语)、RU(俄语)


? 权限

权限 描述 默认值
sendmsg.msg 允许使用 /msg 和 /m ✅ true
sendmsg.reply 允许使用 /r 和 /reply ✅ true
sendmsg.ignore 允许使用 /ignore ✅ true
sendmsg.msgtoggle 允许使用 /msgtoggle ✅ true
sendmsg.color 允许在私聊中使用颜色代码(&a, &#RRGGBB...) ? op
sendmsg.bypass.cooldown 绕过消息冷却时间 ? op
sendmsg.filter.bypass 不受链接和 IP 过滤器限制 ? op
sendmsg.spy 允许使用 /spy(社交间谍) ? op
sendmsg.admin 访问 /sendmsg 管理命令 ? op

使用 LuckPerms 时,请将这些权限分配给 LuckPerms 中的用户组,而不是单个玩家。


⚙️ 配置 (config.yml)

基础设置

# 插件语言: ru-RU, uk-UA, en-EN
lang: en-EN

# 消息间隔时间(秒)
cooldown-seconds: 10

# 私聊最大字符数(0 表示无限制)
max-message-length: 200

功能开关

开启或关闭插件的部分功能:

features:
  subtitle: true          # 接收消息时显示副标题
  sound-receive: true     # 接收消息时播放声音
  sound-send: true        # 发送消息时播放声音
  reply-hint: true        # 在接收到的消息下方显示 "/r" 提示
  clickable-reply: false  # 将提示变为按钮(默认关闭)
  cooldown: true          # 消息冷却时间
  msg-toggle: true        # /msgtoggle 功能
  social-spy: true        # /spy 功能
  log-to-file: true       # 将所有私聊保存到 logs/private.log

存储设置

storage:
  type: sqlite            # sqlite = plugins/SendMSG/sendmsg.db | yaml = ignores.yml, names.yml, offline.yml
  fallback-to-yaml: false # 如果无法打开 SQLite,是否报错停止(false)或使用 YAML 文件(true)

首次使用 sqlite 启动时,YAML 文件中的数据会自动导入(仅当数据库为空时)。稍后更改 storage.type 不会将数据移回原处。更改后请重启服务器。

离线消息(默认关闭)

offline-messages:
  enabled: false          # 为离线玩家存储消息
  max-per-player: 50      # 每位玩家未送达消息的最大数量
  expire-days: 30         # N 天后删除未送达的消息(0 = 永久保留)

链接与 IP 过滤(默认关闭)

filters:
  enabled: false          # 开启过滤器
  links: true             # 隐藏 http(s)://、www. 开头的链接及裸域名
  ip-addresses: true      # 隐藏 IPv4 地址,无论是否包含端口
  action: mask            # mask = 替换为 [hidden] | block = 不发送该消息

集成插件(默认关闭)

integrations:
  luckperms:
    enabled: false        # 显示发送者的 LuckPerms 前缀(需要 LuckPerms)
  placeholderapi:
    enabled: false        # 注册 %sendmsg_...% 占位符(需要 PlaceholderAPI)

更改集成设置后请重启服务器。

Discord 日志记录(默认关闭)

discord-webhook:
  enabled: false
  url: ""                 # 你的 Webhook URL – 请妥善保管
  username: "SendMSG Spy"

设置指南:docs/discord-webhook.md。

音效

sound:
  receive:
    name: ENTITY_EXPERIENCE_ORB_PICKUP
    volume: 1.0
    pitch: 1.2
  send:
    name: ENTITY_VILLAGER_WORK_CARTOGRAPHER
    volume: 1.0
    pitch: 1.0

屏蔽列表

ignore:
  auto-expire-days: 7            # N 天后移除屏蔽对象(0 = 永久屏蔽)
  notify-ignored-sender: true    # 告知发送者其消息被拦截

更新检查器

update-checker:
  enabled: true              # 在服务器启动时检查 Modrinth 是否有新版本
  notify-ops-on-join: true   # 如果存在更新,在管理员加入时通知他们

? 消息格式

文本位于 messages/en-EN.yml、messages/uk-UA.yml 和 messages/ru-RU.yml 中。

format:
  incoming:    "&2✉ &f&l{from} &7writes you: &f{message}"
  reply-hint:  "&2→ &7Reply with: &b&n/r (text)"
  outgoing:    "&2✉ &7&lYou &7-> &f&l{to}&7: &f{message}"
  spy:         "&8[SPY] &7{from} -> {to}: {message}"
  console-name: "Console"

subtitle: "&2✉ &7You have a message"
subtitle-reply: "&2✉ &7Someone replied to you"

颜色代码: &0-9、&a-f、&k-o、&r 以及 &#RRGGBB。没有 sendmsg.color 权限的玩家,其消息中的颜色代码将被移除。


? 安装

  1. 下载 SendMSG.jar
  2. 将其放入服务器的 plugins/ 文件夹
  3. 重启服务器
  4. (可选)编辑 config.yml 或 messages/*.yml
  5. 完成!插件即刻生效

从 2.0.x 版本升级? 在首次启动时,ignores.yml 和 names.yml 中的屏蔽列表和昵称将导入新的 SQLite 数据库。原始文件将作为备份保留。若要继续使用 YAML 文件,请设置 storage.type: yaml。你的 config.yml 将在首次启动时根据新模板重建:注释和布局将更新,你的配置值将被保留,旧文件将保存为 config.backup-v<n>.yml。已不再存在的设置将被移除。


❓ 常见问题

  • 如何更改语言? 使用 /sendmsg lang EN(英语)、/sendmsg lang UA(乌克兰语)或 /sendmsg lang RU(俄语)。

  • 如何禁用音效? 在 config.yml 中设置 sound-receive: false 和 sound-send: false。

  • 如何移除冷却时间? 在 config.yml 中设置 cooldown-seconds: 0,或者给予玩家 sendmsg.bypass.cooldown 权限。

  • /ignore 命令如何使用? /ignore <player> 将一名玩家添加到你的屏蔽列表中。再次使用该命令可将其移除。被屏蔽的发送者会被告知你正在屏蔽他(除非你关闭 notify-ignored-sender)。

  • 屏蔽列表可以自动过期吗? 可以。屏蔽列表会在 auto-expire-days 设定的天数后自动移除。

  • 我可以屏蔽所有私信吗? 可以。使用 /msgtoggle。在你重新开启之前,任何人都无法给你发消息。

  • 什么是 SocialSpy(社交间谍)? 拥有 sendmsg.spy 权限的管理员可以使用 /spy 查看服务器上所有的私信。

  • 玩家可以给离线玩家发消息吗? 仅当你开启 offline-messages.enabled 时可行。当玩家上线时,他们会看到这些消息。

  • 我可以在消息中隐藏链接和 IP 地址吗? 可以。开启 filters.enabled。选择 mask 以隐藏它们,或选择 block 以拒绝整条消息。

  • 数据存储在哪里?

    • storage.type: sqlite:屏蔽列表、上次记录的昵称和离线消息存储在 plugins/SendMSG/sendmsg.db 中。
    • storage.type: yaml:相同的数据存储在 ignores.yml、names.yml 和 offline.yml 中。
    • 所有私信都记录在 plugins/SendMSG/logs/private.log 中。
    • 冷却时间、/msgtoggle、SocialSpy 状态和最后联系时间仅保存在内存中,重启后会重置。
  • 它是否与 EssentialsX 兼容? 是的。SendMSG 会在 EssentialsX 之前处理私信,因此你可以同时使用两者。

  • 控制台可以发送消息吗? 可以。控制台可以使用 /msg <player> <message>。

  • 插件会向外部发送数据吗?

    • 在启动时,SendMSG 会向公共 Modrinth API 发起一次只读请求以检查是否有新版本。可通过设置 update-checker.enabled: false 禁用此功能。
    • 如果你开启了 Discord 日志记录,每条私信都会发送到你配置的 Discord Webhook。仅在你需要此功能时开启。
    • 除此之外,没有任何其他数据离开你的服务器。

统计信息

? 支持

  • ? 报告 Bug – 加入我们的 Discord
  • ? 建议新功能 – 同一链接
  • ? 获取帮助 – 同一链接

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源