Rainbow
Rainbow 是一款面向 Fabric 加载器的客户端 Minecraft 模组,用于生成 Geyser 的方块/物品映射、语言覆盖以及基岩版资源包,以便配合 Geyser 的自定义内容 API 使用。Rainbow 适用于 Minecraft 26.3。
Rainbow 目前处于实验阶段,能够生成 Geyser 的方块/物品/头颅/信标样式映射,以及针对较为简单的方块、2D 和 3D 物品、音效和信标样式的基岩版资源包。关于 Rainbow 功能的更完整列表,请参阅下文。
Rainbow 的工作原理是检测已加载资源包中的自定义方块(使用方块状态覆盖)以及你背包或已打开的容器/物品栏菜单中的自定义物品。它会分析检测到的物品的组件,并利用已加载的 Java 版资源包中的素材来收集有关方块和物品模型、纹理等信息。
使用方法
你可以在我们的网站上 下载 Rainbow 的最新版本,也可以在 Modrinth 上下载。使用 Rainbow 需要安装 Fabric API。
要使用 Rainbow,你必须将其安装到你的 Minecraft 客户端中。Rainbow 会在客户端中添加一些命令。通常,你可以按照以下方式使用它们:
- 首先,运行
/rainbow create <name>创建一个新的整合包,将<name>替换为你的整合包名称。你的资源包和 Geyser 映射文件将导出到.minecraft/rainbow/<name>文件夹中。该文件夹内的所有内容都可能被覆盖! - 创建好整合包后,你可以开始映射自定义内容。映射后的自定义内容将被包含在导出的资源包和 Geyser 映射文件中。有多种方式可以映射自定义内容:
/rainbow map block <target>- 映射位于<target>处的自定义方块(如果存在)。/rainbow map item- 映射你手中当前持有的自定义物品或头颅(如果存在)。/rainbow map sound <namespace>- 映射给定命名空间下的所有自定义音效。/rainbow map waypoint <waypoint style>- 映射给定的信标样式(如果存在)。/rainbow mapinventory- 扫描你的物品栏中的自定义物品或头颅,并映射所有找到的项目。/rainbow auto blocks- 扫描所有已加载的资源包,查找使用方块状态覆盖创建的自定义方块,并映射所有找到的项目。这可能会导致客户端短暂冻结。/rainbow auto inventory- 扫描你打开的所有物品栏菜单和容器,查找自定义物品和头颅,并映射所有找到的项目。这对于提供列出所有自定义物品的物品栏菜单的插件非常有用。- 使用
/rainbow auto stop停止对自定义物品的映射。
- 使用
/rainbow auto recipes- 扫描所有已知配方,查找结果为自定义物品或头颅的配方,并映射所有找到的项目。这对于包含以自定义物品为结果的配方的数据包非常有用。你可以使用原版命令/recipe give @s *给自己所有配方,这有助于 Rainbow 通过此命令识别自定义物品。/rainbow auto sounds- 扫描所有已加载的资源包中的自定义音效,并映射所有找到的项目。/rainbow auto waypoints- 扫描所有已加载的资源包中的自定义信标样式,并映射所有找到的项目。
- 完成所有自定义物品的映射后,使用
/rainbow finish完成整合包。随后,Rainbow 将导出其创建的资源包和 Geyser 映射文件。
完成整合包后,请导航至 .minecraft/rainbow/<name> 文件夹。你也可以点击聊天中的 Wrote pack to disk 链接以打开此文件夹。
在此文件夹中,你将找到 4 个重要的文件或文件夹:
custom_mappings: 你需要将这些文件放入 Geyser 配置文件夹中的custom_mappings文件夹内。这些是生成的 Geyser 映射文件。pack.zip: 你需要将此文件放入 Geyser 配置文件夹中的packs文件夹内。lang: 你需要将此文件夹中的所有文件放入 Geyser 配置文件夹中的locales/overrides文件夹内。- 如果没有找到任何语言文件,该文件夹可能为空或不存在。这通常不是问题!
report.txt: 你无需对此文件进行任何操作,但它包含了有关生成素材及可能发生的错误的信息。
完成上述步骤后,重启你的服务器。基岩版玩家在加入服务器时应会自动下载生成的整合包, 如果一切顺利,他们应该能够看到(并听到)自定义内容!
如果你有任何问题或遇到任何问题,请随时在 Geyser Discord 中寻求支持!
Rainbow 的功能
Rainbow 目前具备以下功能:
- 为使用方块状态覆盖自定义的方块生成 Geyser 方块映射,支持从已加载的资源包中自动和手动完成。
- 生成包含数据组件和正确基岩版选项的完整 Geyser 物品映射,通过检测具有自定义
minecraft:item_model或minecraft:custom_model_data组件的物品并分析其组件来实现。- 还包括为更复杂的 Java 物品模型定义生成带有谓词的映射,例如检查物品是否损坏。Rainbow 目前支持以下定义类型:
- 普通物品模型定义。
- 条件物品模型,支持的属性包括:
broken(损坏),damaged(受损),custom_model_data(自定义模型数据),has_component(拥有组件),以及fishing_rod/cast(钓竿/抛投)。
- 范围分发物品模型,支持的属性包括:
bundle/fullness(Bundle/满度),count(数量),custom_model_data(自定义模型数据),以及damage(伤害值)。
- 选择物品模型,支持的属性包括:
charge_type(充能类型),trim_material(修饰材料),context_dimension(上下文维度),以及custom_model_data(自定义模型数据)。- 对于
display_context属性,如果存在则映射gui情况。
- 还包括通过查看物品模型来检测物品是否应手持显示的功能。
- 还能够检测并使用“旧式”
custom_model_data范围分发风格的物品进行映射,并将它们映射到 Geyser 的legacy物品映射。 - 还支持可染色物品的映射,但这些物品仅在映射时被染色的情况下才会被检测到。
- 还包括为更复杂的 Java 物品模型定义生成带有谓词的映射,例如检查物品是否损坏。Rainbow 目前支持以下定义类型:
- 为自定义玩家头颅生成 Geyser 头颅映射。
- 为自定义路标样式(定位栏图标)生成 Geyser 路标风格映射。
- 为方块和简单 2D 物品生成简单的基岩版资源包,以及:
- 通过分析物品的
minecraft:equippable组件和已加载的装备资产,生成简单的自定义护甲物品。- 自定义鞘翅物品也有效,但由于基岩版的限制,仅视觉效果有效。
- 通过将 Java 模型转换为基岩版模型,为其生成附加对象和动画,并渲染自定义 GUI 图标,从而支持 3D 物品。
- 能够翻译头部、第一人称和第三人称物品槽位的显示变换。
- 自定义音效。
- 通过分析物品的
- 为仅使用单一纹理的 2D 物品和 3D 物品生成功效良好的动画(翻页)纹理。
- 将已加载资源包中的合并语言文件导出到一个文件夹中,以便轻松复制到 Geyser 的
locales/overrides文件夹。- 来自不同资源包的相同语言的文件会被合并在一起。
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.
下载 Rainbow
下载 Rainbow
下载 Rainbow
下载 Rainbow
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rainbow
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rainbow
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rainbow
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rainbow
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rainbow
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rainbow
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
AE2:一款流行的自动化与存储模组
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧