ReadMyItem

ReadMyItem

在任何物品栏中悬停一个物品，会用巴西葡萄牙语读出其名称和描述。专为还在学习阅读的孩子设计：语音内置在JAR包中，无需额外下载，也无需在电脑上启动任何程序。

中文翻译

English

在任意物品栏中悬停一个物品，游戏会用巴西葡萄牙语读出其名称和描述。专为还在学习阅读的孩子打造：语音已内置在 jar 包中，无需额外下载，也不会在电脑上启动任何程序。

功能说明

当孩子打开箱子、玩家物品栏、熔炉、创造模式或任何其他容器，并将鼠标悬停在物品上时，游戏会用巴西葡萄牙语读出名称。如果光标停留时间稍长，还会读出描述（附魔、耐久度等）。

语音使用 Minecraft 进程内的 Piper TTS。该模组不会在电脑上运行额外程序，不需要麦克风，也不使用 Whisper。

原版悬浮提示已经显示名称，语音是额外的辅助。

环境要求

语音支持 Windows 64 位、Linux 64 位、macOS Intel 和 Apple Silicon。

安装方法

  1. 为 Minecraft 1.21.11 安装 Fabric。
  2. 将 Fabric API 和 ReadMyItem-….jar 放入 mods 文件夹。
  3. 可选但推荐：同时加入 Mod Menu 和 Cloth Config。
  4. 启动游戏，打开任意物品栏，悬停物品，等待大约半秒。无需下载语音。

首次启动时，模组会将 jar 包中内置的 Piper 文件复制到 config/itemnarrator/voices/pt_BR/。这只是文件复制，不是启动程序。官方语音：Faber（默认）和 Edresson。

使用方法

  1. 打开任意物品栏（玩家、箱子、熔炉、创造、村民、潜影盒……）。
  2. 将鼠标悬停在物品上，等待约 0.5 秒。
  3. 游戏会读出名称（如果数量不止一个，也会读出数量）。
  4. 如果鼠标再停留约一秒，会读出描述。
  5. 将 Minecraft 的语言设置为葡萄牙语（巴西），让原版物品名称显示为葡萄牙语。模组界面始终为 pt-BR。

按键（默认均未绑定；可在“控制”中设置）：

  • 开关模组
  • 重复朗读上一个物品
  • 停止语音

模组不会做什么

  • 不会运行 piper.exe 或任何其他系统程序
  • 不需要麦克风
  • 不使用 Whisper / faster-whisper / 语音指令
  • 不读取世界中的方块、聊天、书本或告示牌
  • 不会带来 PvP 优势：它只朗读屏幕上已有的内容

如果遇到问题

问题 解决方法
名称显示了，但没有语音 等待首次启动时的语音解压。检查日志中的 ReadMyItem。
没有任何反应 确认模组已启用，并且游戏音量中的语音 / 主音量没有静音。
日志中出现 Native / Piper 错误 你的操作系统可能不受支持。游戏仍可运行，只是语音会关闭。
语音是英语 将 Minecraft 语言设为**葡萄牙语（巴西）**以获取物品名称。

许可证

GPL-3.0-or-later，因为进程内 Piper（piper-jni + Piper natives）在合并的 jar 包中遵循 GPL 许可。 语音模型：MIT 许可，归 Rhasspy / Faber 和 Edresson 作者所有。

葡萄牙语（巴西）

在任意物品栏中将鼠标悬停在物品上，游戏会用巴西葡萄牙语读出名称和描述。专为还在学习阅读的孩子打造：语音已内置在 jar 包中，无需额外下载，也不会在电脑上打开任何程序。

功能说明

当孩子打开箱子、玩家物品栏、熔炉、创造模式或任何其他容器，并将鼠标悬停在物品上时，游戏会读出名称（巴西葡萄牙语）。如果光标停留时间稍长，还会读出描述（附魔、耐久度等）。

语音使用 Minecraft 进程内的 Piper TTS。该模组不会在电脑上执行程序，不需要麦克风，也不使用 Whisper。

原版悬浮提示已经显示名称，语音是额外的辅助。

你需要什么

支持语音的系统：Windows 64 位、Linux 64 位、macOS Intel 和 Apple Silicon。

安装方法

  1. 为 Minecraft 1.21.11 安装 Fabric。
  2. 将 Fabric API 和 ReadMyItem-….jar 放入 mods 文件夹。
  3. 可选但推荐：同时加入 Mod Menu 和 Cloth Config。
  4. 打开游戏，打开任意物品栏，将鼠标悬停在物品上，等待约半秒。无需下载语音。

首次运行时，模组会将 jar 包中的 Piper 文件复制到 config/itemnarrator/voices/pt_BR/。这不是执行程序。官方语音：Faber（默认）和 Edresson。

使用方法

  1. 打开任意物品栏（玩家、箱子、熔炉、创造、村民、潜影盒……）。
  2. 将鼠标悬停在物品上，等待约 0.5 秒。
  3. 游戏会读出名称（如果数量不止一个，也会读出数量）。
  4. 如果鼠标再停留约一秒，会读出描述。
  5. 将 Minecraft 的语言设置为葡萄牙语（巴西），让物品名称显示为葡萄牙语。模组界面本身就是 pt-BR。

按键（全部默认无快捷键；可以在“控制”中设置）：

  • 开启/关闭模组
  • 重复上一个物品
  • 停止语音

模组不会做什么

  • 不会执行 piper.exe 或 Windows/Linux/macOS 的任何程序
  • 不需要麦克风
  • 不使用 Whisper / faster-whisper / 语音指令
  • 不读取世界中的方块、聊天、书本或告示牌
  • 不会在 PvP 中获得优势：只读取屏幕上已有的内容

如果遇到问题

问题 解决方法
名称显示了，但没有语音 等待首次打开时的语音解压。查看 ReadMyItem 日志。
没有任何反应 确认模组已启用，并且游戏音量中的语音 / 主音量没有静音。
日志中出现 Native / Piper 错误 你的系统可能不在支持列表中。游戏仍可运行，只是语音会关闭。
语音是英语 将 Minecraft 语言设为**葡萄牙语（巴西）**以获取物品名称。