SmartChat

# 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 `` 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 `` 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 ` | Toggle **Global Chat** or send a single global message. | | `/t` | `/t ` | 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. <div align="center"> <div style=" max-width: 420px; padding: 20px; border-radius: 16px; background: rgba(88,101,242,0.08); border: 1px solid rgba(88,101,242,0.3); "> <h2>🛠 Support & Bug Reports</h2> <p style="opacity:0.85;"> Found a bug or need help setting up the plugin?<br> Report issues directly on Discord. </p> <br> <a href="https://discord.com/users/530425932947783692"> <img src="https://img.shields.io/badge/Report%20Bugs%20on%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white"> </a> </div> </div>