BoringMSG - The Complete Private Messaging Suite


Tired of the bland and basic /msg command? BoringMSG is a powerful, modern, and lightweight plugin designed to completely overhaul your server's private messaging system. It replaces the vanilla commands with a feature-rich suite that gives control to both your players and your staff.

From a permission-based sound selection GUI to advanced message spying, BoringMSG provides everything you need in a simple, drop-in-and-play package.





✨ Features

• Customizable Formats: Change the look and feel of messages, action bars, and spy formats with full color code support.
  
  
• Sound Selection GUI: A sleek, permission-based GUI (/msg sound) that lets players choose their own notification sound from a list you define!
  
  
• Player-Centric Controls:
  • /msg ignore: Block messages from specific players.
    
    
  • /msg toggle: Completely disable or enable all incoming private messages.
• Powerful Staff Tools:
  • /msg spy: Silently monitor private messages between players to ensure server safety.
    
    
  • /boringmsg reload: Reload the configuration without needing a full server restart.
• Modern Notifications: Send messages to the player's Action Bar for a configurable duration so they never miss a message.
  
  
• Intuitive & Efficient: Full tab-completion on all commands makes usage fast and easy.
  
  
• Highly Configurable: Almost every message, setting, and sound can be customized in the easy-to-use config files.

Commands


Here is a full list of commands available in BoringMSG.



Player Commands

• /msg <player> <message>
  • Aliases: /tell, /whisper, /message
    
    
  • Description: Sends a private message to another player.
    
    
  • Permission: boringmsg.use
• /reply <message>
  • Alias: /r
    
    
  • Description: Replies to the last person who messaged you or you messaged.
    
    
  • Permission: boringmsg.use
• /msg ignore <player>
  • Aliases: /msg block, /msg mute
    
    
  • Description: Blocks a player, preventing them from sending you messages.
    
    
  • Permission: boringmsg.ignore
• /msg unignore <player>
  • Aliases: /msg unblock, /msg unmute
    
    
  • Description: Unblocks a player, allowing them to message you again.
    
    
  • Permission: boringmsg.ignore
• /msg toggle
  • Description: Toggles your private messages on or off. While off, no one can send you a message.
    
    
  • Permission: boringmsg.toggle
• /msg sound
  • Description: Opens a GUI to select your personal message notification sound.
    
    
  • Permission: boringmsg.sound.gui

Staff & Admin Commands

• /msg spy <player|all|list>
  • Description:
    • spy <player>: See messages sent to or from a specific player.
      
      
    • spy all: See all private messages on the server.
      
      
    • spy list: See who you are currently spying on.
  • Permission: boringmsg.spy
• /msg unspy <player|all>
  • Description: Stops spying on a player or on all messages.
    
    
  • Permission: boringmsg.spy
• /boringmsg reload
  • Description: Reloads the config.yml and playerdata.yml files.
    
    
  • Permission: boringmsg.reload

Permissions

• boringmsg.use: Allows use of /msg and /reply. (Default: true)
  
  
• boringmsg.ignore: Allows use of /msg ignore and /msg unignore. (Default: true)
  
  
• boringmsg.toggle: Allows use of /msg toggle. (Default: true)
  
  
• boringmsg.spy: Allows use of the /msg spy and /msg unspy commands. (Default: op)
  
  
• boringmsg.reload: Allows use of /boringmsg reload. (Default: op)
  
  
• boringmsg.sound.gui: Allows players to open the sound selection menu with /msg sound. (Default: true)
  
  
• boringmsg.sound.<sound_name>: Grants access to a specific sound in the GUI. The <sound_name> corresponds to the keys you define in config.yml (e.g., boringmsg.sound.orb, boringmsg.sound.amethyst).

⚙️ Configuration


BoringMSG is designed to be highly configurable. The config.yml allows you to change:

• The format of messages sent to the sender and receiver.
  
  
• The format of messages shown to spies.
  
  
• The format, duration, and status of Action Bar messages.
  
  
• All sounds available in the /msg sound GUI, including their permission, display item, name, lore, and slot.
  
  
• Nearly every message the plugin sends to players, from error messages to success confirmations.

Installation

1. Download the BoringMSG.jar file.
   
   
2. Place the .jar file into your server's /plugins folder.
   
   
3. Start or restart your server. The default configuration files (config.yml, playerdata.yml) will be generated.
   
   
4. Configure permissions and customize the config.yml to your liking.
   
   
5. Run /boringmsg reload to apply your changes. You're all set!