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 权限的玩家,其消息中的颜色代码将被移除。
? 安装
- 下载
SendMSG.jar
- 将其放入服务器的
plugins/ 文件夹
- 重启服务器
- (可选)编辑
config.yml 或 messages/*.yml
- 完成!插件即刻生效
从 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
- ? 建议新功能 – 同一链接
- ? 获取帮助 – 同一链接
SendMSG – Private Messaging for Your Server


Lightweight, multilingual, and fully customizable private messaging plugin for Paper 1.21+ and 26.1+
Works on its own. No other plugin is required.
✨ Features
| Feature |
Description |
| ? 5 sending commands |
/msg, /m, /tell, /w, /pm |
| ? Quick reply |
/r or /reply – reply to the last sender, even if they are offline (when offline messages are on) |
| ? 3 languages |
English, Ukrainian, Russian (change with /sendmsg lang) |
| ?️ Anti-spam |
Configurable delay between messages, with a bypass permission |
| ? Sound alerts |
Customizable sounds for sending and receiving |
| ? Subtitles |
Popup notification when you receive a message |
| ? Block PMs |
/msgtoggle – disable incoming private messages |
| ?️ SocialSpy |
/spy – see all private messages (operators) |
| ? Ignore system |
/ignore and /ignore list – ignore players, with auto-expiry |
| ? Offline messages (optional) |
Messages to offline players are shown when they join |
| ? Link and IP filter (optional) |
Hides or blocks links and IP addresses in private messages |
| ?️ LuckPerms prefixes (optional) |
Shows the sender's group prefix, e.g. [Admin] Alex -> Bob |
| ? PlaceholderAPI (optional) |
Placeholders for unread count, last contact, and more |
| ?️ Clickable reply (optional) |
The reply hint is a button that fills in /r |
| ? Discord logging (optional) |
Sends every private message to a Discord channel (webhook) |
| ? Message logging |
All PMs saved to logs/private.log |
| ? Storage |
SQLite database (default) or YAML files |
| ? Auto cleanup |
Expired ignores are removed every minute; old offline messages every hour |
| ? Update notifications |
Checks Modrinth on startup and tells operators when a new version is out |
| ? Fully customizable |
All messages in messages/*.yml, with colour codes |
| ⚡ EssentialsX compatible |
Takes over private messages from EssentialsX |
Optional features are OFF by default. Turn them on in config.yml. The plugin works without any of them.
? How it looks in-game
When you send a message:
✉ You -> Player: Hello!
When you receive a message:
- ? Subtitle:
✉ You have a message
- ? Chat:
✉ Player writes you: Hello!
- ? Reply hint:
→ Reply with: /r (text)
- ? Sound:
ENTITY_EXPERIENCE_ORB_PICKUP
⚠️ All text, sounds, subtitles, and colours can be changed in the configuration files.
? Commands
| Command |
Description |
Aliases |
/msg <player> <message> |
Send a private message |
/m, /w, /tell, /pm |
/r <message> |
Reply to the last player you talked to |
/reply |
/ignore <player> |
Ignore or unignore a player (toggle) |
/ig |
/ignore list |
Show who you ignore and how long each ignore lasts |
– |
/msgtoggle |
Turn incoming private messages on or off |
– |
/spy |
Toggle SocialSpy (see all PMs) |
– |
/sendmsg lang <code> |
Change the plugin language |
– |
/sendmsg spies |
Show who currently has SocialSpy on |
– |
/sendmsg reload |
Reload the configuration |
– |
/sendmsg help |
Show help |
– |
Language codes: EN (English), UA (Ukrainian), RU (Russian)
? Permissions
| Permission |
Description |
Default |
sendmsg.msg |
Allows /msg and /m |
✅ true |
sendmsg.reply |
Allows /r and /reply |
✅ true |
sendmsg.ignore |
Allows /ignore |
✅ true |
sendmsg.msgtoggle |
Allows /msgtoggle |
✅ true |
sendmsg.color |
Allows colour codes (&a, &#RRGGBB...) in private messages |
? op |
sendmsg.bypass.cooldown |
Bypass the message cooldown |
? op |
sendmsg.filter.bypass |
Not filtered by the link and IP filter |
? op |
sendmsg.spy |
Allows /spy (SocialSpy) |
? op |
sendmsg.admin |
Access to /sendmsg admin commands |
? op |
With LuckPerms, give these permissions to groups in LuckPerms instead of to single players.
⚙️ Configuration (config.yml)
Basics
# Plugin language: ru-RU, uk-UA, en-EN
lang: en-EN
# Delay between messages, in seconds
cooldown-seconds: 10
# Longest private message, in characters (0 = no limit)
max-message-length: 200
Features
Turn parts of the plugin on or off:
features:
subtitle: true # subtitle when you receive a message
sound-receive: true # sound when you receive a message
sound-send: true # sound when you send a message
reply-hint: true # "/r" hint below incoming messages
clickable-reply: false # make the hint a button (off by default)
cooldown: true # message cooldown
msg-toggle: true # /msgtoggle
social-spy: true # /spy
log-to-file: true # save all PMs to logs/private.log
Storage
storage:
type: sqlite # sqlite = plugins/SendMSG/sendmsg.db | yaml = ignores.yml, names.yml, offline.yml
fallback-to-yaml: false # if SQLite cannot open, stop with an error (false) or use YAML files (true)
On the first start with sqlite, data from the YAML files is imported automatically (only if the database is empty). Changing storage.type later does not move data back. Restart the server after changing it.
Offline messages (off by default)
offline-messages:
enabled: false # store messages for offline players
max-per-player: 50 # undelivered messages per player
expire-days: 30 # delete undelivered messages after N days (0 = keep)
Link and IP filter (off by default)
filters:
enabled: false # turn the filter on
links: true # hide http(s):// and www. links and bare domains
ip-addresses: true # hide IPv4 addresses, with or without a port
action: mask # mask = replace with [hidden] | block = do not send the message
Integrations (off by default)
integrations:
luckperms:
enabled: false # show the sender's LuckPerms prefix (needs LuckPerms)
placeholderapi:
enabled: false # register %sendmsg_...% placeholders (needs PlaceholderAPI)
Restart the server after changing the integrations.
Discord logging (off by default)
discord-webhook:
enabled: false
url: "" # your webhook URL – keep it secret
username: "SendMSG Spy"
Setup guide: docs/discord-webhook.md.
Sounds
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
Ignores
ignore:
auto-expire-days: 7 # remove an ignore after N days (0 = forever)
notify-ignored-sender: true # tell the sender their message was blocked
Update checker
update-checker:
enabled: true # check Modrinth on startup for a new version
notify-ops-on-join: true # tell operators when they join, if an update exists
? Message formats
Texts are in messages/en-EN.yml, messages/uk-UA.yml, and 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"
Colour codes: &0-9, &a-f, &k-o, &r, and &#RRGGBB. Players without sendmsg.color have them removed from their messages.
? Installation
- Download
SendMSG.jar
- Place it in your server's
plugins/ folder
- Restart your server
- (Optional) Edit
config.yml or messages/*.yml
- Done! The plugin works immediately
Upgrading from 2.0.x? Your ignore lists and nicknames from ignores.yml and names.yml are imported into the new SQLite database on the first start. The original files are kept as a backup. To keep using the YAML files instead, set storage.type: yaml. Your config.yml is rebuilt from the new template on the first start: comments and layout are updated, your values are kept, and the old file is saved as config.backup-v<n>.yml. Settings that no longer exist are removed.
❓ FAQ
-
How do I change the language?
Use /sendmsg lang EN (English), /sendmsg lang UA (Ukrainian), or /sendmsg lang RU (Russian).
-
How do I disable sounds?
Set sound-receive: false and sound-send: false in config.yml.
-
How do I remove the cooldown?
Set cooldown-seconds: 0 in config.yml, or give players the sendmsg.bypass.cooldown permission.
-
How does /ignore work?
/ignore <player> adds a player to your ignore list. Use the command again to remove them. A blocked sender is told that you ignore them (unless you turn notify-ignored-sender off).
-
Can ignores expire automatically?
Yes. Ignores are removed after auto-expire-days.
-
Can I block all private messages?
Yes. Use /msgtoggle. Nobody can message you until you turn it back on.
-
What is SocialSpy?
Admins with sendmsg.spy can use /spy to see all private messages on the server.
-
Can players message someone who is offline?
Only if you turn on offline-messages.enabled. The message is shown when the player joins.
-
Can I hide links and IP addresses in messages?
Yes. Turn on filters.enabled. Choose mask to hide them, or block to refuse the whole message.
-
Where is data stored?
storage.type: sqlite: ignore lists, last known nicknames, and offline messages are in plugins/SendMSG/sendmsg.db.
storage.type: yaml: the same data is in ignores.yml, names.yml, and offline.yml.
- All private messages are logged in
plugins/SendMSG/logs/private.log.
- Cooldowns,
/msgtoggle, SocialSpy, and last contact are kept in memory only and reset on restart.
-
Does it work with EssentialsX?
Yes. SendMSG handles private messages before EssentialsX, so you can use both.
-
Can the console send messages?
Yes. The console can use /msg <player> <message>.
-
Does the plugin send data anywhere?
- On startup, SendMSG makes one read-only request to the public Modrinth API to check for a newer version. Disable it with
update-checker.enabled: false.
- If you turn on Discord logging, every private message is sent to the Discord webhook you configure. Only turn it on if you want that.
- Nothing else leaves your server.
Statistics
? Support
- ? Report a bug – Join our Discord
- ? Suggest a feature – Same link
- ? Get help – Same link
评论 0
登录后参与评分
还没有评论,来抢沙发吧