Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
Chimage is a Minecraft mod that lets you paste, preview, and share images directly in the in-game chat.
Aiming to support both Fabric and Forge on every Minecraft version from 1.16.5 onwards.
How to use
Using Chimage is straightforward. There are three ways to attach an image to your chat message:
- Clipboard: Simply press
CTRL + Vwhile the chat bar is open. (With image or image file in clipboard) - Drag & Drop: Drag an image file from your computer directly into the Minecraft window while the chat is open.
- URL Loading: Type
!(your_url)in the chat, or simply type!and pressCTRL + Vwith an image link. Chimage will automatically fetch it directly from the web!
Once you've attached an image, a small preview window will appear above your chat bar. This lets you confirm the image before sending it.
Features List
- Clipboard Paste: Press
CTRL + Vwhile the chat is open to send images from your clipboard. - Drag & Drop: Drag image files from your computer directly into the game window while the chat is open.
- URL Loading: Fetch images, GIFs, and gallery links (like Imgur and Tenor) instantly by pasting links or typing
!(url). - Real-Time Preview: See a preview window of your image to confirm before sending.
- In-Chat Rendering: View images sent by other players directly within the chat box.
- Fullscreen Viewer: Click any image in chat to view it in fullscreen with zoom support.
- Image Metadata: Hold
SHIFTwhile hovering over an image to see its details. - Quick Download: Use
SHIFT + Left Clickon an image to save it to your computer. - Quick Copy: Use
CTRL + Left Clickon an image to copy it straight to your clipboard. - Spoilers: Mark images as spoilers to keep them blurred in chat until hovered or clicked.
- Vanilla Compatibility: Vanilla clients can view images via clickable fallback links (if enabled by the server).
- Highly Configurable: Adjust maximum image sizes, rendering limits, behaviours, and more.
- Built-in Image Editor: Draw, erase, pick colors, crop, and resize images before sending them.
- Immersive Paintings Integration: Export your edited images directly into the world as custom paintings or graffiti!
Image Editor
Chimage features a robust built-in Image Editor, allowing you to quickly modify images right before sending them in chat.
Features include:
- Pen & Eraser: Draw or erase directly on the image with customizable brush sizes.
- Color Picker: A fully-featured RGB/HSL/HSV & Alpha color picker to select the exact color you need.
- Resize: Scale the image up or down, optionally locking the aspect ratio.
- Crop: Quickly crop out the important parts of the image.
- Undo / Redo: Made a mistake? Use
Ctrl+ZandCtrl+Yto undo or redo your actions.
View Editor Screenshots
(Screenshots coming soon)
Immersive Paintings Integration
If you have the Immersive Paintings mod installed alongside Chimage, a new export button will appear inside the Image Editor!
This feature allows you to take any image or any drawing you've made inside the editor and instantly convert it into a custom painting or graffiti item. You can then place it anywhere in your Minecraft world!
Commands
/chimage- The main command for the mod. This command allows server admins to manage the Access List, controlling exactly who is allowed to send images in chat.
Server Compatibility
Vanilla Servers The mod is disabled on vanilla servers. In order to upload and share images, the server must also have the mod installed.
Vanilla Clients (Link-based fallback) If a player connects without the mod installed, they can still "see" the images via link-based fallbacks! The server converts uploaded images into clickable web links for vanilla clients to open in their browser. (Note: Server owners must configure this feature themselves).
Planned Features (TODO)
- Multiple images support??? 1.3.X | arrows to cycle thru attached images (auto cycle thru img config)
- Fix ~1.16.5 updating older messages based on some settings like vanilla mode
- Tools: select (box & lasso), bucket, spray, text, shape, expand tool (crop alternative)
- Aspect ratio buttons (crop, expand, and resize when unlinked ratio instead of a size slider)
- Remix button (modifying someone else's images)
- Gallery (saving images and gifs)
- Discord Chat addon (messages and images between discord and mc chat)
- Cooldown
- Always shown preview (select from PC/new file)
- Layers
- Range version support (1.16.x instead of 1.16.5)
- Compress on receive (to reduce graphics load, the client can enforce a reduced resolution limit and downscale the image before rendering, with additional info shown in the shift tooltip)
- Fix "Load image" flicker when sending an image (seen on all versions)
- Finish writing BaLLib and switch from using Cloth Config (because of feature parity across cloth versions)
- /msg support (customizable per command and togglable)
- Hide server config if not OP


