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.

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
@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! 🎉