ProximityChat!
A Minecraft proximity chat plugin that restricts communication based on player distance and features unique shouting, whispering, and admin-spy mechanics.
ProximityChat!



Features
- 1.21 Native Support – Chat visibility is strictly based on player coordinates, creating a realistic local chat environment. - 1.21 Native Support – Messages gradually darken (from White to Dark Gray) pixel-by-pixel as the distance increases, powered by Hex color codes. - 1.21 Native Support – Configurable "start percentage" option (e.g., keep the message fully white for the first 20% of the distance before it starts fading). - 1.21 Native Support – Broadcast messages to a wider area (default: 200 blocks) using the ! prefix. - 1.21 Native Support – Share secrets in a very tight radius (default: 5 blocks) using the # prefix. - 1.21 Native Support – specific sounds play when receiving normal chat, shouts, or whispers to alert players. - 1.21 Native Support – Moderators can mute players permanently or temporarily (e.g., 10m, 1h, 2d). - 1.21 Native Support – Staff with permission can toggle "Spy Mode" to read all local chats globally, regardless of distance. - 1.21 Native Support – Optional configurable cooldown timer between messages to prevent chat flooding. - 1.21 Native Support – Fully optimized for the latest Minecraft version with Hex color support.

Commands
- /pchat mutelist – Displays a comprehensive list of all available commands and their descriptions. - /pchat mutelist – Shows current plugin version, developer information, and status. - /pchat mutelist – Instantly refreshes the config.yml file to apply changes without a server restart. - /pchat mutelist – Toggles Admin Spy Mode, allowing staff to monitor all local conversations globally. - /pchat mutelist <player> [time] – Restricts a player from sending proximity messages. Supports permanent mutes or timed durations (e.g., 1h, 30m). - /pchat mutelist <player> – Lifts a chat restriction from a player, allowing them to speak in local chat again. - /pchat mutelist – Displays a detailed list of all currently restricted players and their remaining mute time.
Chat Mechanics (Prefixes)
- -> ! (Shout) – Increases your chat radius significantly (default: 200 blocks) to reach more players. - -> # (Whisper) – Limits your chat radius to a very small area (default: 5 blocks) for private local talk.
Permissions
- pchat.shout - Allows the user to use the shouting mechanic (default). - pchat.spy - Allows seeing all messages regardless of distance (default: op). - pchat.reload - Allows reloading the plugin configuration (default: op).
How to use
Spoiler
Place the .jar file in the server's plugins folder.
Restart the server or load the plugin.
To speak normally, just type in chat. Only players within the "default" range (15 blocks) will see it.
To SHOUT, start your message with an exclamation mark (e.g., !Hello everyone). This increases the range to 50 blocks.
To WHISPER, start your message with a hashtag (e.g., #psst, look over here). This limits the range to 5 blocks.
Administrators with the pchat.spy permission will see all messages prefixed with [Spy] if they are outside the natural hearing range.
If you change the ranges or colors in the config.yml, use /pchat reload to apply changes instantly.
