KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

ChatPatches

★ 64 Open GitHub ↗

A Minecraft client-side mod that touches up Minecraft's mundane chat, with configurability in mind!

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Fabric Mod](https://img.shields.io/badge/modloader-fabric-eeeeee)](https://fabricmc.net/use/)
[![Latest Version](https://img.shields.io/modrinth/v/MOqt4Z5n?color=blueviolet&label=latest%20version)](https://modrinth.com/mod/MOqt4Z5n)

[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fmrbuilder1961%2FChatPatches%2Fbadge%3Fref%3Domnivers&style=flat)](https://actions-badge.atrox.dev/mrbuilder1961/ChatPatches/goto?ref=omnivers)
![GitHub code size](https://img.shields.io/github/languages/code-size/mrbuilder1961/ChatPatches)

[![Curseforge Download](https://cf.way2muchnoise.eu/full_560042_downloads.svg)](https://www.curseforge.com/minecraft/mc-mods/chatpatches)
[![Modrinth Download](https://img.shields.io/badge/dynamic/json?&color=242629&labelColor=5ca424&label=&suffix=%20downloads&query=downloads&url=https://api.modrinth.com/v2/project/MOqt4Z5n&cacheSeconds=3600&logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjwhRE9DVFlQRSBzdmcgUFVCTElDICItLy9XM0MvL0RURCBTVkcgMS4xLy9FTiIgImh0dHA6Ly93d3cudzMub3JnL0dyYXBoaWNzL1NWRy8xLjEvRFREL3N2ZzExLmR0ZCI+Cjxzdmcgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgdmlld0JveD0iMCAwIDUxMiA1MTQiIHZlcnNpb249IjEuMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSIgeG1sbnM6c2VyaWY9Imh0dHA6Ly93d3cuc2VyaWYuY29tLyIgc3R5bGU9ImZpbGwtcnVsZTpldmVub2RkO2NsaXAtcnVsZTpldmVub2RkO3N0cm9rZS1saW5lam9pbjpyb3VuZDtzdHJva2UtbWl0ZXJsaW1pdDoyOyI+CiAgICA8Zz4KICAgICAgICA8ZyBpZD0ibW9kcmludGgiPgogICAgICAgICAgICA8cGF0aCBkPSJNNTAzLjE2LDMyMy41NkM1MTQuNTUsMjgxLjQ3IDUxNS4zMiwyMzUuOTEgNTAzLjIsMTkwLjc2QzQ2Ni41Nyw1NC4yMyAzMjYuMDQsLTI2LjggMTg5LjMzLDkuNzhDODMuODEsMzguMDIgMTEuMzksMTI4LjA3IDAuNjksMjMwLjQ3TDQzLjk5LDIzMC40N0M1NC4yOSwxNDcuMzMgMTEzLjc0LDc0LjczIDE5OS43NSw1MS43MUMzMDYuMDUsMjMuMjYgNDE1LjEzLDgwLjY3IDQ1My4xNywxODEuMzhMNDExLjAzLDE5Mi42NUMzOTEuNjQsMTQ1LjggMzUyLjU3LDExMS40NSAzMDYuMyw5Ni44MkwyOTguNTYsMTQwLjY2QzMzNS4wOSwxNTQuMTMgMzY0LjcyLDE4NC41IDM3NS41NiwyMjQuOTFDMzkxLjM2LDI4My44IDM2MS45NCwzNDQuMTQgMzA4LjU2LDM2OS4xN0wzMjAuMDksNDEyLjE2QzM5MC4yNSwzODMuMjEgNDMyLjQsMzEwLjMgNDIyLjQzLDIzNS4xNEw0NjQuNDEsMjIzLjkxQzQ2OC45MSwyNTIuNjIgNDY3LjM1LDI4MS4xNiA0NjAuNTUsMzA4LjA3TDUwMy4xNiwzMjMuNTZaIiBzdHlsZT0iZmlsbDpyZ2IoMjMsMjMsMjUpOyIvPgogICAgICAgICAgICA8cGF0aCBkPSJNMzIxLjk5LDUwNC4yMkMxODUuMjcsNTQwLjggNDQuNzUsNDU5Ljc3IDguMTEsMzIzLjI0QzMuODQsMzA3LjMxIDEuMTcsMjkxLjMzIDAsMjc1LjQ2TDQzLjI3LDI3NS40NkM0NC4zNiwyODcuMzcgNDYuNDcsMjk5LjM1IDQ5LjY4LDMxMS4yOUM1My4wNCwzMjMuOCA1Ny40NSwzMzUuNzUgNjIuNzksMzQ3LjA3TDEwMS4zOCwzMjMuOTJDOTguMTMsMzE2LjQyIDk1LjM5LDMwOC42IDkzLjIxLDMwMC40N0M2OS4xNywyMTAuODcgMTIyLjQxLDExOC43NyAyMTIuMTMsOTQuNzZDMjI5LjEzLDkwLjIxIDI0Ni4yMyw4OC40NCAyNjIuOTMsODkuMTVMMjU1LjE5LDEzM0MyNDQuNzMsMTMzLjA1IDIzNC4xMSwxMzQuNDIgMjIzLjUzLDEzNy4yNUMxNTcuMzEsMTU0Ljk4IDExOC4wMSwyMjIuOTUgMTM1Ljc1LDI4OS4wOUMxMzYuODUsMjkzLjE2IDEzOC4xMywyOTcuMTMgMTM5LjU5LDMwMC45OUwxODguOTQsMjcxLjM4TDE3NC4wNywyMzEuOTVMMjIwLjY3LDE4NC4wOEwyNzkuNTcsMTcxLjM5TDI5Ni42MiwxOTIuMzhMMjY5LjQ3LDIxOS44OEwyNDUuNzksMjI3LjMzTDIyOC44NywyNDQuNzJMMjM3LjE2LDI2Ny43OUMyMzcuMTYsMjY3Ljc5IDI1My45NSwyODUuNjMgMjUzLjk4LDI4NS42NEwyNzcuNywyNzkuMzNMMjk0LjU4LDI2MC43OUwzMzEuNDQsMjQ5LjEyTDM0Mi40MiwyNzMuODJMMzA0LjM5LDMyMC40NUwyNDAuNjYsMzQwLjYzTDIxMi4wOCwzMDguODFMMTYyLjI2LDMzOC43QzE4Ny44LDM2Ny43OCAyMjYuMiwzODMuOTMgMjY2LjAxLDM4MC41NkwyNzcuNTQsNDIzLjU1QzIxOC4xMyw0MzEuNDEgMTYwLjEsNDA2LjgyIDEyNC4wNSwzNjEuNjRMODUuNjQsMzg0LjY4QzEzNi4yNSw0NTEuMTcgMjIzLjg0LDQ4NC4xMSAzMDkuNjEsNDYxLjE2QzM3MS4zNSw0NDQuNjQgNDE5LjQsNDAyLjU2IDQ0NS40MiwzNDkuMzhMNDg4LjA2LDM2NC44OEM0NTcuMTcsNDMxLjE2IDM5OC4yMiw0ODMuODIgMzIxLjk5LDUwNC4yMloiIHN0eWxlPSJmaWxsOnJnYigyMywyMywyNSk7ZmlsbC1ydWxlOm5vbnplcm87Ii8+CiAgICAgICAgPC9nPgogICAgPC9nPgo8L3N2Zz4K)](https://www.modrinth.com/mod/MOqt4Z5n)
[![Join the Discord Server!](https://img.shields.io/discord/1077285607375638529?color=6262df&label=discord%20)](https://discord.gg/3MqBvNEyMz)
# Chat Patches
### Requires [Yet Another Config Lib](https://modrinth.com/mod/yacl/versions?l=fabric&c=release) and a menu mod (see below) for 1.19.2+

A Minecraft client-side mod that touches up Minecraft's mundane chat, with configurability in mind!

It's most significant features include (but are not limited to):
- Increasing the maximum amount of chat messages from 100 to 16,384
- Adding a timestamp in front of all messages, formatted as `[HOUR:MINUTE:SECOND]` in pink text, with a tooltip that renders a complete date
- Keeping chat history and previously sent messages across ALL worlds and servers
- Allowing logging chat messages for restoring them later in future Minecraft sessions
- Letting you modify vanilla player names to anything you want (ex. without the triangle brackets!)
- Minimizing spam with a counter that shows how many duplicate messages have been sent in a row
- Shifting the chat hud up by 10 pixels, so it doesn't overlap with the armor bar
- Providing a menu to copy specific data (and the text of course!) from chat messages
- Letting you search through all received messages with a search bar
- YOU being able to toggle any of these features and MORE!

Many of these features were adopted or inspired from the following existing mods:
- [More Chat History](https://www.curseforge.com/minecraft/mc-mods/more-chat-history)
- [When Was That Again](https://www.curseforge.com/minecraft/mc-mods/wwta)
- [Don't Clear Chat History](https://www.curseforge.com/minecraft/mc-mods/dont-clear-chat-history)
- [No Angled Brackets](https://www.curseforge.com/minecraft/mc-mods/no-angled-brackets)
- [Clear Spam](https://www.curseforge.com/minecraft/mc-mods/clearspam)
- [Chat Up!](https://www.curseforge.com/minecraft/mc-mods/chat-up)
- [Compact Chat](https://modrinth.com/mod/compact-chat)

## FAQ
- What Minecraft version can I use this with?
  - Currently, all recent Fabric versions have releases; however, only widely-used versions are going to be maintained going forward.
- Will you make it for (older Minecraft version)?
  - No. If Minecraft's codebase allows for it, I'll consider making a release that would support a wide range of versions, but if it's too difficult then I 
    won't bother as almost nobody plays those versions anymore.
- Will you make this for Forge or NeoForge?
  - Yes to NeoForge, but I need to cross some more important things off the agenda first. Maybe to Forge, but it's unlikely given 1.20.1 is already 3 years old.
- I found a bug/issue, what do I do?
  - First, make sure you're on the latest version of Chat Patches for your Minecraft version. If it doesn't go away, you can click on the Issues tab on this 
    page, and if it hasn't been reported yet, you can create a new report! **FILL OUT THE ENTIRE REPORT.**
- It says I need to install Fabric, but I already have it installed?
  - [Install the Fabric API.](https://modrinth.com/mod/fabric-api)
- Do servers need this mod?
  - Nope! It's entirely client-side (it won't do anything if installed on the server).
- I can't access the config menu in-game!
  - <u>For 1.19.2+:</u>
    - Installing either [Mod Menu](https://modrinth.com/mod/modmenu/versions) or [Catalogue](https://www.curseforge.com/minecraft/mc-mods/catalogue-fabric) with [Menulogue](https://www.curseforge.com/minecraft/mc-mods/menulogue) will allow you to edit the config in-game!
    - Otherwise, if you still cannot access the config, [open an issue on GitHub](https://github.com/mrbuilder1961/ChatPatches/issues/new/choose), and 
      provide any logged errors if they exist.
  - <u>For 1.18.x:</u> You need the latest versions of both [Cloth Config](https://modrinth.com/mod/cloth-config/versions?l=fabric&c=release) and [Mod Menu](https://modrinth.com/mod/modmenu/versions?l=fabric&c=release).
  - Regardless of Minecraft version, you can **always** edit the config at `(directory)/config/chatpatches.json`.
- How do I enable/disable/change X feature?
  1. Open the config menu. How you do this depends on the menu mod(s) you have installed, but it typically involves **<kbd>Esc</kbd> -> Mods -> Chat Patches -> 3 sliders/Config button** !
  2. Look through each category and see if the option is there - make sure to read the descriptions.
  3. If you still can't find it, scroll down on this page and see if it's listed in the option table. Note this refers to the latest version.
  4. If it's not in any of those, then check on the [suggestion page](https://github.com/mrbuilder1961/ChatPatches/issues?q=is%3Aissue%20state%3Aopen%20label%3Asuggestion); chances are someone already suggested your idea.
  5. Finally, it's not in the mod yet, so open a suggestion!
- My config is broken/not working!
  - When you load one of the more recent mod versions, it makes a creates a new file with your old settings and resets the main file. You can access this
    copy at `(directory)/config/chatpatches_old.json`. By then opening both the new and old configs at the same time, you can copy and paste over the values.
    Make sure the settings have correct inputs (ex. `time` should be `true`/`false` not `123` or `"true"`).
  - If you still are having problems, open a new issue on GitHub.
- Can I use this in a modpack?
  - Yes, as long as you credit me and/or link back to one of the official pages ([GitHub](https://github.com/mrbuilder1961/ChatPatches), [Modrinth](https://modrinth.com/mod/chatpatches/versions), and [CurseForge](https://www.curseforge.com/minecraft/mc-mods/chatpatches)).
- Can I re-upload this mod elsewhere?
  - No, unless you have explicit permission from me (OBro1961), modify the mod in an undisputable way, or any download links used direct to one of the official 
    pages (see above). If you're unsure, message me on Discord (@obro1961) about it.
- How do I do XYZ?
  - If the answer you're looking for isn't anywhere here or in the config, check the **#Help** section located below.
  - If you still can't find it, ask in the [Discord](https://discord.gg/3MqBvNEyMz)!

## Setup devenv / Build latest jars
1. Download the latest ZIP (this page -> Code -> Download ZIP)
2. Extract it to your desired folder
3. Open a terminal/command prompt, then run `./gradlew build` (to build and collect jars for every Minecraft version, run `./gradlew collectAll`)
4. [For a devenv]: open the folder in your IDE
5. [For built jars]: navigate to `/versions/<version>/build/libs/` (or `/build/libs/` if you ran `collectAll`)

## Localization and Translation
If you would like to help translate Chat Patches into other languages, you can:
- [Create a pull request](https://github.com/mrbuilder1961/ChatPatches/compare) that adds, corrects, or updates a language file *(preferred)*
  - If you do this, please feel free to add yourself to the credits list in `gradle.properties`! Just make sure to follow the pattern.
- DM me on Discord (@obro1961)

Once you contribute, [join the Discord server](https://discord.gg/3MqBvNEyMz) so you can receive your complementary Contributor and Translator roles!
(Or join for extra info and status updates!)

## License
This mod is available under [GNU LGPLv3](https://choosealicense.com/licenses/lgpl-3.0/) as a legal [compromise](https://thisvsthat.io/gpl-vs-lgpl)
between GPL (my ideal choice) and Minecraft as a product.

Despite this not being noted in the license, the following details and restrictions apply to all versions and forks of this project ("The 
Software") and its derivatives:

1. The Software must list or credit the developer(s) and contributor(s) in a **clear and accessible manner**.
2. The Software and any modifications made to it **may not** be used for the purpose of training or improving machine learning algorithms,
including but not limited to artificial intelligence, natural language processing, or data mining. This condition applies to any derivatives,
modifications, or updates based on the Software code. Any usage of the Software in a training dataset is considered a breach of this License.
3. The Software may not be included in any dataset used for training or improving machine learning algorithms, including but not limited to 
artificial intelligence, natural language processing, or data mining.

I am working to find a license that includes these terms in them intrinsically, but for now this is the best option to avoid creating a custom, niche license.

## Help

### How to upload log files [log-info]
There are multiple different types of log file that can be uploaded, all located in `(directory)/logs/`. In order of most useful to least:
1. `latest.log` - The main log file that is generated every time the game is run. I personally consider it the most useful because it often contains some information
   about what was going on before the issue or crash occurred.
2. `crash-report-<date>-<time>.txt` - Generated when the game crashes. It contains a lot of extra information not provided in the other logs, but it typically lacks 
   context of what happened before the crash.
3. `debug.log` - Generated when the game is configured to output on the `DEBUG` level. It isn't always present, but it is extremely verbose and contains tons of extra
   information, albeit at the cost of a LOT of bloat. Although this log can have more relevant information than the `latest.log`, it often just takes up more space.

Generally, you should upload one `.log` file and one `crash-report-<date>-<time>.txt` file. If you need more help, feel free to ask!

Now that you have the files, simply submitting them to https://mclo.gs/ will give you a link that you can share with me and others to help diagnose your issue.
It is really the only site I use, because it provides a lot of useful tools both for me and for you. One of those being that it censors many instances of
potentially identifiable information, such as your computer's username and IP address, and it allows filtering errors and warnings!

#### To upload the log(s) without Prism Launcher: [log-upload]
1. Go to https://mclo.gs/
2. Click the "Select a file" button, and select a file. **OR** Paste the contents of the log file into the text box.
3. Click the "Save" button.
4. Wait for a moment, and it will redirect you to your uploaded log file. Copy the URL from the address bar and paste it wherever you were asked or need to
   share it.

#### With Prism Launcher: [log-upload-prism]
1. Open Prism Launcher.
2. Click on your instance that contains the log you want to upload.
3. Navigate to the "Minecraft Log" tab (or "Other logs" tab if it's not there)
4. Click the "Upload" button when the log you want to upload is shown.
5. Click the "Yes" button in response to the security prompt. If you're worried about the security of the log, you can always censor it yourself before
   uploading it.
6. The log should now be uploaded, and you can click the blue underlined text to view it in your browser. The URL is automatically copied to your clipboard,
   so you can now share it wherever you were asked or need to.

### How to access beta releases [beta-install]
To access beta releases, you'll need a link that looks like this:

https://github.com/mrbuilder1961/ChatPatches/actions/runs/1234567890/ or

https://github.com/mrbuilder1961/ChatPatches/actions/runs/1234567890/artifacts/0987654321

#### Now, follow these steps:
1. Click on the link. If it doesn't instantly download, scroll down, and under the "Artifacts" section, click on "jars" and the download should start. If the text isn't clickable, make sure you're logged in to GitHub. Otherwise, click on `build` -> `ubuntu-latest` (if multiple runs are present) -> `capture build artifacts`; the last line should have a download link
2. Once the download is complete, open or extract the .zip file.
3. You should see one folder: `libs`. Open it.
4. Inside, you should see multiple `.jar` files for different Minecraft versions.
5. Move the file applicable to your version to your `mods` folder. If your specific version is not present but a newer one is, use that one
   (ex. you need 1.21.2, but only 1.21.1 and 1.21.4 are present, so use 1.21.4)
6. If you have another version of Chat Patches already installed, you can move it, rename the file extension to anything but `.jar`, or delete it.
7. You're good to go! Launching the game should now load the beta version. If you experience any issues, make sure to report them as soon as
   possible wherever you were given the link (here on GitHub or [the Discord](https://discord.gg/3MqBvNEyMz)).

### How to find mod(s) causing compatibility issues [binary-search]
*(taken from the Fabric Discord bot, not written by me!)*

> A binary search can be used to quickly find a specific mod causing trouble, which can be especially useful when logs don't give a conclusive answer to your issue.

> Start by removing or disabling half of your mods, then test if the problem still occurs. If it does, remove half of the remaining mods and test again. If it doesn't, add back half of the mods you just removed.

> Keep in mind you don't have to stick strictly to halves each time, and may have to enable some library mods like Fabric API out of order.

> By repeating this on an increasingly smaller set of mods, you'll find the problematic mod within a few iterations.

Make sure you leave Chat Patches and its dependencies installed when you're looking for the problematic mod, otherwise it won't do anything to help diagnose the issue.

### How to verify the integrity of releases [verification]
To verify Chat Patches jars, you'll need to download them from Modrinth so you can download the associated signature (`.asc`) and checksum (`.sha256`) files.
Once you have everything downloaded and in the same folder, open a terminal and follow the instructions below:

#### Checksums (easiest):
1. Navigate to https://eakondratiev.github.io/sha256.htm
2. Open the `{chatpatches-version}.jar.sha256` file with Notepad and copy it (not including any file name, if present)
3. Paste the checksum into the 'expected checksum' field
4. Drag or select the appropriate jar to the file field
5. Read the result!

#### Checksums (manual):
1. Print the expected checksum with `gc {chatpatches-version}.jar.sha256` (Windows) / `cat {chatpatches-version}.jar.sha256` (Mac/Linux)
2. Generate the downloaded jar's checksum with `Get-FileHash {chatpatches-version}.jar -Algorithm SHA256` / `sha256sum {chatpatches-version}.jar`
3. Verify that the checksums are identical. If they're not, double-check the commands are typed properly and try again.

#### Signatures (manual):
1. Install Gpg4win (Windows) / GPG (Mac/Linux)
2. Run `gpg --verify {chatpatches-version}.jar.asc {chatpatches-version}.jar`

If anything does not match, first ensure you copied every command **_exactly_**, and that you run it one more time.
If the checksum or signature still does not match, please message me **privately** on Discord and tell me which version failed verification and where you 
downloaded it from.

## Sponsor me!
- Ko-Fi: https://ko-fi.com/obro1961

[![15% off your first month with code OBRO15!](https://i.imgur.com/9mjs77B.png)](https://billing.kinetichosting.net/aff.php?aff=234)

ChatPatches

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README