← WoodDye ReForged

Config & woods

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

Every setting.

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

Measured, and yours to overrule.

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.

  • ▸SHADE (default) - lightest to darkest.
  • ▸RAINBOW - around the colour wheel. Woods too grey to have a real hue, like pale oak, come first, lightest to darkest; the rest follow by hue.

logOrder - bark against end-grain

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.

  • ▸SAME_AS_PLANKS - by inner-wood colour, matching planks. Looks right on the ends.
  • ▸BARK - by bark colour, measured like the plank order. Looks right on the sides.
  • ▸INTELLIGENT (default) - picks per click: a side follows bark order, a top or bottom follows wood order. The log keeps its orientation.

For pack authors

Which woods take part is a tag, not a list.

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

For wood still in your bag.

Fireproofing a stack

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 to wood, shapeless

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.