MessageCommander

MessageCommnader

This executes a command when defined message found in chat-screen (and other source: chat-input, console-input, server log). It allows you to link commands to action performed by another plugin (when this plugin send to player a specified message).

This plugin is created according to requests at bukkit.org and rubukkit.org

Features

  • Execute command as player or server console when required message found in chat-screen;
  • Cooldown for executing the rule command;
  • Regex (and other types of string comparison) supported;
  • Using part (words) from original message in command to execute.

Why I need this plugin?

  • If you use a plugin and going to add new actions to it. For example plugin types a congratulation message but it not supports a reward. You can use this plugin to execute command and give money to your player.
  • If you need to turn chat message to commands. For example you need to type "please teleport me home" instead of "/home" :)
  • You need to handle servHow it works

How to use MessageCommander

MessageCommander uses multiple rule definition files. It's a "YAML" fie (*.yml) located in "MessageCommander/rules" folder. You can edit (or create new) this files manually. Every rule based on some parameters:

  • Type— defines the method which will used to determine text in message (before display it on screen). There are five types:
    • EQUAL — case insensitive compare (Example: "Aaaa Bbbb" will be equal to "aaaa bbbb")
    • CONTAINS — find substring in input-message
    • START — check if message starts with provided text
    • END — check if message ends with provided text
    • REGEX — using regular expression to find matches
  • source — you can link any rule to any source:
    • ALL — any source
    • CHAT_PLAYER — Message typed by player in chat
    • CHAT_CONSOLE — Message (command) typed in server console
    • CHAT_MESSAGE — Message received by player in chat (message could be sent by player, plugin, mod...)
    • LOG — message in log (by plugin). Don't forget this message will include plugin name prefix ("[MessageCommander]", for example).
  • message-mask — defines input mask, that will used to find matches in original message
  • command-line — defines the command line that will executed. Use placeholder %player% to point to players name.
  • execute-as-console — if "true" command (provided in command-line) will executed by server console.
  • cooldown-time — time defined in format similar to time format used in ReActions plugin. Cooldown used to set up time-limit executing commands using this rule.

Example:

test:
  type: EQUAL 
  source: ALL
  message-mask: help me
  command-line: say %player% need %word1%!
  execute-as-console: ture
  cooldown-time: 3s

Dependencies

This plugin requires ProtocoLib installed on your server.

Commands and Permissions

There's no command or permissions yet.

Update checker

MessageCommander includes a update checker that use your server internet connection. Update checker will every hour check the dev.bukkit.org to find new released version of plugin and you can easy disable it: just set parameter "check-updates" to "false" in config.yml.


Comments

Posts Quoted:
Reply
Clear All Quotes

About This Project

Categories

Members

Recent Files