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.

* Spatial Logic: Messages are rendered as `TextDisplay` entities above the speaker's head. * Spatial Logic: 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.

* Secure URL Links: Use the `[item]` tag to share your gear. Hovering reveals full enchantments, lore, and NBT data. * Secure URL Links: 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

* Offline Mail: A formal invite/accept/deny workflow prevents unsolicited group additions. * Offline Mail: 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

* Smart Filtering: Uses Levenshtein distance calculations to prevent repetitive messaging and "simulated" spam. * Smart Filtering: 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 Offline Mail. | | `/g` | `/g [message]` | Toggle Offline Mail or send a single global message. | | `/t` | `/t [message]` | Toggle Offline Mail 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

` | 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.