msgDonutSMP
一款高度可配置的 DonutSMP 风格私人消息系统,适用于 Paper 服务器(Java 17)。具备隐身状态感知消息传递、持久化忽略列表及图形界面管理、MiniMessage 格式化、PlaceholderAPI 占位符支持以及可选的 bStats 指标统计等功能。
功能特性
- 完整消息流程:
/msg、/r、/msgignore、/msgunignore、/msgignorelist、/msgreload。
- 隐身保护机制,检查 Paper 可见性并支持 PlaceholderAPI 隐身标签(采用 OR 逻辑门)。
- 持久化的忽略数据存储,提供基于头像的 GUI 列表以便快速取消忽略操作。
- 由 MiniMessage 驱动的可配置消息与格式输出。
- 为 PlaceholderAPI 提供的扩展,支持查询最后对话伙伴及忽略统计信息。
命令与权限
msg.use — 使用消息和忽略命令(默认:true)
msg.bypass.vanish — 允许向隐身玩家发送消息(默认:op)
msg.bypass.ignore — 豁免被其他玩家忽略(默认:op)
msg.admin — 重载配置/数据及执行管理员操作(默认:op)
示例命令:
/msg <player> <message> — 发送私密消息。
/r <message> — 回复上一次对话的伙伴。
/msgignore <player> — 将玩家加入忽略列表。
/msgunignore <player> — 从忽略列表中移除玩家。
/msgignorelist — 打开忽略列表 GUI。
/msgreload — 重载 config.yml 和数据(需要 msg.admin 权限)。
配置概览
插件自带 config.yml,包含以下选项:
options.allow-ignore-staff — 是否允许忽略工作人员。
placeholderapi.differentiate-vanished — 在占位符中追加隐身后缀。
placeholderapi.vanished-suffix — 用于隐身玩家的后缀字符串。
placeholderapi.vanish-placeholders — PlaceholderAPI 隐身标签(采用 OR 逻辑)。
formats.sent / formats.receive — 消息格式模板。
messages.* — 所有面向用户的文本(兼容 MiniMessage)。
gui.title — 忽略列表 GUI 标题。
在格式/消息条目中使用 MiniMessage 标签和十六进制颜色。当存在 PlaceholderAPI 时,将使用其占位符。
给服务器管理员的说明
- 隐身检测同时支持 Paper 可见性和配置的 PlaceholderAPI 标签。
- 忽略数据由插件持久化保存,并在启动时重新加载。
技术要求
- Java: 17+
- 目标平台: Paper (1.20.2+)
- 可选依赖: PlaceholderAPI (软依赖)
msgDonutSMP
A highly-configurable DonutSMP-style private messaging system for Paper servers (Java 17). Features vanish-aware messaging, persistent ignore lists with GUI management, MiniMessage formatting, PlaceholderAPI placeholders, and optional bStats metrics.
Features
- Full message flow:
/msg, /r, /msgignore, /msgunignore, /msgignorelist, /msgreload.
- Vanish protection that checks Paper visibility and supports PlaceholderAPI vanish tags (OR gate).
- Persistent ignore storage with a head-based GUI list for quick unignore actions.
- MiniMessage-powered configurable message and format output.
- PlaceholderAPI expansion for last partner and ignore stats.
Commands & Permissions
msg.use — Use messaging and ignore commands (default: true)
msg.bypass.vanish — Allow messaging vanished players (default: op)
msg.bypass.ignore — Exempt player from being ignored (default: op)
msg.admin — Reload config/data and admin actions (default: op)
Example commands:
/msg <player> <message> — Send a private message.
/r <message> — Reply to your last conversation partner.
/msgignore <player> — Add a player to your ignore list.
/msgunignore <player> — Remove a player from your ignore list.
/msgignorelist — Open ignore list GUI.
/msgreload — Reload config.yml and data (requires msg.admin).
Config (high level)
The plugin ships with config.yml exposing:
options.allow-ignore-staff — Whether staff can be ignored.
placeholderapi.differentiate-vanished — Append vanished suffix in placeholders.
placeholderapi.vanished-suffix — Suffix appended for vanished players.
placeholderapi.vanish-placeholders — PlaceholderAPI vanish tags (OR logic).
formats.sent / formats.receive — Message format templates.
messages.* — All user-facing text (MiniMessage-compatible).
gui.title — Ignore list GUI title.
Use MiniMessage tags and hex colors in format/message entries. PlaceholderAPI placeholders are used when PlaceholderAPI is present.
Notes for Server Owners
- Vanish detection supports both Paper visibility and configured PlaceholderAPI tags.
- Ignore data is persisted by the plugin and reloaded on startup.
Technical
- Java: 17+
- Target: Paper (1.20.2+)
- Optional: PlaceholderAPI (softdepend)
评论 0
登录后参与评分
还没有评论,来抢沙发吧