Skip to main content

Rainbow

Rainbow is a Fabric client-sided Minecraft mod to generate Geyser item mappings and bedrock resourcepacks for use with Geyser's custom item API (v2) for use on servers.

What is Rainbow?​

Rainbow is a generator to create Geyser item mappings and Bedrock Edition resource packs, it uses the Geyser Custom Item API V2 format to allow the use of 1.21.4+ Java Edition packs.

caution

This project is early in development! Any bugs and issues should be reported in our Discord.

Usage​

To use Rainbow:

  1. You need to set up a 26.1 Fabric client for Java Edition and ensure the mod is present on the client.
  2. Join your server of choice to start converting packs and run /rainbow create <pack name> with <pack name> being the name of your output pack.
  3. You can map things in a couple of ways:
    • Hold each item in your hand one by one and run /rainbow map while holding the item.
    • Fill your inventory with the custom items and run /rainbow mapinventory to map your entire inventory.
    • Run /rainbow auto inventory and open a UI with the custom content (For example, a chest or command from a plugin to show custom content.). Rainbow will continue mapping all custom items until you stop the process with /rainbow auto stop.
  4. Run /rainbow finish to finish your conversion, Rainbow will then output your pack and mappings file to <instance folder>/rainbow/<pack name>, optionally, you can click the Wrote pack to disk message in chat to open the folder.
  5. In this folder, you will find 3 files, pack.zip which you put in your packs folder of your server, geyser_mappings.json which you put in your custom_mappings folder of your server and finally report.txt which you can send in our Discord if you face issues, otherwise, you can ignore this file.

Download​

You can download Rainbow here.

Contributing​

Any contributions are appreciated. Please feel free to reach out to us on Discord if you're interested in helping out with Rainbow.