Home›Java›Mods›RainbowLeaves
RainbowLeaves
ModsJava

RainbowLeaves

Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.

⬇ Download on Spigot
[​IMG]
Make your leaves colourful.​

Choose from 16 Minecraft colours and transform compatible tree leaves with a simple click.

One tree. One click. A whole new colour.​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Spoiler: Screen From Game
[​IMG]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FEATURES


[​IMG] 16 MINECRAFT COLOURS

» Use the full palette of 16 standard Minecraft colours.
» White, Orange, Magenta, Light Blue, Yellow, Lime, Pink, Gray, Light Gray, Cyan, Purple, Blue, Brown, Green, Red and Black.

[​IMG] COLOUR AN ENTIRE TREE LEAVES

» Right-click the trunk or a nearby solid block.
» RainbowLeaves finds the nearest compatible leaves automatically.
» The colour spreads through the connected canopy instead of painting a square area.

[​IMG] SMART TREE DETECTION

» Connected leaves are detected automatically.
» Diagonally connected leaves are included.
» The system follows the actual shape of the canopy.

[​IMG] RANGE UPGRADES

» Start with a 10-block safety radius.
» Upgrade through 10 → 20 → 30.
» Administrators can configure a custom maximum radius up to 64 blocks.

[​IMG] RESET ANY TIME
» Neutralizing Leaf Dust restores coloured leaves to their normal appearance.
» Reset dust supports the same range upgrade system.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[​IMG] 16 COLORS. ONE FOREST.

RainbowLeaves supports all 16 standard Minecraft colors..

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

WHICH LEAVES WORK?

Spoiler: ✓ Supported Leaf Types
Biome-tinted leaves

» Oak Leaves
» Jungle Leaves
» Acacia Leaves
» Dark Oak Leaves
» Mangrove Leaves

These leaf types use Minecraft's biome tinting system and can therefore be recoloured by RainbowLeaves.

Spoiler: ✕ Unsupported Leaf Types
Fixed-colour leaves

» Spruce Leaves
» Birch Leaves
» Cherry Leaves
» Azalea Leaves
» Flowering Azalea Leaves
» Pale Oak Leaves

These leaves have their colour fixed directly in their textures.

This is a Minecraft limitation, not a RainbowLeaves limitation.

Spoiler: Why can't they be recoloured?
Minecraft handles some leaf types using biome tinting, while others have a fixed colour baked into their textures.

RainbowLeaves uses Minecraft's biome system to achieve its colour changes.

» A server-side plugin cannot change the fixed texture colour.
» Recolouring those leaves would require a custom resource pack.
» That is a completely different mechanism from RainbowLeaves.

There is no server-side workaround for these leaf types.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

HOW DOES IT WORK?

Spoiler: ① Hold the Leaf Dust
Hold your Colored Leaf Dust in your main hand.

The dust determines which colour will be applied to the tree.

Spoiler: ② Right-click the tree
You don't need to aim directly at the leaves.

» Right-click the tree trunk
» Or right-click another solid block near the canopy

RainbowLeaves searches a small area around the clicked block for the nearest compatible leaves.

Default search radius:

Code (Text):
search-radius: 5

Spoiler: ③ The whole canopy changes
Once a compatible leaf block is found, RainbowLeaves follows every physically connected leaf block.

» Connected leaves are detected automatically.
» Diagonal connections are supported.
» The actual shape of the tree is preserved.
» It does NOT simply colour a square area.

The configured range acts as a safety-cap radius from the trunk, preventing the spread from accidentally reaching a neighbouring tree.

A second max-tree-blocks safeguard limits the total number of leaf blocks that can be coloured in one click.

Spoiler: ④ Nothing nearby? No problem.
If RainbowLeaves cannot find compatible leaves within the search radius, nothing is changed.

You'll simply receive a message telling you that no suitable leaves were found.

Move closer to the canopy and try again.

Spoiler: ⑤ The item is consumed
Every successful use consumes 1 item.

This also applies in Creative mode by default.

Administrators can change this behaviour using:

Code (Text):
consume-in-creative: true

Spoiler: ⑥ Need a bigger tree?
For very large trees such as Jungle or Dark Oak, administrators can increase the safety-cap radius of the held dust:

Code (Text):
/rainbowleaves setsize
This requires the appropriate permission and is OP-only by default.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Spoiler: Rendering Note
Sometimes Minecraft's client-side rendering cache may prevent the new leaf colour from appearing immediately.

If the plugin reports that the operation was successful but the leaves still look unchanged:

» Move away from the tree.
» Move back.
» Or reconnect to the server.

This is a Minecraft rendering behaviour, not a failed operation.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CRAFTING

Spoiler: Colored Leaf Dust
Recipe:

Code (Text):

Bone Meal + Dye → Colored Leaf Dust
 
The dye determines the colour.

All 16 standard Minecraft colours are supported.

Spoiler: Range Upgrade — Colored Dust
Recipe:

Code (Text):

Colored Leaf Dust + Bone Meal → Next Tier
 
Default safety-cap progression:

Code (Text):
10 → 20 → 30

Spoiler: Neutralizing Leaf Dust
Recipe:

Code (Text):

Bone Meal + Bone Meal → Neutralizing Leaf Dust
 
Use this dust to restore coloured leaves to their normal appearance.

Spoiler: Range Upgrade — Neutralizing Dust
Recipe:

Code (Text):

Neutralizing Leaf Dust + Bone Meal → Next Tier
 
Neutralizing dust uses the same range progression as coloured dust.

Bone Meal is intentionally used instead of Glowstone Dust to avoid recipe conflicts with RainbowWater.​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FOR SERVER ADMINS

Spoiler: Requirements
» Paper 1.21.11 → 26.2
» Java 21 or newer
» Write access to the server world folder

RainbowLeaves installs its own bundled data pack containing the required biomes.

Spoiler: Installation
① Drop in the JAR

Place the RainbowLeaves plugin file inside:

Code (Text):
plugins/
② Start the server

On the first startup, RainbowLeaves automatically installs its bundled data pack into:

Code (Text):
/datapacks/rainbowleaves/
The plugin will warn you that a restart is required.

③ Fully restart the server

This step is important.

/reload is NOT enough.

Minecraft only loads newly installed biomes during a full server startup.

④ Done

Players can now craft and use RainbowLeaves.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

COMMANDS

Spoiler: Commands
Code (Text):

/rainbowleaves give <color|reset> [size]
 
» Gives a player coloured or neutralizing dust.

Code (Text):

/rainbowleaves setsize
 
» Sets a custom safety-cap radius on the held item.

Code (Text):

/rainbowleaves reload
 
» Reloads config.yml and language files.

Code (Text):

/rainbowleaves version
 
» Shows the plugin version and author.

Code (Text):

/rainbowleaves info
 
» Displays in-game help.

Aliases:

Code (Text):
/rlv
/rleaves
 

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PERMISSIONS

Spoiler: Permission Nodes
Code (Text):

rainbowleaves.craft
 
» Allows crafting RainbowLeaves dust.
» Default: Everyone

Code (Text):

rainbowleaves.use
 
» Allows using RainbowLeaves dust.
» Default: Everyone

Code (Text):

rainbowleaves.give
 
» Allows giving dust to players.
» Default: OP

Code (Text):

rainbowleaves.setsize
 
» Allows setting a custom range.
» Default: OP

Code (Text):

rainbowleaves.reload
 
» Allows reloading the configuration.
» Default: OP

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CONFIGURATION

Spoiler: config.yml
Code (Text):

language: pl

base-size: 10
tier-sizes: [10, 20, 30]
max-custom-size: 64

max-tree-blocks: 4000
search-radius: 5

require-permission-to-craft: false
consume-in-creative: true

glow-effect: true

default-biome: minecraft:plains

debug-logging: false
 
Language files:

Code (Text):

lang/pl.yml
lang/en.yml
 
You can add additional languages by copying and translating an existing language file.

Spoiler: Configuration Explained
language
» Language used for player-facing messages.

base-size
» Starting safety-cap radius for freshly crafted dust.

tier-sizes
» Range progression used for crafting upgrades.

max-custom-size
» Maximum value allowed by /rainbowleaves setsize.

max-tree-blocks
» Maximum number of leaf blocks that can be coloured in a single click.

search-radius
» Distance searched around the clicked block for compatible leaves.

require-permission-to-craft
» Controls whether crafting requires a permission.

consume-in-creative
» Controls whether dust is consumed while in Creative mode.

glow-effect
» Controls whether the dust item has a glowing effect.

default-biome
» Biome used when neutralizing leaves.

debug-logging
» Enables detailed diagnostic logging in the server console.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TROUBLESHOOTING

Spoiler: I right-clicked the trunk and nothing happened.
Make sure:

» You're holding the dust in your main hand.
» You're right-clicking a solid block.
» You're clicking the trunk or a nearby solid block.
» You're not simply right-clicking empty air.

Right-clicking empty air does nothing intentionally.

Spoiler: No leaves were found.
You may be too far away from the canopy.

Check:

» Your search-radius setting.
» Your distance from the tree.
» Whether the tree uses a supported leaf type.

Remember that Spruce, Birch, Cherry, Azalea, Flowering Azalea and Pale Oak leaves are intentionally excluded.

Spoiler: The colour changed, but the leaves still look normal.
This can happen because of Minecraft's client-side rendering cache.

Try:

» Moving away and returning.
» Reconnecting to the server.

The plugin attempts to force a refresh automatically.

Spoiler: RainbowLeaves biomes aren't loaded yet.
The server needs a full restart after the data pack is installed.

Do not use:

Code (Text):
/reload
Restart the entire server instead.

Spoiler: I want detailed information in the console.
Enable debug logging:

Code (Text):

debug-logging: true
 
Then run:

Code (Text):

/rainbowleaves reload
 
The server console will now provide detailed diagnostic information for each operation.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Turn leaves more fancy, than the world do.

RainbowLeaves​

Made for Paper. Designed for colour.​

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

RainbowLeaves is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 21 times (via Spigot). Download it and open it directly in the game.

Explore more