
Throwable Dye
This mod allows you to throw dyes!
Screenshots

About this Mod
Overview
This is a mod that allows you to throw dyes!
Throwing it at a block with a colored variant (eg. concrete) will dye the block the color of the dye you threw. This should work with every vanilla block.
This will also work with modded blocks, however, there are some exceptions which will need to be added to the config manually.
Config
Technical Overview
The way this mod works is when the thrown dye hits a block, it will get the block's id.
Then it will check if the block id starts or ends with a dye color. If it does, it will replace the color in the block id, with the thrown dye color.
If a color is not found in the block id, the it will try appending the thrown dye color to the beginning of the block id.
Finally, if that fails, it will fall back to the config file, and check if there is a colored block variant mapped to the default block.
Adding to the config
On the event that a some blocks do not work, you can add it into the config.
The config is called throwabledye.json. The syntax is as follows:
"somemod:block_id": "{color}_block_id"
A working example of this would be:
"minecraft:glass": "{color}_stained_glass"
Some blocks have a base, or un-dyed, variant, such as glass or terracotta. Unlike terracotta, dyed glass does not keep the same color + blockid format, it has an extra word, "stained", which is not referenced in the base variant, so the base variant needs to be mapped to the colored variant.
This is done by making the base block id the key. Then taking the colored block id, putting {color} where the color name would be, and making it the value. Then the mod can replace {color} with the thrown dye color.
Available Versions
How to Install Throwable Dye on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.2).
Install Mod
Open the mod browser in the dashboard and search for "Throwable Dye". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.2, 1.20.1, 1.20 (+5 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Throwable Dye server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.2). You can switch loaders with one click in the panel.
Is Throwable Dye compatible with fabric?
Throwable Dye officially supports fabric for Minecraft 1.20.2, 1.20.1, 1.20. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Throwable Dye – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Throwable Dye consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Throwable Dye with just one click on your server.