1-1. 简介

ItemRarityGUI(物品稀有度)是一款 Minecraft Forge 1.20.1 客户端 MOD,根据物品 ID 为物品栏、背包、创造模式中的物品添加对应颜色的背景,提升视觉体验。

支持 6 种颜色,可配置透明背景。使用 Forge Config 动态配置,修改后无需重启游戏。MOD 启动时自动显示「曙光征途 · 曙光团队」署名信息。

所有代码已在 GitHub 开源,采用 MIT License,欢迎社区贡献。

1-2. 配置说明

配置文件位于游戏目录 config/itemraritygui.toml,首次启动游戏时自动生成。无需任何服务器插件,所有配置在客户端本地完成。

配置格式为 TOML,每行一条物品颜色映射:

config/itemraritygui.toml
# 物品颜色映射 # 格式: "minecraft:物品ID:颜色名称" # 颜色名称支持中文或英文 [general] itemColors = [ "minecraft:netherite_sword":, # 下界合金剑 → 紫色 "minecraft:diamond_sword":, # 钻石剑 → 蓝色 "minecraft:iron_sword":, # 铁剑 → 白色 "minecraft:emerald":绿, # 绿宝石 → 绿色 "minecraft:golden_apple":, # 金苹果 → 橙色 "minecraft:apple": # 苹果 → 红色 ]

1-3. 颜色配置

支持以下颜色名称,中英文均可使用:

紫色 / Purple
Zi
蓝色 / Blue
Lan
白色 / White
Bai
绿色 / Green
Lv
橙色 / Orange
Cheng
红色 / Red
Hong

同时支持配置透明背景颜色,满足不同视觉效果需求。颜色名称在配置文件中不区分大小写。

1-4. 安装指南

安装 Minecraft 1.20.1 Forge

下载并安装 Minecraft 1.20.1 版本的 Forge Mod Loader。

下载 MOD 文件

从 GitHub Releases 页面下载 itemraritygui-*.jar 文件。

放入 MOD 文件夹

将 JAR 文件放入 .minecraft/mods/ 目录。

启动游戏

使用 Forge 1.20.1 配置文件启动游戏,首次启动后会自动在 config/itemraritygui.toml 生成默认配置文件。

编辑配置

编辑配置文件,添加需要着色显示的物品 ID 和对应颜色。保存后自动生效。