Chat Tools

🔖Help Needed🔖

• New Translations
• New Web Machine Translators

Feel free to make a PR on Github.

📋 Overview

Chat Tools is a highly customizable Minecraft client mod that supports various features, allowing them to interoperate through commands and more.

📖 Glossary and Technical Details

• Session Identifier (Chat Tools-specific term) is a string that, in single-player mode, corresponds to the current save name, and in multiplayer mode, corresponds to the server address. Related Regular Expressions use the matches() method for matching.
• Pattern (General term) refers to the Regular Expression pattern. Chat Tools uses the MULTILINE mode for Regular Expressions and matches them using the find() method.
• Chat Tools maintains multi versions by using macro replacement. The same version of Chat Tools may exhibit slight differences between Minecraft versions.
• When processing player messages, Chat Tools removes color codes (§.).
• By enabling Advanced Tooltips (F3+H), you can hover over configuration items on the configuration page to view their keys, default values, and other details.

🛠️ Commands

• /chattools on – Enable the mod.
• /chattools off – Disable the mod.
• /chattools opengui – Open the configuration page.
• /chattools download – Download addons.
• /chattools regex_checker <pattern> [<test_content>] – Without test content: check if the pattern is a valid regex. With test content: validate the pattern and test if it matches the content.
• /chattools send_to_client text <text_JSON_component> – Send specific text to the client chat bar.
• /chattools send_to_client actionbar <text_JSON_component> – Display specific text on the client actionbar.
• /chattools config openfile – Open the configuration file (editing requires a game restart to apply changes).
• /chattools config get <key> – Retrieve the value of a specific configuration key for the current session.
• /chattools config set <key> <value> [<save>] – Set the value of a specific configuration key. If save is set to true, the changes will also be saved to the file.
• /chattools config toggle <key> [<save>] – Toggle the state of a boolean-type configuration key. If save is set to true, the changes will also be saved to the file.

✨ Function introduction

For elaborate descriptions and examples, please see >>FAQ<<.

General Settings

These are the core settings for Chat Tools:

• Show Timestamp \
  Adds a timestamp to each message.\
  
• Restore Messages \
  Recovers messages from previous sessions.
• Nickname Hider \
  Conceals your real nickname from your view.\
  
• Translator
  Press Shift + Tab in the chat bar to start translating.
• Enable Chat History Navigator
  Use Ctrl + F to start navigating in chat!
  
• Max History Length\
  Sets the maximum number of chat messages stored.\
  

Notifier Settings

Various chat alert features:

• Toast Notification\
  
• Sound\
  Supports custom sound effects.
• Actionbar\
  Displays alerts in the action bar.
• Highlight\
  Supports custom highlighting prefixes.\
  
• Allow List\
  Messages matching this list are allowed.
• Ban List\
  Messages matching this list are blocked (higher priority than Allow List).

Formatter Settings

Customize your messages using specified patterns. Apply different rules for different servers. See Bubble Rules.

• Pattern\
  Automatically formats messages based on the specified style.\
  For example: \
  &e{text} makes your message gold on servers supporting the color prefix ‘&’.\
  &e{text} ~(ovo)~ adds a personalized suffix.\
  My coordinates are: {pos} replaces {pos} with your current coordinates.
• Auto-Disable for Matching…\
  In some cases, you don’t want your text to be formatted. \
  This includes (but isn’t limited to):\
  Item counts or all when selling items to the Chest Shop; \
  Commands starting with special characters. \
  The default RegEx pattern ^\d+$|^[.#%$/].*|\ball\b covers most cases.\
  You can modify or add more as needed.

Chat Keybindings

Use hotkeys for frequently used commands:

• Trigger Last Command Hotkey\
  Press a set hotkey to repeat the previous command.\
  For example: \
  While playing a Parkour map, do F3+C and activate it for a time, then you can quickly go back to the recorded point location every time you press the hotkey.
• Command Keybindings\
  Assign hotkeys to frequently used commands.\
  

Bubble Settings

• Enable Chat Bubbles\
  Displays a chat bubble over your head.\
  
• Bubble Rules\
  Apply different bubble rules on different servers.\
  

Responder Settings

> Warning: Before using this feature on a server, please check with other players and admins first!

• Enable Responder\
  Automatically responds to others’ messages.
• Responder Rules\
  Apply different responder rules on different servers.

Chat Filter Settings

• Enable Chat Filter\
  Filter chat messages based on specific rules.
• Filter Rules\
  If any of the patterns in this list matches an incoming message, the message will be filtered.