SmartChat

SmartChat is a modern communication framework for Minecraft servers that prioritizes immersion and performance. It replaces the traditional global chat model with a localized proximity system, supplemented by specialized channels and deep NBT-based interactivity.

Core Features

Immersive Proximity & Bubbles

By default, player communication is limited to a configurable radius, reducing global noise and encouraging organic interaction.

• 3D Chat Bubbles: Messages are rendered as TextDisplay entities above the speaker's head.
• Intelligent Tracking: Bubbles follow player movement in real-time and automatically clean up upon logout.
• Spatial Logic: Includes a "no listeners" notification if you speak and no one is within range to hear you.

Deep Interactivity

SmartChat utilizes the Adventure API to provide a rich, hover-sensitive interface without the use of clunky legacy formatting.

• NBT Item Linking: Use the [item] tag to share your gear. Hovering reveals full enchantments, lore, and NBT data.
• Player Stat Cards: Hovering over a username or @mention displays real-time health, ping, and total playtime.
• Secure URL Links: Links are identified and formatted with custom aqua styling and security-conscious hover warnings.

Advanced Social Framework

• Invite-Only Parties: A formal invite/accept/deny workflow prevents unsolicited group additions.
• Persistence: SQLite-backed ignore lists and mail ensure that social preferences and messages survive server restarts.
• Offline Mail: Direct messages sent to offline players trigger a notification the moment they return to the server.

Moderation & Administrative Tools

• Heuristic Spam Blocking: Uses Levenshtein distance calculations to prevent repetitive messaging and "simulated" spam.
• Staff Spy: Admins can monitor private whispers and party chats with a formatted [Sender -> Receiver] header.
• Smart Filtering: Includes auto-caps correction and regex-supported profanity filtering.

---

Command Reference

General Communication

Command	Usage	Description
/s	/s	Switch your active channel to Proximity Chat.
/g	/g [message]	Toggle Global Chat or send a single global message.
/t	/t [message]	Toggle Trade Chat or send a single trade message.
/w	/w <player> <msg>	Send a private whisper or Offline Mail.
/r	/r <message>	Quick-reply to the last person who whispered you.
/mail	/mail	Read and clear your stored offline messages.
/mention	/mention toggle	Enable or disable mention sound notifications.

Social & Management

Command	Usage	Description
/pinv	/pinv <player>	Send a party invite to a specific player.
/p	/p accept	Join a party you have been invited to.
/p	/p deny	Decline a pending party invitation.
/p	/p <message>	Send a message to your current party.
/pleave	/pleave	Leave your current party or disband it if leader.
/ignore	/ignore <player>	Block all chat, mentions, and whispers from a user.
/unignore	/unignore <p>	Restore communication with a previously blocked user.

Staff & Admin

Command	Usage	Permission
/chat spy	/chat spy	Toggle visibility of private whispers and party chats.
/chat help	/chat help	View the in-game command directory.

---

Configuration & Permissions

SmartChat is designed to be "plug-and-play." Upon first run, a config.yml will be generated allowing you to customize chat radiuses, prefix colors, and cooldown timers.

Key Permissions:

• smartchat.spy — Required for Admin Spy mode.
• smartchat.global — Access to the Global channel.
• smartchat.trade — Access to the Trade channel.
• smartchat.bypass — Bypasses all chat filters, cooldowns, and spam blocks.