Chameleon
by caramel
Chameleon lets a macOS player change the Dock icon of the running Minecraft window, using an icon pack, a client command or a resource pack entry.
What it does
Chameleon swaps the Dock icon shown while Minecraft runs on macOS. The change works on clients from Minecraft 1.19 onward. An icon can be chosen through the client command chameleon, through the mod's entry in Mod Menu, or by adding an icon with a Custom Resource Pack. An icon pack of nine icons ships with the mod, and the mod applies to macOS Big Sur and later. From version 3.2.0 the mod also supports Windows, although that platform is marked unstable. Only the client needs the mod, so servers run without it.
The mod is installed as a Fabric and Quilt file for 1.20 – 1.21.11, with 17 release versions in that range. Fabric API is required, and Mod Menu is optional for its settings screen. Java 17 or newer is needed. Chameleon is released under the MIT License and is open source, and its source code and issue tracker are public. The first build was published on 2023-06-08, and the latest file, 4.7.0 for 1.21.11, followed on 2025-10-09.
Key features
Dock icon replacement
The Dock icon of the running game window is replaced with a chosen image while Minecraft is open.
Client command
A command named chameleon sets the icon from inside the game, without editing any files.
Icon pack
Nine icons come bundled with the mod, so a player can switch without finding an image of their own.
Resource pack icons
A custom icon can be added through a Custom Resource Pack, so packs can ship their own Dock image.
Other languages
The mod's text can be read in other languages, so the menu and messages are not limited to English.
Gallery
Compatibility
Latest build for each game version and loader.
1.21.x12 of 12 versions with builds
1.20.x5 of 5 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Optional 1
Use cases
Who it’s for: Players on macOS who want a different Dock icon while Minecraft runs, and resource pack authors who want to ship one with their pack.
How it compares
MacOS LWJGL Fix is a Fabric client mod for 1.14 – 1.17.1, released under the MIT License and open source, so it covers older versions than Chameleon. EmuNO is a Fabric client mod for 1.19 – 1.20.6, also under the MIT License and open source, and it overlaps with Chameleon only for 1.19 and 1.20 builds. macOS Chat Fixes is a Fabric client mod for 26.1 – 26.3 under the GNU Lesser General Public License v3.0 only, so it targets a later version range and a different license.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Chameleon | Fabric and Quilt | 1.20 – 1.21.11 | Client-side only | 2025-10-09 |
| MacOS LWJGL Fix | Fabric | 1.14 – 1.17.1 | Client-side only | 2025-08-14 |
| EmuNO | Fabric | 1.19 – 1.20.6 | Client-side only | 2023-10-06 |
| macOS Chat Fixes | Fabric | 26.1 – 26.3 | Client-side only | 2026-09-24 |
Questions
Does Chameleon need Fabric API?
Does a server need Chameleon?
Which Java version does Chameleon need?
In the catalog
Chameleon is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 19,862 mods support Minecraft 1.21.11.
More from caramel
Similar mods
What the author says
Read in other languages: English, 한국어, 日本語. Introduction -------- - This mod allows you to change the Dock icon in macOS on Minecraft 1.19 and later clients. (Starting from version 3.2.0, Windows OS is also unstable but supports it.) - This mod provides icon pack containing 9 icons for players who run on macOS Big…
Official listing
- Modrinth page
- modrinth.com/mod/chameleon
- Owner
- caramel
- Published
- 2023-06-08
- Updated on Modrinth
- 2025-10-09
- Facts verified
- 2026-10-15