Update 3.1 - Extended messages lookup, messages deletion feature and message sounds update

This update contains major changes. Please read carefully before upgrading from older versions!
Replacing existing plugin jar with a new one without further actions is safe thanks to old configurations compatibility, but you may miss out new features personalization.


Messages Deletion feature
Added ability do delete selected messages from command. Privileged user can precisely select what messages to delete using filters like player names and dates. Dedicated command to this feature: /pmdelete.
Additionally, as a protection layer, there is deletion confirmation feature (enabled by default in config.yml), where user has to execute /pmconfirm command before proceeding.
More about this here.

Changes to Messages History (/pmhistory) command
Messages history command (/pmhistory) has been updated to allow for more precise message filtering, using the same command arguments syntax as in /pmdelete command. Old syntax is still supported, allowing for basic messages filtering like before to keep all player-friendly.
Now it’s possible to control how message items look, by modifying their material identifiers in config.yml file.

Message Actions feature
When viewing messages in Messages History inventory, privileged user can click on selected message to perform further actions with it. Currently possible action is to delete selected message (permission is required). More expansion related to this feature is expected in upcoming updates.

Changes to notification sounds and Sound Inventory
Sound Inventory now includes 9 additional music discs added in Minecraft from versions 1.16 to 1.21. Music discs are randomly picked to represent each notification sound in inventory.

After opening „Sound Inventory”, the actively used sound is now marked by „ (active)” text added next to its display name. This text can be changed in lang.yml file.

Each item from Sound Inventory corresponding to given sound now allows for custom display name and description (lore).

Each notification sound can now have it’s own required permission (this feature is disabled by default).

Server owners can decide whether to show inaccessible notification sounds in Sound Inventory, allowing only to listen to these sounds.

Now it’s possible to compose notification sounds consisting of two or more separate sounds.

Added 29 new notification sounds to default sounds configuration (sounds.yml) – 4 of them are composed using more than one sound.

Changes to configuration files

config.yml
„TimeZone” key has moved from „MessagesHistory” to a root node.
Renamed „BungeeCord” key to „Proxy”.

All old names/mappings for above modified keys still work to keep plugin compatible with older configuration files, but this may change in the future so please update your config whenever possible.

Added 11 new entries (paste them into existing config.yml):

[Bukkit servers]

[Proxy servers]
lang.yml

[Bukkit servers]
Added 27 new entries (paste them into existing lang.yml):

Renamed keys:

„INV_MESSAGES_TITLE” to „INV_MESSAGES_HISTORY_TITLE”.

„INV_HISTORY_MESSAGE_ENTRY_NAME” to „INV_MESSAGES_HISTORY_MESSAGE_ENTRY_NAME”

„INV_HISTORY_MESSAGE_ENTRY_MESSAGE_LINE” to „INV_MESSAGES_HISTORY_MESSAGE_ENTRY_MESSAGE_LINE”

„INV_HISTORY_MESSAGE_ENTRY_DATE” to
„INV_MESSAGES_HISTORY_MESSAGE_ENTRY_DATE”

„INFO_HISTORY_DISABLED” to INFO_MESSAGES_HISTORY_DISABLED”

When loading plugin with older configuration, these keys will get auto-updated.

[Proxy servers]
Added 15 new entries (paste them into existing lang.yml):

If you haven’t modified default configuration you can just delete this file and let plugin create new one to apply all changes.

Rearranged entries order to make navigation through language file more intuitive (this applies to freshly generated lang.yml).

sounds.yml

Updated file to include introduced DisplayName and Description modifications to notifications sounds items displayed in Sound Inventory and also extra 29 default sounds mentioned before.

Following code also shows how sounds consisting of more than one sound are constructed.


If you haven’t modified default configuration you can just delete this file and let plugin create new one to apply all changes.


New permissions
pm.actions – access to message actions
pm.actions.delete – access to „delete message” action
pm.delete – access to /pmdelete command
pm.confirm – access to /pmconfirm command

Improvements
Players no longer receive post-join and post-unvanish notification about unread messages when they don’t have permission to use /pmread command.

More
Updated plugin help pages to include changes introducted with this update.