38 lines
2.3 KiB
Markdown
38 lines
2.3 KiB
Markdown
---
|
|
title: Rainbow
|
|
description: A Minecraft mod to generate Geyser item mappings and bedrock resourcepacks for use with Geyser's Custom Item API V2.
|
|
---
|
|
|
|
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? {#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](https://discord.gg/geysermc).
|
|
|
|
:::
|
|
|
|
## Usage {#usage}
|
|
|
|
To use Rainbow:
|
|
1. You need setup a 1.21.11 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](https://discord.gg/geysermc) if you face issues, otherwise, you can ignore this file.
|
|
|
|
## Download {#download}
|
|
|
|
You can download Rainbow [here](/download/?project=other-projects&rainbow=expanded).
|
|
|
|
## Contributing {#contributing}
|
|
|
|
Any contributions are appreciated. Please feel free to reach out to us on [Discord](https://discord.gg/geysermc) if
|
|
you're interested in helping out with Rainbow.
|