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.

Clickable reply suggestion in chat

Requirements 📦

Minecraft: Java Edition 1.20.1
Loader: Forge 47.4.10 or newer on both client and server

Installation 🛠️

Install a compatible Forge profile for Minecraft 1.20.1.
Place the CallYouByYourName JAR in your mods/ folder.
Restart Minecraft (or your dedicated server) to load the mod.

Using Mentions 📚

Token	What it does	Notes
`@playerName`	Pings a single player with a golden reminder and clickable reply prompt.	You cannot ping yourself; duplicates are ignored politely.
`@here`	Notifies every other player in your current dimension.	Always available to all players.
`@near`	Calls allies within a ~32 block radius.	Range checks run per dimension to avoid cross-world noise.
`@item`	Shares your held item with tooltip info (and an inline icon if enabled).	Cancels the message and warns you if your hand is empty.
`@spot`	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! 🎉