🔖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.