What is it?
Keywords is a fully customizable plugin that allows server operators to set certain keywords to emotes through a configuration file. Emotes can be used in all places that involve typing! The plugin is very simple to use, and includes a straightforward usage tutorial located in the config file. Your customization options are near limitless, so go wild!
Showcase:
Fancy Features:
- HEX code support for all customizable options in config file
- Standard color code support for all customizable options in config file
- No ugly unchangeable prefixes
- Limitless keywords/emotes for chat, books, signs, and even items!
- Command to apply config changes without server restarts
Commands:
- /keywords list - Allows the user to view all keywords/emotes
- /keywords reload - Reloads the plugin's config file to apply all new changes
-/keywords conversions - Allows the user to view the status of all keyword conversions
Permissions:
- keywords.user.* - All user permissions
- keywords.user.list - Allows the user to run the '/keywords list' command
- keywords.user.keywords - Allows the user to use keywords in chat
- keywords.admin.* - All operator permissions
- keywords.admin.reload - Allows the operator to reload the configuration file without a server restart
- keywords.admin.conversions - Allows the operator to view the enabled/disabled keyword conversions through an in-game command
Configuration:
Code (YAML):
# Here is where you can add your own custom emotes for custom keywords.
# Simply specify the keyword you wish to use on the SAME INDENTATION LINE as the examples below, followed by a colon,
# then paste your emote.
# Always include QUOTATION MARKS around your emotes and keywords to prevent print errors when using codes
# IMPORTANT NOTE: Usage of color codes and HEX codes is supported
keywords:
':bear:'
: '
#123456ʕ &4•ᴥ•#123456ʔ'
'!happy'
: '&e◉‿◉'
'@sad'
: '&b
(︶︹︺
)'
# Below are player interactions that involve typing. To enable/disable keyword conversion into emotes, simply specify either true or false
# (By default all are set to true)
public-chat
: true
item-renaming
: true
book-editing
: true
sign-editing
: true
# Below is the error that will be sent to users when they attempt to run plugin commands without sufficient permissions.
# For no message, set the text to ''
cmd-permission-error
: '&4You do not have permission to run that command!'
# Below is the text that appears above and below the list of keywords/emotes when the '/keywords' command is executed.
# For no message, set the text to ''
list-cmd-topln
: '&aList of Emotes and Keywords:'
list-cmd-bottomln
: '&aClick to use!'
# Below is the text that appears in the keywords help page, accessed through invalid cmd usage
# For no message, set the text to ''
help-cmd-topln
: '&aInvalid Command! View valid commands here:'
# Bottom line is parameterized with an integer value (%d) that corresponds to the amount of commands the player has access to.
# To use this value, simply place '%d' in the string anywhere! For no message, set the text to ''
help-cmd-bottomln
: '&7You have access to
%d keyword commands'
# The commands that display are formatted in the below parameterized string with 3 string values (%1$s, %2$s, %$s).
# %1$s = '/keywords', %2$s = Command Arguments, %3$s = Command Description
# Changing anything besides the colors is not recommended if you are unfamiliar with parameterized strings, but play around with it!
# For no cmd help messages, set text to '' (although I'm not sure why you would want to do that)
help-cmd-cmds
: '&7- &a
%1$s %2$s &7|| %3$s'
Found a bug? Want to leave a suggestion?
Feel free to send all bug reports and suggestions to
crypt#3593 and I'll respond as soon as I possibly can. All suggestions are appreciated, and bugs will be ironed out quickly. Thanks, and enjoy!