> For the complete documentation index, see [llms.txt](https://chat.advancedplugins.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chat.advancedplugins.net/features/chat-text-customizer.md).

# Chat Text Customizer

Elevate your server's chat experience with the Chat Text Customizer. This tool surpasses the conventional limitations of plugins and Minecraft itself, offering unparalleled flexibility in message display customization. Whether you aim to modify messages from various plugins or Minecraft's default communications, this customizer facilitates seamless edits, ensuring your chat environment is uniquely yours.

## Key Features

* **Full Compatibility**: Works with messages from any source, be it Minecraft or third-party plugins.
* **Advanced Editing**: Supports gradients, PlaceholderAPI, and more, for dynamic and vibrant chat messages.
* **Versatile Matching**: Utilizes different matching strategies (EQUALS, STARTS\_WITH, ENDS\_WITH, CONTAINS, REGEX) to accurately identify and modify messages.
* **ProtocolLib Requirement**: Ensure you have **ProtocolLib** installed to utilize this feature. You can learn how to add ProtocolLib to your server here: [First Install](/first-install.md#step-1-installing-the-plugin)

## Configuration Overview

### Message Customization

Customize any chat message leveraging extensive editing capabilities. The customization process involves identifying the target message and applying the desired modifications.

### **Identifying Messages**

Use `findType` to specify how to match the message you intend to replace. This could be an exact match, a prefix, suffix, substring, or a regular expression for complex patterns.

### **Example: Customizing the "Unknown Command" Message**

```yaml
unknownCommand:
  findType: EQUALS
  find: '&fUnknown command. Type "/help" for help.'
  replace:
    0:
      from: '&fUnknown command. Type "/help" for help.'
      to: '&cYou''ve typed an unknown command! Type "/help" for help or use "/discord" to join our Discord server!'
```

This example demonstrates how to replace the default "unknown command" message with a more informative and engaging one.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chat.advancedplugins.net/features/chat-text-customizer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.