Home›Java›Mods›RainbowGrass
RainbowGrass
ModsJava

RainbowGrass

⬇ Download on Spigot
Open in MC Java ModsGet it on Google Play →
[​IMG]

Make your grass colourful.​

Choose from 16 unique colours and transform entire connected patches of grass with a simple click.

One patch. One click. A whole new landscape.​

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

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] COLOR AN ENTIRE GRASS PATCH

» Right-click grass or a nearby solid block.
» RainbowGrass searches for the nearest matching grass block.
» The plugin follows the actual connected patch instead of colouring a square.

[​IMG] SMART CONNECTED SPREAD

» The colour spreads through physically connected grass-coloured blocks.
» A single thin obstacle can be crossed by default.
» Water, lava, air and two obstacles in a row create a real boundary.
» The original shape of the grass patch is preserved.

[​IMG] RANGE UPGRADES

» Default safety-cap tiers: 10 → 20 → 30 blocks.
» Custom radius can be configured by administrators.
» Maximum custom radius: 64 blocks.
» A separate block limit protects against extremely large grass fields.

[​IMG] INSTANT VISUAL REFRESH

» RainbowGrass forces a full chunk refresh for nearby players.
» Colour changes are visible immediately.
» No moving away, returning or reconnecting is required.

[​IMG] RESET ANY TIME

» Neutralizing Grass Dust restores grass to its normal appearance.
» Neutralizing dust uses the same range upgrade system.

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

16 COLORS. ONE GRASS.

RainbowGrass supports all 16 standard Minecraft colors..

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

WHAT GETS COLORED?

Spoiler: ✓ Biome-Tinted Blocks
RainbowGrass can colour every real Minecraft block that vanilla itself renders using biome grass colour.

Supported blocks:

» Grass Block
» Short Grass
» Tall Grass
» Fern
» Large Fern
» Potted Fern
» Bush
» Sugar Cane
» Pink Petals
» Wildflowers

Nothing is excluded from the biome-tinted grass system.

Unlike leaves, there are no fixed-colour leaf-type restrictions here.

Spoiler: How does the spread work?
RainbowGrass does NOT simply colour a square area.

Instead, the plugin:

» Finds the nearest matching grass block.
» Starts from that block.
» Spreads through physically connected grass-coloured blocks.
» Preserves the actual shape of the patch.

A path block, flower or stone does not necessarily have to stop the spread.

With the default configuration, the plugin can hop over one single thin solid obstacle and continue colouring grass on the other side.

Water, lava, air and two obstacles in a row always create a real boundary.

Spoiler: Instant rendering
RainbowGrass forces a full chunk refresh for every nearby player when the colour changes.

The result is immediate.

There is no need to:

» Move away and come back.
» Reconnect to the server.
» Wait for Minecraft's rendering cache to update.

The colour change is displayed immediately after the operation.

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

HOW DOES IT WORK?

Spoiler: ① Right-click the grass
Hold your Colored Grass Dust in your main hand.

Right-click:

» A grass block
» Or another solid block near grass

RainbowGrass searches a small radius around the clicked block for the nearest matching grass block.

Default search radius:

Code (Text):
search-radius: 5

Spoiler: ② The whole patch changes
Once the first matching block is found, RainbowGrass spreads through the connected grass-coloured area.

It colours the exact shape of the patch — not a square.

The safety-cap radius determines how far the spread can travel from the clicked location.

Default tiers:

Code (Text):
10 → 20 → 30
This prevents a huge open field or an entire island from being coloured accidentally.

Spoiler: ③ Large fields are protected
Grass can continue uninterrupted for hundreds of blocks.

For this reason RainbowGrass has an additional hard limit:

Code (Text):

max-grass-blocks: 4000
 
This limits the total number of grass blocks that can be coloured in a single click, independently of the radius.

Two layers of protection. One safe operation.

Spoiler: ④ Nothing in range?
If no matching grass block is found within the configured search radius, nothing is changed.

You will receive a chat message telling you that no grass was found.

Simply move closer 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 with:

Code (Text):

consume-in-creative: true
 

Spoiler: ⑥ Need a larger range?
While holding the dust, administrators can use:

Code (Text):

/rainbowgrass setsize
 
This allows a custom safety-cap radius instead of the standard crafting tiers.

The maximum value is controlled by:

Code (Text):

max-custom-size: 64
 
The command requires permission and is OP-only by default.

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

CRAFTING

Spoiler: Colored Grass Dust
Recipe:

Code (Text):

Wheat Seeds + Dye → Colored Grass Dust
 
The dye determines the colour.

All 16 standard Minecraft colours are supported.

Spoiler: Range Upgrade — Colored Dust
Recipe:

Code (Text):

Colored Grass Dust + Wheat Seeds → Next Tier
 
Default safety-cap progression:

Code (Text):

10 → 20 → 30
 

Spoiler: Neutralizing Grass Dust
Recipe:

Code (Text):

Wheat Seeds + Wheat Seeds → Neutralizing Grass Dust
 
Use this dust to restore coloured grass back to its normal appearance.

Spoiler: Range Upgrade — Neutralizing Dust
Recipe:

Code (Text):

Neutralizing Grass Dust + Wheat Seeds → Next Tier
 
Neutralizing dust uses the same range progression as coloured dust.

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

FOR SERVER ADMINS

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

RainbowGrass installs its own bundled data pack containing 16 biomes.

Spoiler: Installation
① Drop in the JAR

Place the RainbowGrass plugin file inside:

Code (Text):

plugins/
 
② Start the server once

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

Code (Text):

/datapacks/rainbowgrass/
 
The plugin will log a console warning informing you that a restart is required.

③ Fully restart the server

This step is essential.

/reload is NOT enough.

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

④ Done

Players can now craft and use RainbowGrass.

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

COMMANDS

Spoiler: Commands
Code (Text):

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

Code (Text):

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

Code (Text):

/rainbowgrass reload
 
» Reloads config.yml and the language files.

Code (Text):

/rainbowgrass version
 
» Shows the plugin version and author.

Code (Text):

/rainbowgrass info
 
» Displays in-game help.

Aliases:

Code (Text):

/rgr
/rgrass
 

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

PERMISSIONS

Spoiler: Permission Nodes
Code (Text):

rainbowgrass.craft
 
» Allows crafting RainbowGrass dust.
» Default: Everyone

Code (Text):

rainbowgrass.use
 
» Allows using RainbowGrass dust.
» Default: Everyone

Code (Text):

rainbowgrass.give
 
» Allows giving dust to other players.
» Default: OP

Code (Text):

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

Code (Text):

rainbowgrass.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-grass-blocks: 4000
search-radius: 5

tunnel-through-thin-obstacles: true

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
 
Additional languages can be created by copying and translating an existing language file.

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

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

tier-sizes
» Successive safety-cap radius tiers used for crafting upgrades.

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

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

search-radius
» Radius searched around the clicked block for the nearest matching grass block.

tunnel-through-thin-obstacles
» Allows the spread to hop over one single non-grass solid block.

» Does not bridge air.
» Does not bridge water or lava.
» Does not bridge two obstacles in a row.

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

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

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

default-biome
» Biome restored when using neutralizing dust.

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

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

TROUBLESHOOTING

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

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

Right-clicking empty air does nothing intentionally.

Spoiler: I get a message that no grass was found.
You're probably too far away from a matching grass block.

Check:

» Your search-radius value.
» Your distance from the grass.
» Whether the area actually contains one of the supported grass-coloured blocks.

Plain dirt or stone alone will never match.

Spoiler: A path or flower split my lawn into two colours.
By default, RainbowGrass can hop over one single thin solid obstacle.

However:

» Two obstacles in a row create a boundary.
» Water creates a boundary.
» Lava creates a boundary.
» Air creates a boundary.

If necessary, remove the obstacle or colour the two sections separately.

Spoiler: RainbowGrass biomes aren't loaded yet.
The server has not been fully restarted after the plugin/data pack was installed.

Restart the entire server.

Do NOT use:

Code (Text):

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

Spoiler: I want to see exactly what happens on each click.
Enable:

Code (Text):

debug-logging: true
 
Then run:

Code (Text):

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

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

Turn your grass path, to the dreamed one.

RainbowGrass

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.

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

Explore more

All Mods for JavaAll Minecraft Java modsJava mods for 1.21Java mods for 26