Support for 1.14 - 1.18 is in the development builds.
Development builds can be found in my discord. https://discord.gg/kJyZwBj
This is a simple plugin that I originally made for my friends but has now turned into more of a hobby. Anyways, they updated their server to 1.11 and their previous Hugs plugin didn't work anymore because there wasn't an update for it. Since it wasn't updated, they looked for a replacement but those were also outdated or they were abandoned. I didn't know how to update the one they had, but I thought that it should be easy enough to replicate. I was both right and wrong. Anyways, I realized that since most other emotion-based plugins are outdated I would share it here so that everyone would have an updated version to use. I hope that you enjoy.

- Customizable messages.
- Message that you receive and the recipient receives.
- Title and Subtitle that the recipient receives.
- A configurable option to enable/disable it.
- Server broadcast message.
- A configurable option to enable/disable it.
- Player cannot be found message.
- Insufficient permissions message.
- Invalid arguments message.
- Too many arguments message.
- Reload command message.
- Cooldown message.
- Total hugs given message.
- Player profile message.
- Clickable commands.
- Customizable particles & sounds.
- Two configurable options to restore player's health & hunger.
- Verbose output. (Console & File)
- Logs information such as who reloaded the config, who gave who a hug etc, to the console.
- Shows configuration options upon reload.
- Warns the user if some configuration settings are invalid.
- Configurable cooldowns.
- A built-in reload command to update the config without having to restart the server.
- An option to change the name of the console.
- A special message when you hug the developer.
- An option to give players a reward for hugging the developer.
- The plugin's help page will tell you whether or not you have permission to use a command.
- A manual updater.
If you want more detailed information about each update, you can read about them here.

Here is a list of all of the registered commands that you can use. The next section has the permissions needed to use the commands!
- /hug <player> - Give a hug to a designated player
- /hugs - The base command for the plugin. It also shows plugin information.
- /hugs help - Shows the help page and all the available commands.
- /hugs total - Shows the total amount of hugs given.
- /hugs info <player> - Shows a player's Hug stats.
- /hugs reload - Reloads the config.yml

Here are all of the permissions you can give to your players or just keep to yourself. This list is here so that if you want players or perhaps one of your server ranks to be able to use these commands, they will be able to if they have them. Plus, you know, it's here for reference too.
- hugs.hug - Grants the permission to use /hug <player>
- hugs.hug.everyone - Grants the permission to use /hug *
- hugs.bypass.normal - Grants the permission to bypass normal hug cooldowns.
- hugs.bypass.mass - Grants the permission to bypass mass hug cooldowns.
- hugs.use - Grants the permission to use /hugs and /hugs help
- hugs.total - Grants the permission to use /hugs total
- hugs.info - Grants the permission to use /hugs info <player>
- hugs.update - Allows non-operators to receive the message for plugin updates.
- hugs.reload - Grants the permission to use /hugs reload
By default, OPs have all of these permissions.

This plugin requires that you give players permission to use the commands because, by default, no one has access to them... except OPs. Anyways, if you wish for your players or one of your server ranks to have the ability to hug people, then you will need to have a permissions manager. So here are some permission plugins that you could use.
- LuckPerms
- zPermissions
- PermissionsEx
- bPermissions
- GroupManager
Don't let that list limit you. Those are just some examples and you can use whatever permission plugin you desire, but make certain that you have one.

Screenshots
Modern Console Design and user-friendly information
Next Page functionality
Clickable commands
The indicator that you have permission to use a command.
What receiving a hug looks like.

More screenshots will come later down the line.

The plugin has PlaceholderAPI placeholders! To take advantage of these placeholders, simply use any plugin that supports PlaceholderAPI and use one of the placeholders listed below.
Available Placeholders:
- %hugs_total%: Grabs the total amount of hugs given.
- %hugs_player_total_given%: Grabs the player's total amount of hugs given.
- %hugs_player_total_received%: Grabs the player's total amount of hugs received.
- %hugs_player_total_mass_given%: Grabs the player's total amount of mass hugs given.
- %hugs_player_total_mass_received%: Grabs the player's total amount of mass hugs received.
You can download PlaceholderAPI here.
NOTE: The Hugs Plugin does not support the PlaceholderAPI library. This means that you cannot use other plugins placeholders in this plugin's config!

There are two methods you can use to update the plugin. Either one will work, but it's your decision on which method to use.
Method 1:
- Stop your server & put the Hugs (v2.0).jar file in your server's /plugins/ directory
- Start the server (The plugin will generate all necessary files)
- Edit the config.yml with your desired settings. (Remember to save it!)
- Edit the messages.yml with your desired messages. (Remember to save it!)
- Type "/hugs reload" on the server
- Done!
Method 2:
- If you have Plugman, put the Hugs (v2.0).jar file in your server's /plugins/ directory
- Type "/plugman load Hugs" in-game
- Edit the config.yml with your desired settings. (Remember to save it!)
- Edit the messages.yml with your desired messages. (Remember to save it!)
- Type "/hugs reload" on the server
- Enjoy!
If you don't have Plugman or don't know what Plugman is, you can download/find out more information about it here.
NOTE: If this is NOT your first time downloading this plugin, make sure to delete the Hugs folder in your /plugins/ directory. All updates have changed the config.yml and if you don't delete the old config, then the plugin won't work properly.

There are three files for this plugin. The config.yml, messages.yml, and data.yml. The config.yml is simple to use, just change the default settings to whatever you want and save the file. The same can be said for the messages.yml. Then type /hugs reload on the server and you're done. As for the data.yml, I recommend that you leave it be. Even though you can try and change it, it's just there to serve the purpose of counting hugs.
NOTE: With most plugins, if you reload a plugin using the built-in commands and you go back to the config.yml, a popup will appear saying that the config has been reloaded, do you wish to keep this in the editor. However, this is not the case with the Hugs plugin. The Hugs plugin is essentially in read-only mode, meaning that nothing is being written to the config.yml or messages.yml. So, if you make changes to the files and use the reload command, just know that it works and you can verify that by giving a hug. However, if you were to have the data.yml file open and someone gave someone else a hug and you went back to the data.yml, then the popup will appear because information is being written to the data.yml file.
config.yml
#
# Hugs - Developed by ShadowMasterGaming
#
# Enable update checking?
check_for_updates: true
# What language is native to your server?
language_file: en_US
# The method of storing plugin data.
# Valid settings include: yaml, yml, & MySQL.
# If an invalid storage setting is detected, the plugin will default to YAML files.
storage: yaml
#
# Normal Plugin Settings
#
settings:
# Force the usage of exact names when using the /hug command. Only applies to the /hug command.
force_exact_names: true
# Allow players to give themselves hugs?
allow_self_hugging: true
# Allow self hugs to count towards player data?
allow_self_hug_playerdata: true
# Allow players to give hugs by shift right clicking a player?
allow_shift_hugging: true
# Upon receiving a hug, restore the receiver's health back to 100%?
restore_player_health: false
# Upon receiving a hug, restore the receiver's hunger back to 100%?
restore_player_hunger: false
# Hug Message Settings
hug_messages:
enabled: true
# Broadcast Settings
broadcasts:
normal_hugs: true
mass_hugs: true
self_hugs: true
# Title Settings
titles:
enabled: true
# The interval settings for how titles appear. (In Seconds)
fade-in: 1
stay: 5
fade-out: 1
# The particle effect that will spawn around the receiver when they receive a hug.
# If the particle effect is invalid, you will receive a warning in the console. It won't break the plugin.
# This link will take you to a page with all of the available particle effects you can use: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
particles:
enabled: true
effect: HEART
# Allow for other players to see the particles?
# The particles will be spawned at the receiver's location and anyone nearby will be able to see them.
global: false
# The sound effect that will play at the receiver's location when they receive a hug.
# If the sound effect is invalid, you will receive a warning in the console. It won't break the plugin.
# This link will take you to a page with all of the available sound effects you can use: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
sounds:
enabled: true
sound: ENTITY_CAT_PURR
volume: 1
pitch: 1
# Allow for other players to hear the sounds?
# The sound will be played at the receiver's location and anyone nearby will be able to hear it.
global: false
# Cooldown Settings
cooldowns:
# The cooldown between hugs. (In Seconds)
normal_hugs: 5
# The cooldown between mass hugs. (In Seconds)
mass_hugs: 30
# If set to true, the time remaining will be displayed as a decimal. (E.G. 14.3 seconds remaining.)
use_exact_time: false
# Settings for commands that would benefit from confirmations. (E.G. /hugs admin purge <player>)
# If the GUI is not enabled, it will default to a text based confirmation.
confirmations:
enabled: true
use_gui: true
# Leaderboard settings.
# If the GUI is not enabled, it will default to a text based leaderboard.
leaderboard:
use_gui: true
# Players will receive one cookie when they hug the developer. :3
developer_reward: false
#
# The different verbose settings that you can change. This is to help keep track of things.
#
verbose:
# Settings for file logging. If enabled, all messages that would be sent to the console will be logged to a file.
file_logging: true
# Settings for console logging. If enabled, it will log stuff like who reloaded the config and who gave hugs.
console:
enabled: false
console_name: "Console"
# Settings for startup verbose.
# If both settings are set to true, the plugin will default to show_all_settings.
startup:
enabled: false
show_informative_settings: false
show_all_settings: false
show_hooks: true
# Settings for reload verbose.
# If both settings are set to true, the plugin will default to show_all_settings.
reloads:
enabled: false
show_informative_settings: false
show_all_settings: false
#
# The Experimental Settings
#
experimental_settings:
# Allow the receiver to have temporary invincibility after they are hugged?
temporary_invincibility:
enabled: false
effects:
fall_damage: true
pvp: true
# The duration of invincibility. (In seconds)
duration: 10
# Deny players from harming each other?
passive_mode:
enabled: false
message:
enabled: true
# The delay between the passive mode message being sent to the player. (In seconds)
delay: 10Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
26.2MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.9MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
4.7MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta