Axton's Emotes

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

Features

• Drag-and-drop play (Plugin does not require configuration changes to begin using).
• Easy emote configuration (Easily create custom emotes, or simply use the premade emotes).
• Simple permissions (Plugin permissions are designed to be easy to configure).
• Configurable emote radius (Minimum distance players must be from each other for shared emotes).
• Configurable emote cooldown (Prevent players from spamming emotes commands).

Installing the plugin

• Download: Get the latest '.jar' from the the releases tab tab, or from Modrinth.
• 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'.

Commands & Permissions

• View the Commands Guide
• View the Permissions Guide

Configuration

• View the Configuration Guide
• View the Emote Configuration Guide
• View the Supported Languages

axtonprice ✨




GPLv3 License
This project is licensed under the GNU General Public License version 3. View the project license here.

Author: @axtonprice



Changelog
- ️ Fixed `PlayerData.java` class overwriting storage files rather than appending. #39
- ✨ Added `/ae resetemotes` utility command to reset `emotes.yml` configuration file to plugin defaults. #35
- ✨ Added configurable minimum player distance limits for shared emote commands (configure in `config.yml`). #20
- ✨ Added configurable emote cooldown time in seconds (configure in `config.yml`). #19
- ✨ Updated all language key translations via Crowdin.

Full Changelog: https://github.com/axtonprice/axtons-emotes/compare/v1.5.0...v1.5.1

Author: @axtonprice




Changelog
- ️ Fixed Spigot servers not actually being supported due to overlooked presence of Paper dependencies. #17
- Improved support and handling for Minecraft 1.20+ servers (tested on Spigot, Paper, and Purpur upto 1.21.10). #9
- Refactored Configuration.java startup and validation methods.
- ✨ Added automatic smart configuration file migration for plugin version upgrades. #26
- Overhauled emote command handling to use emotes.yml configuration-based executions. #11
- ️ Fixed players always being able to see emotes in tab list menu, regardless of permissions. #22
- ✨ Added BStats.org anonymous metrics tracking (toggleable in config.yml). #25
- Moved command features from AxtonsEmotes.java to dedicated BaseCommands.java class.
- ✨ Added `/ae toggledebug` and `/ae togglemetrics` to toggle debug mode and BStats metrics tracking.
- ✨ Added `/ae resetlang` command to reset language files to plugin defaults.
- ✨ Added automatic version checking every 12 hours (if enabled in config.yml).
- Setup a private project on Crowdin to track translation progress & accuracy.
- Crowdin translation files have been moved into `/lang/translations`.
- Updated new translation keys across all language files.
- ✨ Added support for multiple new languages. View list.
- ✨ Added utility commands to permission group `axtonsemotes.admin` in config.yml.
- Removed the jumpscare feature (featured was not intended to remain long-term!)
- Plus many other code improvements and changes...

Credits
- CupOfSuoup for verifying Spanish translation keys in es.yml.
- Ashley for amending Polish translation keys in pl.yml.
- Mason for verifying German translation keys in de.yml.

Thank you to those who've externally contributed!

What's Next?
- Add PlaceholderAPI support to emote messages. #15
- Emote particle and sound effect version-based ENUM validation. #16
- Refactoring MessageHandler methods and usages. #18
- Command cooldown for emote executions. #19
- Shared emote block distance radius limits. #20
- Configurable action bar messages in emote messages. #23
- Standardize debugging log output formatting. #27
- Reset emotes.yml configuration utility command. #35

Full Changelog: https://github.com/axtonprice/axtons-emotes/compare/v1.4.0...v1.5.0

Author: axtonprice

• Added GitHub Development Branch dev
• Permissions Fix v2: Emote command permissions are now granted to non-ops by default.
• Enhancements:
  • Improved project-wide documentation.
  • Added `listenerCount` and `configsCount` variables to the plugin's `onEnable` message.
  • Added configurable messages and effects for plugin commands in `commands.yml`.
• Language Support: Issue #4
  • Added plugin-wide support for default and custom language files, configurable in `config.yml`.
  • Added default language options: `en` (English), `fr` (French), `es` (Spanish), `it` (Italian), `ru` (Russian).
• Command Handling:
  • Refactored command registration and execution handling.
  • Added custom command executors and handlers.
• New Commands:
  • Added `/guardianscare` jumpscare command.
  • Added `/ae version` command to check the plugin version.
  • Added implementation of `/emotes`, `/expressions`, and `/jumpscares`. Issue #1
• Version Checking:
  • Added automatic version checking on plugin startup and player join events. Issue #2
  • Added compatibility for development builds.
  • Added automatic configuration migration when the plugin is updated. Issue #3
• Debugging:
  • Created debugging class and methods for logging information for troubleshooting.
  • Added `debug-mode` configuration options to `config.yml`.
    • Added `enabled` option to toggle debugging.
    • Added `log-to-file` option to toggle writing debug logs to a file.
    • Added `debug-log` option to specify a file to log to.

Bukkit-v1.4.0-1.21 by axtonprice in Pull Request #6
Full Changelog: Compare v1.3.0...v1.4.0

Author: axtonprice

• Added GitHub Development Branch dev
• Permissions Fix v2: Emote command permissions are now granted to non-ops by default.
• Enhancements:
  • Improved project-wide documentation.
  • Added `listenerCount` and `configsCount` variables to the plugin's `onEnable` message.
  • Added configurable messages and effects for plugin commands in `commands.yml`.
• Language Support: Issue #4
  • Added plugin-wide support for default and custom language files, configurable in `config.yml`.
  • Added default language options: `en` (English), `fr` (French), `es` (Spanish), `it` (Italian), `ru` (Russian).
• Command Handling:
  • Refactored command registration and execution handling.
  • Added custom command executors and handlers.
• New Commands:
  • Added `/guardianscare` jumpscare command.
  • Added `/ae version` command to check the plugin version.
  • Added implementation of `/emotes`, `/expressions`, and `/jumpscares`. Issue #1
• Version Checking:
  • Added automatic version checking on plugin startup and player join events. Issue #2
  • Added compatibility for development builds.
  • Added automatic configuration migration when the plugin is updated. Issue #3
• Debugging:
  • Created debugging class and methods for logging information for troubleshooting.
  • Added `debug-mode` configuration options to `config.yml`.
    • Added `enabled` option to toggle debugging.
    • Added `log-to-file` option to toggle writing debug logs to a file.
    • Added `debug-log` option to specify a file to log to.

Bukkit-v1.4.0-1.21 by axtonprice in Pull Request #6
Full Changelog: Compare v1.3.0...v1.4.0

v1.3 Release
Author: @axtonprice
The first stable release of Axton's Emotes.
Key Updates:
- Refactored Emotes and Expression Commands:
- Introduced custom command handlers.
- Enhanced validation processes.
- New Feature:
- Added `/bog` jumpscare command.
- Bug Fixes:
- Corrected issues with permission handling due to malformed permission nodes.
- Implemented missing permission checks for the reload command.
- Command System Enhancements:
- Moved plugin command registry to a dedicated method.
- Added automatic command re-registration on plugin reload.
- Introduced a method to reset the command registry counter.
- Enabled command activation/deactivation via configuration.
- Merged the `/sulk` command with `/cry` as an alias.
- Documentation:
- Added comprehensive documentation for all key methods.
- And More...
Full Changelog: https://github.com/axtonprice/axtons-emotes/compare/v1.2...v1.3