ProximityChat!

Features

• Dynamic Distance Logic – Chat visibility is strictly based on player coordinates, creating a realistic local chat environment.
• Smooth RGB Text Fading – Messages gradually darken (from White to Dark Gray) pixel-by-pixel as the distance increases, powered by Hex color codes.
• Smart Fade Threshold – Configurable "start percentage" option (e.g., keep the message fully white for the first 20% of the distance before it starts fading).
• Shout Mechanic – Broadcast messages to a wider area (default: 200 blocks) using the ! prefix.
• Whisper Mechanic – Share secrets in a very tight radius (default: 5 blocks) using the # prefix.
• Immersive Sound Effects – specific sounds play when receiving normal chat, shouts, or whispers to alert players.
• Advanced Mute System – Moderators can mute players permanently or temporarily (e.g., 10m, 1h, 2d).
• Admin Spy Mode – Staff with permission can toggle "Spy Mode" to read all local chats globally, regardless of distance.
• Anti-Spam Cooldown – 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 help – Displays a comprehensive list of all available commands and their descriptions.
• /pchat info – Shows current plugin version, developer information, and status.
• /pchat reload – Instantly refreshes the config.yml file to apply changes without a server restart.
• /pchat spy – Toggles Admin Spy Mode, allowing staff to monitor all local conversations globally.
• /pchat mute [time] – Restricts a player from sending proximity messages. Supports permanent mutes or timed durations (e.g., 1h, 30m).
• /pchat unmute – 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.