Talk locally, announce globally — ProximityChat makes immersive local chat the default, with a simple toggle for global communication.

📢 ProximityChat

ProximityChat makes communication feel natural and immersive by introducing local chat as the default style. Messages are only heard by players within a configurable radius, creating a sense of closeness and realism. For broader announcements, players can toggle into global chat mode, broadcasting to everyone in a chosen color.

✨ Core Features

Local (Proximity) Chat
- Players hear messages only if they’re within a configurable radius.
- Encourages realistic, community‑style conversations.
- Admins can enable spy mode to monitor all local chat regardless of distance.
Global Chat Toggle
- /global toggle lets players switch between local and global chat.
- Global messages are styled with configurable colors for visibility.
- Perfect for server‑wide announcements or roleplay events.
Nicknames & Prefixes
- /nick and /prefix commands allow personalized names and tags.
- Supports Minecraft color codes (&a, &b, etc.) for vibrant customization.
- Configurable permissions: OP‑only, whitelist, or everyone.
- Persistent storage ensures nicknames and prefixes survive server restarts.
Name Colors
- /nc <color> changes your name color safely, with validation to prevent broken formatting.
- /pc color shows a clickable chart of available color codes.
Help & Reference
- /pc help provides a clear, color‑coded menu of all commands.
- /pc color displays hover‑to‑copy codes for quick customization.

🛡️ Admin Tools

Spy Mode: /spy lets OPs monitor all local chat and whispers.
Prefix Whitelist: Manage who can use /prefix with /pc whitelist.
Config Options: Adjust chat radius, default colors, prefix format, and permissions in proximitychat.toml.
Safe Defaults: Invalid config values fall back to safe defaults to prevent crashes.

🎮 Supporting Features

Unified Whisper System
- /w, /tell, and /msg are replaced with ProximityChat’s whisper .
- Target sees a styled whisper, sender gets confirmation, nearby players see a subtle alert, and OPs in spy mode see the full message.
- Vanilla whisper commands are fully disabled to ensure consistency.

📌 Summary

ProximityChat is built around immersive local chat with the flexibility of global chat toggling. Players enjoy realistic communication, while server owners retain full control over permissions, formatting, and safety. Whispers, nicknames, prefixes, and name colors round out the experience, making ProximityChat a complete drop‑in replacement for vanilla chat.