Call You By Your Name

# Call You By Your Name 🎯 > A Forge 1.20.1 chat enhancement mod that makes @-mentions loud, clear, and friendly. 💬 ## Feature Highlights ✨ **Ping teammates instantly:** Mention a player with `@playerName` to deliver a highlighted notification and a click-to-reply suggestion that pre-fills chat with their name, plus an optional bell sound. * **Share what you're holding:** Drop `@item` into your message to broadcast your main-hand item with its rarity color, hover tooltip, and (optionally) an inline icon rendered directly in chat. * **Point friends to your location:** Use `@spot` to insert a green "Spot" marker; hovering shows the XYZ of where you were standing when you sent the message. * **Ready-made group calls:** Rally everyone in your dimension with `@here` or nearby allies with `@near`; additional groups can be provided by other mods through the built-in registry hook and sync automatically to clients. * **Client-side clarity:** Color-coded highlighting for players, groups, and special tokens pairs with smart autocompletion, keeping mentions readable and fast to type without interfering with slash commands. !(https://image.qihuang02.cn/file/1761576859636_reply.webp) ## Requirements 📦 * **Minecraft:** Java Edition 1.20.1 * **Loader:** Forge `47.4.10` or newer on both client and server ## Installation 🛠️ 1. Install a compatible Forge profile for Minecraft 1.20.1. 2. Place the CallYouByYourName JAR in your `mods/` folder. 3. Restart Minecraft (or your dedicated server) to load the mod. ## Using Mentions 📚 | Token |What it does |Notes | | ----------- |------------------------------------------------------------------------ |---------------------------------------------------------- | | <code>@playerName</code> |Pings a single player with a golden reminder and clickable reply prompt. |You cannot ping yourself; duplicates are ignored politely. | | <code>@here</code> |Notifies every other player in your current dimension. |Always available to all players. | | <code>@near</code> |Calls allies within a ~32 block radius. |Range checks run per dimension to avoid cross-world noise. | | <code>@item</code> |Shares your held item with tooltip info (and an inline icon if enabled). |Cancels the message and warns you if your hand is empty. | | <code>@spot</code> |Inserts a highlighted "Spot" link that shows your XYZ on hover. |Great for pointing friends to your current location. | > 💡 Tip: The chat will tell you how many seconds remain if you hit the mention cooldown. ## Client Experience 🌈 * Mention colors adapt to players, groups, shared items, and spot markers so you can scan conversations at a glance. * Autocomplete surfaces group tokens, custom registry entries, and online players, but hides automatically while you type commands that start with `/`. * Item mentions can render a scaled version of the item icon inline with the chat line while preserving hover hitboxes for easy inspection. * Mention tokens from servers (or other mods) are synchronized automatically when you join, keeping everyone in step without a restart. ## Configuration ⚙️ The first launch creates `config/CallYouByYourName-common.toml`. Tweak the following options: * `mentionCooldownMs` – Minimum delay between mentions sent by the same player (default `5000`). Set to `0` to disable the check. * `enableMentionSound` – Whether to play the bell sound when a player is pinged (default `true`). * `renderItemTextures` – Toggle rendering of inline item icons in chat (default `true`). Reload the config or restart Minecraft to apply changes. ## Troubleshooting 🧰 * **"I can't use a group mention"** – Some third-party groups may require extra permissions; you'll receive a red warning if access is denied. * **"Why don't I see suggestions?"** – Mention autocomplete only appears in standard chat and hides during command input. * **"Item sharing failed"** – Make sure something is in your main hand before typing `@item`; the mod cancels the message otherwise. Have fun calling your friends by their names! 🎉