Thirteen settings in config/wooddye-common.toml,
read live - save the file and they apply, no restart. In single-player they are also under
Mods → WoodDye ReForged → Config, each with a readable name and its comment as the tooltip.
wooddye-common.toml
| Setting | Default | What it does |
|---|---|---|
| useItems | false | Consume the dye or magma cream when treating a block in the world. A wet sponge is never used up - it only dries out. Never consumed in creative, and crafting recipes always use their ingredients. |
| fireProof | true | Magma cream fireproofing, in the world and on the bench. Off, and there is no route to fireproof wood at all. Restoring with a sponge is never blocked, so fireproofing is always reversible. |
| spongeDries | false | Hand back a dry sponge instead of the wet one when restoring wood on the bench, so it must be re-soaked between batches. |
| logOrder | INTELLIGENT | How logs step - see below. |
| dyeOrder | SHADE | Sort woods lightest to darkest (SHADE) or around the colour wheel (RAINBOW). |
| moddedWoods | false | Include woods from other mods. Any mod that puts its blocks in the standard tags is picked up automatically, to be dyed and fireproofed. |
| netherWoods | false | Include crimson and warped - anything in #minecraft:non_flammable_wood. Off because by lightness teal warped planks land between acacia and spruce, a surprise halfway through darkening a floor. They suit RAINBOW well. |
| excludedWoods | [] | Leave woods out: a mod id ("biomesoplenty") for every wood from that mod, or one wood ("minecraft:bamboo"). |
| toneOverrides | [] | Replace a measured colour: "<block id>=#rrggbb". A planks block moves the wood in the plank order, a log block in the bark order. |
| showEffects | true | A particle and sound when wood is dyed, fireproofed or restored. |
| showMessage | true | An action-bar message when a treatment succeeds. |
| message | &aWood treated! | That message. & colour codes and %P for the player's name. |
| debugMode | false | Extra logging. |
The orders
Each wood's plank texture - and for logs, its bark texture - is averaged to one colour, and the chain is
sorted on it. Vanilla's are measured when the mod is built; a modded wood's is read from that mod's own
jar when the server starts. If a texture cannot be found, the block's map colour stands in.
/wooddye woods prints the result, and toneOverrides replaces
any measurement you disagree with.
A log's bark and its end-grain rings run through different colour orders, so one fixed order can only look right on one of them.
For pack authors
WoodDye owns one block tag per form - #wooddye:dyeable/planks,
…/slabs, …/stairs, …/logs,
fences, fence gates, doors, trapdoors, pressure plates, buttons, the four kinds of sign, and shelves - and
each ships as nothing more than a pointer at the vanilla tag (#minecraft:planks,
#minecraft:wooden_slabs, …). Blocks are grouped into a wood by name:
oak_planks, oak_slab and
stripped_oak_log are all oak.
So a wood a newer Minecraft adds works out of the box, a mod that tags its wood the standard way is picked
up with moddedWoods on, and a datapack can add to or remove from the
wooddye:dyeable/* tags for anything that does not:
// in your datapack: data/wooddye/tags/block/dyeable/planks.json
// (tags/blocks/, plural, on 1.20.1)
{
"replace": false,
"values": [ "somemod:redwood_planks" ]
}
Fireproofing follows the same list. It is a mark on the block's position rather than a separate block, so any wood WoodDye can see can be fireproofed - vanilla, nether or a mod's.
On the crafting bench
| Recipe | Gives |
|---|---|
|
8 × any wooden block around magma cream |
8 of the same item, fireproof. |
|
8 × fireproof wood around a wet sponge |
8 plain items back - and the sponge, which is not used up. |
A fireproof item is the ordinary item with a mark on it: named "… (Fireproof)", it does not stack with
plain ones, and placing it makes a fireproof block. The magma cream recipe obeys
fireProof. Dye a fireproof block on the bench and you get the fireproof form of
the new wood - only magma cream and the sponge decide whether wood is fireproof.
| Dye | Wood |
|---|---|
| White | Birch |
| Light gray | Oak |
| Gray | Pale Oak |
| Yellow | Jungle |
| Orange | Acacia |
| Brown | Spruce |
| Pink | Cherry |
| Red | Mangrove |
| Lime | Bamboo |
| Green | Poplar, where the game has it |
| Black | Dark Oak |
Any wooden block plus a dye, for every form except logs - a log's bark and end-grain run in different orders, a choice only the in-world click can make.