Call You By Your Name

用你的名字呼唤你 🎯

一款适用于 Forge 1.20.1 的聊天增强模组，让 @提及醒目清晰又友好。💬

功能亮点 ✨

即时呼叫队友：提及玩家时使用 @playerName，即可发送醒目的通知，并显示可点击的回复建议，点击后会将对方名字填入聊天框；还可以选择播放铃声。

• 分享手持物品：在消息中插入 @item，即可展示主手物品的稀有度颜色和悬停提示；还可选择在聊天中直接显示物品图标。
• 告诉好友你的位置：使用 @spot插入绿色的“位置”标记；悬停即可查看你发送消息时所在位置的 XYZ 坐标。
• 现成的群组呼叫：使用 @here呼叫当前维度中的所有人，或使用 @near呼叫附近的盟友；其他模组可通过内置注册接口提供更多群组，并自动同步到客户端。
• 客户端显示更清晰：玩家、群组和特殊标记均以不同颜色高亮，并支持智能自动补全，让提及内容清晰易读、输入更快捷，同时不影响斜杠命令。

运行要求 📦

• Minecraft：Java 版 1.20.1
• 加载器：客户端和服务器均需安装 Forge 47.4.10或更新版本

安装方法 🛠️

1. 为 Minecraft 1.20.1 安装兼容的 Forge 配置文件。
2. 将 CallYouByYourName JAR 文件放入 mods/文件夹。
3. 重启 Minecraft（或专用服务器）以加载模组。

提及用法 📚

| 标记 |作用 |备注 |
| ———– |———————————————————————— |———————————————————- |
| @playerName |用金色提醒和可点击的回复提示呼叫单个玩家。 |不能呼叫自己；重复提及会被礼貌地忽略。 |
| @here |通知当前维度中的所有其他玩家。 |所有玩家均可使用。 |
| @near |呼叫约 32 格范围内的盟友。 |按维度检查范围，避免干扰其他世界的玩家。 |
| @item |分享手持物品及其提示信息（启用后还会显示行内图标）。 |如果主手为空，会取消发送并提示你。 |
| @spot |插入醒目的“位置”链接，悬停后可查看 XYZ 坐标。 |方便告诉好友你当前所在的位置。 |

💡 提示：如果触发了提及冷却，聊天会告知剩余秒数。

客户端体验 🌈

• 提及颜色会根据玩家、群组、分享的物品和位置标记而变化，让你一眼就能看清聊天内容。
• 自动补全会显示群组标记、自定义注册项和在线玩家；但当你输入以 /开头的命令时，会自动隐藏。
• 物品提及可以在聊天行内显示缩放后的物品图标，同时保留悬停区域，方便查看物品信息。
• 加入服务器时，服务器（或其他模组）提供的提及标记会自动同步，所有人都能保持一致，无需重启。

配置 ⚙️

首次启动时会创建 config/CallYouByYourName-common.toml。可调整以下选项：

• mentionCooldownMs – 同一玩家连续发送提及之间的最短间隔（默认 5000）。设置为 0即可停用检查。
• enableMentionSound – 玩家被呼叫时是否播放铃声（默认 true）。
• renderItemTextures – 开启或关闭聊天中的行内物品图标渲染（默认 true）。

重新加载配置或重启 Minecraft 以应用更改。

故障排查 🧰

• “我无法使用群组提及” – 某些第三方群组可能需要额外权限；如果你没有访问权限，会收到红色警告。
• “为什么我看不到建议？” – 提及自动补全仅会在标准聊天中显示，输入命令时则会隐藏。
• “物品分享失败” – 输入 @item 前，请确保主手里拿着物品；否则模组会取消发送消息。

尽情用名字呼唤你的朋友吧！🎉