DMentions ✨ Advanced Player Mention

DMentions ✨ Advanced Player Mention -----

Advanced Chat Player Mentioning

DMentions
DMentions is a versatile chat plugin that allows you to mention players effortlessly. Compatible with various chat plugins, it enhances your in-game communication with ease.

Features
- Toggle System: Enable or disable mentions quickly.
- Permissions: Manage who can use mention commands.
- Notification Sounds: Play sounds for mentions.
- Custom Keywords & Display Texts: Personalize your mentions.
- Mention Limits: Control the number of mentions.
- Restrict Player Mentions: Restrict who can be mentioned.
- Cooldowns: Prevent spam with cooldown settings.
- Notification Messages: Informative messages for both sender and target (action bar or title).
- Disabled Worlds: Stop mentioning at specified worlds.
- In-Game Configuring: Configure settings directly in-game.

Mention Types
- Player (Individual)
- Nearby
- Everyone
- Group (Members)

Commands
/dms toggle - Toggle mentionable mode
/dms send <keyword> - Send a mention via command
/dms reload - Reloads the config file
/dms config - Opens configuring menu
/dms customize <display> - Personalizes your mention display
/dms help - Command list of plugin
/dms user (...) - User management for admins

Permissions
dmentions.toggle - Toggle mentionable mode
dmentions.send - Send command permission
dmentions.admin - Has all the permissions
dmentions.reload - Reload config file
dmentions.configure - Open config menu
dmentions.customize - Customize command permission
dmentions.help - Help command permission
~
dmentions.mention.restricted - Restrict your mentions
dmentions.mention.restricted.bypass - Mention restricted players
~
dmentions.mention.player - Mention a player
dmentions.mention.nearby - Mention nearby players
dmentions.mention.everyone - Mention everyone
dmentions.mention.group.%group% - Mention groups
(!) Mention permissions are editable in config file.

Plugin Dependence
No dependence.
- Optional: Requires LuckPerms for group mentioning.

Installation
1- Download the latest version of the plugin.
2- Place the plugin in the plugins folder of your server.
3- Restart your server.
4- Enjoy the enhanced chat experience! :>

Documentation & Contact
Wiki: Check out the Wiki for help configuring the plugin.
Contact: Found a bug or have a suggestion? Contact me on Discord: desaxx or open an issue on the GitHub Page.

Pretty Please
Rate the plugin.
Leave a review.

Code (YAML):

# Happy editing!
# You can find me on Discord with username desaxx if you have any suggestions or bug reports, thank you!
# Or you can open an issue on GitHub page: https://github.com/desaxxx/DMentions/issues
#
# (!) Group getters work with LuckPerms weighting system so you might need to assign them one.
# (!) All the 'cooldown' values are representing in seconds.
# (!) Includes hex color support for messages and display. Usage: <#RRGGBB>
# (!) Messages are in lang directory since v1.3
# (!) You should leave values empty to remove them. Otherwise, the plugin will regenerate them with default values.
# (e.g. cooldown: 0, disabled_worlds: [], sound: "", ...)
#
# This file should exist within lang directory.
lang_file : "en-US"
check_for_updates : true
prefix : "&8[<#ffd16d>DMentions&8]&r"
# How many mentions in single message.
mention_limit : 2
# Chat colors of groups to match colors after mentioning.
suffix_color:
group :
# Example group named 'default'
default : "&7"
# For other unspecified groups.
__OTHER__ : "&f"
#
# Worlds that players cannot mention anybody.
disabled_worlds :
- "no_mention_world_1"
- "no_mention_world_2"
#
player:
enabled : true
permission : "dmentions.mention.player"
sound : "BLOCK_NOTE_BLOCK_PLING"
display : "<#a9e871>@{p}"
# display of the mention if the player customized it.
customized_display : "<#eac773>@{display}"
cooldown : 5
#
nearby:
enabled : true
permission : "dmentions.mention.nearby"
sound : "ENTITY_PLAYER_LEVELUP"
keyword : "@nearby"
display : "<#ea79b8>@nearby"
cooldown : 10
# You should keep this low if you treasure your server.
radius : 20
#
everyone:
enabled : true
permission : "dmentions.mention.everyone"
sound : "ENTITY_WITHER_SPAWN"
keyword : "@everyone"
display : "<#8fb56c>@everyone"
cooldown : 10
#
group :
# Requires LuckPerms, otherwise it will not work.
enabled : true
disabled_groups :
- "admin"
- "owner"
keyword : "@{group}"
permission : "dmentions.mention.group.{group}"
list :
# Example group named 'default'
default:
sound : "ITEM_TOTEM_USE"
display : "<#c0dee6>@{group}"
cooldown : 5
# For other unspecified groups which are not disabled.
__OTHER__:
sound : "ITEM_TOTEM_USE"
display : "<#73c7dc>@{group}"
cooldown : 5
#
config_version : "{version}" # DO NOT CHANGE.