SimpleMessages

ABOUT SIMPLEMESSAGES

SimpleMessages is a lightweight standalone private messaging plugin inspired by the familiar messaging experience found in Essentials.

It provides everything needed for player-to-player private messaging while remaining simple, configurable and easy to manage.

✨ FEATURES

✔ Private player messaging
✔ Quick replies with /reply and /r
✔ Persistent player ignore system
✔ Offline player support for ignore/unignore
✔ Ignore list command
✔ SocialSpy for staff
✔ Permission-based message colors
✔ Permission-based message formatting
✔ Configurable message cooldown
✔ Cooldown bypass permission
✔ Ignore bypass permission
✔ Vanish / hidden-player protection
✔ Smart tab completion
✔ Fully customizable message formats
✔ Fully customizable language file
✔ UUID-based player data
✔ Console and file logging options
✔ Configuration reload support

PRIVATE MESSAGING

Send private messages using familiar commands:

Quickly reply using:

Sender and receiver formats are fully customizable through config.yml.

IGNORE SYSTEM

Players can block unwanted private messages with:

Ignore data is persistent, UUID-based and supports previously known offline players.

COLORS & FORMATTING

Message colors and formatting can be controlled separately through permissions.

Colors
Formatting
Supports standard Minecraft color and formatting codes while preventing unauthorized formatting.

SOCIALSPY

Staff can monitor successfully delivered private messages using:

SocialSpy can be enabled or disabled globally and includes a customizable display format.

⏱ MESSAGE COOLDOWN

Optional cooldown protection helps reduce private-message spam.

Set the value to 0 to disable cooldowns.

Players with:

can bypass the configured delay.

MESSAGE LOGGING

Optional private-message logging supports:

✔ Console logging
✔ File logging
✔ Session-based log files
✔ Automatic log archiving

Current-session messages are stored in:

Previous sessions are archived under:

⌨ TAB COMPLETION

Smart tab completion is included for:

/unignore only suggests players currently ignored.

⚙ CONFIGURATION

SimpleMessages provides configuration for:

✔ Self messaging
✔ Maximum message length
✔ Message cooldown
✔ Reply behavior
✔ Ignore bypass
✔ Player-data autosaving
✔ Incoming message format
✔ Outgoing message format
✔ SocialSpy
✔ Message logging

LANGUAGE FILE

All player-facing messages can be customized through lang.yml.

Supported placeholders include values such as:

COMMANDS

COMMAND	ALIASES	DESCRIPTION
/message	/msg, /m, /tell, /whisper, /w, /pm	Send a private message
/reply	/r	Reply to your latest conversation
/ignore	/block	Ignore a player
/unignore	/unblock	Remove a player from your ignore list
/ignorelist	/ignored, /blocklist	View ignored players
/socialspy	/sspy	Toggle SocialSpy
/simplemessages	/sm	Main plugin command
/simplemessages help	/sm help	View plugin commands
/simplemessages version	/sm version	View plugin version
/simplemessages reload	/sm reload	Reload configuration

PERMISSIONS

PERMISSION	DEFAULT	DESCRIPTION
simplemessages.message	TRUE	Use private messaging
simplemessages.reply	TRUE	Use /reply
simplemessages.ignore	TRUE	Use /ignore
simplemessages.unignore	TRUE	Use /unignore
simplemessages.ignorelist	TRUE	Use /ignorelist
simplemessages.message.color	OP	Use colors in private messages
simplemessages.message.format	OP	Use formatting in private messages
simplemessages.bypass.ignore	OP	Bypass player ignore lists
simplemessages.bypass.cooldown	OP	Bypass message cooldown
simplemessages.socialspy	OP	Use SocialSpy
simplemessages.admin	OP	Administrative permission
simplemessages.admin.reload	OP	Reload SimpleMessages

STORAGE

SimpleMessages uses lightweight UUID-based YAML storage with in-memory caching and configurable autosaving.

Player data is stored under:

No database setup is required.

COMPATIBILITY

Minecraft: 1.12.2
Java: Java 8
Platform: Spigot based servers