
Modrinth · Minecraft mod
Rainbow
A Minecraft mod to generate Geyser mappings and bedrock resourcepacks for use with Geyser's custom content APIs
Quick answer
Which Rainbow release matches 26.1?
Rainbow 0.2.0-26.1-b53 targets 26.1, 26.1.1, 26.1.2 with Fabric. It must be installed on the client. Do not install it on the dedicated server. All 1 required mods have matching files.
Where it goes
Is Rainbow required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does Rainbow 0.2.0-26.1-b53 need?
0.2.0-26.1-b53 on 26.1. Every mod below is checked against that same setup.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Rainbow without breaking your instance.
Built for Rainbow 0.2.0-26.1-b53 on 26.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 0.2.0-26.1-b53. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 0.2.0-26.1-b53. It opens that exact file at the source.
About this project
What does Rainbow add?
Rainbow
Rainbow is a client-side Minecraft mod for the Fabric modloader to generate Geyser block/item mappings, locale overrides, and bedrock resourcepacks
for use with Geyser's custom content APIs. Rainbow is available for Minecraft 26.3.
Rainbow is currently experimental, and capable of generating Geyser block/item/skull/waypoint style mappings, and a bedrock resourcepack for
somewhat simple blocks, 2D and 3D items, sounds, and waypoint styles. For a moderately complete list of Rainbow's capabilities, see further below.
Rainbow works by detecting custom blocks (using block state overrides) from loaded resourcepacks, and custom items in your inventory, or a container/inventory menu you have opened.
It analyses the components of detected items, and uses assets from loaded Java resourcepacks to gather information about block and item models, textures,
and more.
Usage
You can download the latest version of Rainbow here on our website or here on Modrinth. Using Rainbow requires the Fabric API to be installed.
To use Rainbow, you must install it on your Minecraft client. Rainbow adds a few commands to the client. Generally,
you use them as follows:
- First, start a new pack by running
/rainbow create <name>, replacing<name>with the name of your pack. Your resourcepack and Geyser mappings will be exported in the.minecraft/rainbow/<name>folder. Anything in here can be overwritten! - Once you have created a pack, you can start mapping custom content. Mapped custom content will be included in the exported resourcepack and Geyser mappings. There are multiple ways to map custom content:
/rainbow map block <target>- maps the custom block at<target>, if any./rainbow map item- maps the custom item or skull you're currently holding in your hand, if any./rainbow map sound <namespace>- maps all the custom sounds of the given namespace./rainbow map waypoint <waypoint style>- maps the given waypoint style, if it exists./rainbow mapinventory- scans your inventory for custom items or skulls, and maps all that are found./rainbow auto blocks- scans through all loaded resourcepacks for custom blocks created using block state overrides, and maps all that are found. This may shortly freeze your client./rainbow auto inventory- scans all inventory menus and containers you open for custom items and skulls, and maps all that are found. This is handy for plugins that offer an inventory menu listing all custom items.- Use
/rainbow auto stopto stop the mapping of custom items.
- Use
/rainbow auto recipes- scans through all known recipes for results that are custom items or skulls, and maps all that are found. This is handy for datapacks that contain recipes with custom items as result. You can use the vanilla/recipe give @s *command to give yourself all recipes, which helps Rainbow recognise custom items with this command./rainbow auto sounds- scans through all loaded resourcepacks for custom sounds, and maps all that are found./rainbow auto waypoints- scans through all loaded resourcepacks for custom waypoint styles, and maps all that are found.
- Once you have mapped all of your custom items, use
/rainbow finishto finish the pack. Rainbow will then export the resourcepack and Geyser mappings it has created.
When you've finished your pack, navigate to the .minecraft/rainbow/<name> folder. You can also click on the Wrote pack to disk in chat to open this folder.
In this folder, you'll find 4 important files/folders:
custom_mappings: you need to put the files in here in thecustom_mappingsfolder in Geyser's config folder. These are the generated Geyser mappings.pack.zip: you need to put this file in thepacksfolder in Geyser's config folder.lang: you need to put all files in this folder in thelocales/overridesfolder in Geyser's config folder.- The folder can be empty or non-existent if no language files are found. This is usually not an issue!
report.txt: you don't need to do anything with this file, but it contains information about generated assets and possible problems that occurred.
Once you have taken these steps, restart your server. Bedrock players should then download the generated pack upon joining,
and if everything went well, they should be able to see (and hear) custom content!
If you have any questions or run into any problems, please do feel free to ask for support in the Geyser Discord!
What Rainbow can do
Rainbow is currently capable of the following:
- Generating Geyser block mappings for custom blocks made using block state overrides, both automatically and manually from loaded resourcepacks.
- Generating Geyser item mappings complete with data components and proper bedrock options, by detecting items with custom
minecraft:item_modelorminecraft:custom_model_datacomponents, and analysing their components.- Also includes generating mappings with predicates for more complicated Java item model definitions, such as checks for if an item is broken. The following definition types are currently supported by Rainbow:
- Plain item model definitions.
- Conditional item models, supported properties are:
broken,damaged,custom_model_data,has_component, and,fishing_rod/cast.
- Range dispatch item models, supported properties are:
bundle/fullness,count,custom_model_data, and,damage.
- Select item models, supported properties are:
charge_type,trim_material,context_dimension, and,custom_model_data.- For the
display_contextproperty, theguicase is mapped, if present.
- Also includes detecting if an item should be displayed handheld by looking at the item's model.
- Also is able to detect and map items using the "legacy"
custom_model_datarange-dispatch style, and map them to Geyser'slegacyitem mappings. - Also supports mapping dyeable items, but these are (for now) only detected when they're dyed whilst mapping.
- Also includes generating mappings with predicates for more complicated Java item model definitions, such as checks for if an item is broken. The following definition types are currently supported by Rainbow:
- Generating Geyser skull mappings for custom player heads.
- Generating Geyser waypoint style mappings for custom waypoint styles (locator bar icons).
- Generating a simple bedrock resourcepack for blocks and simple 2D items, as well as:
- Simple custom armour items, by analysing an item's
minecraft:equippablecomponent and loaded equipment assets.- Custom elytra items also work, but only visually, due to bedrock limitations.
- 3D items, by converting the Java model to a bedrock one, and generating an attachable and animations for it, as well as rendering a custom GUI icon.
- Is able to translate display transformations for the head, first-person and third-person item slots.
- Custom sounds.
- Simple custom armour items, by analysing an item's
- Generating working animated (flipbook) textures for 2D items and 3D items that make use of a single texture only.
- Exporting merged language files from loaded resourcepacks to a folder, for easy copying to Geyser's
locales/overridesfolder.- Files from different resourcepacks for the same language are merged together.
Project description from Modrinth.
Pick your setup
Rainbow by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3
1 loader build26.2
1 loader build26.1.2
1 loader build26.1.1
1 loader build26.1
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Rainbow versions and loaders
0.2.0-26.1-b53
Rainbow.jar
29 May 2026
0.2.0-26.1-b52
Rainbow.jar
27 May 2026
0.2.0-26.1-b51
Rainbow.jar
27 May 2026
0.2.0-26.1-b50
Rainbow.jar
23 May 2026
0.2.0-26.1-b49
Rainbow.jar
18 May 2026
0.2.0-26.1-b48
Rainbow.jar
17 May 2026
0.2.0-26.1-b47
Rainbow.jar
17 May 2026
0.2.0-26.1-b46
Rainbow.jar
13 May 2026
0.2.0-26.1-b45
Rainbow.jar
5 May 2026
0.2.0-26.1-b44
Rainbow.jar
5 May 2026
0.2.0-26.1-b43
Rainbow.jar
5 May 2026
0.2.0-26.1-b42
Rainbow.jar
4 May 2026
Looking for an older file? The official Modrinth project page is in Resources.