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)

MSG DonutSMP