Super simple private messaging plugin!
Summary
This is an extremely simple (yet modestly powerful) private messaging plugin. It offers the following features:
- Command aliases (msg, tell, pm, write, w)
- reply command
- socialspy
- Works out of the box (no permissions plugin required)
- Send private messages to the console and vice versa!
Commands
Most of the commands were listed in the summary.
/msg [PlayerName] [Message] - Sends a private message to a player. The playername can also be 'console','terminal' or 'server' to send a message to the console.
/reply [Message] - Sends a private message to the player who last sent you a message.
/socialspy - Toggles socialspy mode. When this mode is enabled, the socialspy will see all exchanged private messages.
/zmessages - This reloads the config file. You can do '/zmessages reload' if it makes you feel better.
Permissions
The philosophy of this plugin is that it should just simply work when it's installed. No need to install a whole permissions plugin just to get this plugin to work right. This is great for small servers that don't normally have a need for a permissions plugin.
The nodes are the following:
ZMessages.msg - Allows use of the /msg command (default: true)
ZMessages.reply - Allows use of the /reply command (default: true)
ZMessages.socialspy - Allows use of the /socialspy command (default: ops only)
ZMessages.reload - Allows use of the /zmessages command (default: ops only)
ZMessages.* - Grants all of the above permissions
Configuration
Most of the configuration is for customizing the messages. Every message is read from this file, with an exception of some errors that are outputted to the console.
Only the messages under the format category are formatted, with an exception of notFound.general. The formatting options are the following:
%sender% - the sender of the private message
%reciever% - the receiver of the private message
%message% - the private message itself
The plugin will automatically fill in any config options you accidentally leave out. However, just in case you need it, the default config can be found here.
One of the config options of interest is the Remove_social_spy_on_logout. If this is set to true, then when a player logs out, his socialspy status will be turned off. This might have a negligible performance gain on large servers that stay up for long periods of time.
The other option of interest is the Console_is_socialspy. By default this is true, and player messages are logged to the console. However, this might seem a bit redundant, as the console already logs player commands. If the message logging and command logging seems redundant, you can shut off the message logging here.
Source
Source can be found on github!
Video
Thanks SamVenom for making a video!