Axton's Emotes - Speedgot

Axton's Emotes -----

A light-weight, configurable chat emotes plugin for 1.20+ Spigot/Paper servers.

Download Now
113.9 KB .jar

Axton's Emotes

A light-weight, configurable chat emotes plugin for 1.20+ Spigot/Paper servers.

Click to expand...

Available in 10+ languages, including Spanish, French, Italian, German.. See the full list on the wiki.

Installing the Plugin

Download: Get the latest .jar from the Updates tab.
Deploy: Place the .jar in your server's 'plugins/' folder.
Restart: Restart your server. PaperMC is recommended for optimal performance.
Configure: Modify config.yml to your liking, then reload the plugin with '/ae reload'.
Verify: Check you are running the latest version by using '/ae version'.

Note: Java 17 or higher is required to run this plugin. Please refer to the wiki for more details on installation requirements.

Emote Types

✨ Shared Emotes
Interact with other players with targeted emotes that involve another user.

✨ Expression Emotes
Express yourself to the entire server - these emotes are broadcast to everyone and do not target a player.

Examples of Built-in Emotes

Shared Emotes	Expression Emotes
/e hug <player>	/e cry
/e poke <player>	/e laugh
/e highfive <player>	/e wave
/e kiss <player>	/e gasp
/e slap <player>	/e shrug
/e stare <player>	/e facepalm
/e thank <player>	/e cheer
/e applaud <player>	/e bow

Permissions for all emotes are granted by default unless an emote is disabled or the user is explicitly denied permission to 'axtonsemotes.emotes.use'.

Commands & Permissions
Please refer to the wiki for more details on commands & permission nodes.

Command	Description	Permission Node
/emote, /e	Execute an emote command	axtonsemotes.emotes.use (Default: true)
/emotes	List all emotes available to the player.	axtonsemotes.emotes.list (Default: true)
/toggleemotes	Toggles shared emotes individually, disallowing shared emote commands to be used on or by that player.	axtonsemotes.emotes.selftoggle (Default: true)
/ae reload	Reload the plugin configuration.	axtonsemotes.admin.reload (Default: op)
/ae version	Check the plugin's current version and the latest release.	axtonsemotes.admin.version (Default: op)
/ae toggledebug	Toggles debug mode and will show detailed logs of command plugin executions.	axtonsemotes.admin.toggledebug (Default: op)
/ae togglemetrics	Toggles BStats anonymous metrics tracking.	axtonsemotes.admin.togglemetrics (Default: op)
/ae resetlang	Resets language configuration files to the plugin defaults.	axtonsemotes.admin.resetlang (Default: op)
/ae resetemotes	Resets emote.yml configuration to the plugin defaults.	axtonsemotes.admin.resetemotes (Default: op)
/ae help	Provides link to the plugin documentation.	axtonsemotes.admin.help (Default: op)
-	Notify administrator of plugin updates when they join.	axtonsemotes.admin.updatenotify (Default: op)
-	Allows players to use /emotes, even if the feature is disabled in the config.	axtonsemotes.admin.list-override (Default: op)
-	Allows players to bypass the minimum block distance configured for shared emotes.	axtonsemotes.admin.bypassradius (Default: op)
-	Allows players to bypass the radius limit configured for shared emotes.	axtonsemotes.admin.bypasscooldown (Default: op)

Configuration
To configure the plugin, edit the config.yml file in the 'AxtonsEmotes' plugin folder.

After updating the configuration, reload it with '/ae reload' (requires the 'axtonsemotes.admin.reload' permission).

Code (YAML):

# >> Language
# Sets the language used for in-game plugin messages.
# For a full list of available languages, please refer to https://github.com/axtonprice/axtons-emotes/wiki/Languages
language : en

# >> Self-Executions
# Allows players to execute emote commands on themselves.
# Default: true
allow-self-executions : false

# >> List Commands
# Enables the /emotes and /expressions commands to view permitted emotes. When enabled, anyone can list commands.
# When disabled, only server operators or players with the 'axtonsemotes.admin.list-override' permission can list commands.
# Default: true
allow-list-commands : true

# >> Shared Emotes Toggle
# Allows players to use /toggleemotes, removing the ability for others to execute shared emotes on them.
# If both below are enabled, the player must have the 'axtonsemotes.emotes.selftoggle' permission to run the toggle command.
allow-self-toggle :
# Default: true
enabled : true
# Default: false
require-permission : false

# >> Shared Emote Radius
# Sets the minimum distance (in blocks) required between the sender and target player to execute shared emotes.
# Players with axtonsemotes.admin.bypassradius permission can bypass the configured radius limit below.
emote-radius :
# Default: true
enabled : true
# Default: 5
distance : 5

# >> Emote Cooldown
# Sets a cooldown period (in seconds) between emote executions per player.
# Players with axtonsemotes.admin.bypasscooldown permission can bypass the configured cooldown below.
emote-cooldown :
# Default: true
enabled : true
# Default: 3 (seconds)
duration-seconds : 3

# >> Default Effects
# Specifies the default particle and sound effects if the specified enum constant is invalid (NOT if the effect is set to 'none').
# Defaults: CRIT, ENTITY_ITEM_PICKUP
default-effects:
particle : "CRIT"
sound : "ENTITY_ITEM_PICKUP"

# Configure debug mode, which logs detailed information about command executions. This is useful
# for troubleshooting but will result in many console messages.
debug-mode :
# Toggles additional console information during startup and command executions.
# Default: false
enabled : false

# Specify whether to log debug messages to a file. Ignored if 'enabled' above is set to false.
# Default: true
log-to-file : true

# Specifies the name of the file which debug logs are saved to. Set to none to disable logging to a file.
# Default: debug.log
file-name : "debug.log"

# >> Plugin Versioning & Updates
# Configure update checks and notifications:
updates :
# Automatically checks for plugin updates every 12 hours and on server startup.
# Default: true
check-for-latest : true

# Notifies players with the axtonsemotes.admin.updatenotify permission when a newer version is available.
# Default: true
notify-players-on-update : true

# >> Metrics Tracking
# Enables BStats anonymous metrics tracking. Learn more at https://bstats.org/
# Default: true
enable-metrics : true

Emote Configuration
Below is an example of how to configure an expression and a shared emote command in the emotes.yml file.

Code (YAML):

commands:
cry:
enabled : true
type : "expression"
messages:
player : "&7You cry yourself in sorrow..."
target : "&7&l%player%&r&7 cries in a corner..."
effects:
particle : "NONE"
sound : "ENTITY_CAT_HURT"

hug:
enabled : true
type : "shared"
messages:
player : "&cYou hugged &l%target%&r&c!"
target : "&c&l%player%&r&c hugged you!"
effects:
particle : "HEART"
sound : "ENTITY_CAT_PURR"

axtonprice ✨