SmartChat
SmartChat 是一款面向 Minecraft 服务器的现代化通信框架,注重沉浸感与性能。它用本地化距离感知系统取代了传统的全球聊天模式,并辅以专用频道和基于 NBT 的深度交互功能。
核心特性
沉浸式距离感知与气泡
默认情况下,玩家间的通信被限制在可配置的半径范围内,从而减少全局噪音并鼓励自然的互动。
- 3D 聊天气泡: 消息以
TextDisplay 实体的形式渲染在说话者头顶上方。
- 智能追踪: 气泡会实时跟随玩家移动,并在玩家下线时自动清理。
- 空间逻辑: 如果你说话但范围内无人收听,系统将提示“无听众”。
深度交互性
SmartChat 利用 Adventure API 提供丰富且支持悬停的界面,无需使用笨拙的传统格式化方式。
- NBT 物品链接: 使用
[item] 标签分享你的装备。悬停即可查看完整的附魔、描述文本(lore)及 NBT 数据。
- 玩家状态卡片: 悬停在用户名或
@提及 上时,将显示实时的生命值、延迟(ping)及总游戏时长。
- 安全 URL 链接: 链接会被识别并使用自定义的青色样式进行格式化,同时带有注重安全性的悬停警告。
高级社交框架
- 邀请制小队: 正式的邀请/接受/拒绝流程,防止未经请求的小队加入。
- 持久化存储: 基于 SQLite 的屏蔽列表和邮件系统,确保社交偏好和消息在服务器重启后得以保留。
- 离线邮件: 发送给离线玩家的私信将在其重新上线的瞬间触发通知。
管理与行政工具
- 启发式垃圾信息拦截: 使用莱文斯坦距离(Levenshtein distance)计算来防止重复发送消息和“模拟”垃圾信息。
- 员工窥探(Staff Spy): 管理员可以通过格式化的
[发送者 -> 接收者] 头部监控私人耳语和小队聊天。
- 智能过滤: 包含自动大写纠正以及支持正则表达式的脏话过滤。
命令参考
通用通信
| 命令 |
用法 |
描述 |
/s |
/s |
将当前活跃频道切换为 距离感知聊天。 |
/g |
/g [message] |
切换 全球聊天 或发送单条全球消息。 |
/t |
/t [message] |
切换 交易聊天 或发送单条交易消息。 |
/w |
/w <player> <msg> |
发送私人耳语或 离线邮件。 |
/r |
/r <message> |
快速回复最近向你发送耳语的人。 |
/mail |
/mail |
读取并清除你存储的离线消息。 |
/mention |
/mention toggle |
启用或禁用提及声音通知。 |
社交与管理
| 命令 |
用法 |
描述 |
/pinv |
/pinv <player> |
向特定玩家发送小队邀请。 |
/p |
/p accept |
加入你收到的邀请。 |
/p |
/p deny |
拒绝待处理的小队邀请。 |
/p |
/p <message> |
向当前小队发送消息。 |
/pleave |
/pleave |
离开当前小队;如果是队长则解散小队。 |
/ignore |
/ignore <player> |
屏蔽来自某用户的所有聊天、提及和耳语。 |
/unignore |
/unignore <p> |
恢复与之前被屏蔽用户的通信。 |
员工与管理员
| 命令 |
用法 |
权限 |
/chat spy |
/chat spy |
切换私人耳语和小队聊天的可见性。 |
/chat help |
/chat help |
查看游戏内命令目录。 |
配置与权限
SmartChat 设计为“即插即用”。首次运行时,将生成一个 config.yml 文件,允许你自定义聊天半径、前缀颜色及冷却时间。
关键权限:
smartchat.spy — 管理员窥探模式所需。
smartchat.global — 访问全球频道。
smartchat.trade — 访问交易频道。
smartchat.bypass — 绕过所有聊天过滤器、冷却时间及垃圾信息拦截。
? 支持与错误报告
发现了错误或需要帮助设置插件?
直接在 Discord 上报告问题。
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.
? Support & Bug Reports
Found a bug or need help setting up the plugin?
Report issues directly on Discord.
评论 0
登录后参与评分
还没有评论,来抢沙发吧