✨ 功能列表 ✨
- ✅ AI 助手 — 集成 Gemini、Grok、Groq 或 OpenRouter 作为服务器助手(
@ai)。包含上下文记忆、数据库缓存和速率限制。
- ✅ 聊天频道 — 创建无限数量的频道(全球、本地、员工等),支持自定义收听半径、冷却时间和消息费用。
- ✅ 聊天气泡 — 使用 1.19.4+ 的 TextDisplay 实体在玩家头顶显示浮动消息气泡,支持自定义动画和样式。
- ✅ 动态令牌与标签 — 交互式聊天占位符,如
[item]、[inv]、[hp]、[ping]、[pos] 和 [target],支持悬停提示框和点击操作。
- ✅ 高级格式化 — 完全支持 MiniMessage、传统颜色代码以及 HEX/渐变,并提供细粒度的权限控制。
- ✅ 提及系统 — 可 Ping 玩家(
@Player)、角色(@role)或 @everyone,并支持自定义音效和粒子效果。
- ✅ 聊天审核 — 内置反垃圾邮件、反大写、反链接功能,以及带有 Leetspeak 绕过检测的智能词过滤器。
- ✅ 经济支持 — 对特定频道的消息发送收取费用(支持 Vault 和 PlayerPoints)。
- ✅ DiscordSRV 集成 — 无缝连接 Minecraft 聊天频道与 Discord 文本频道。
- ✅ 社交间谍 — 为员工提供实时监听本地聊天、私聊和受限频道的功能。
- ✅ 私聊系统 — 功能完整的
/msg 和 /reply 命令,并附带 /ignore 和 /ignoreall 系统。
- ✅ 自定义死亡信息 — 根据伤害来源和实体类型配置死亡信息,支持悬停/点击事件。
- ✅ PlaceholderAPI 支持 — 在聊天格式中使用交互式占位符,并支持外部 PAPI 占位符。
- ✅ 双数据库支持 — 使用扁平文件 JSON 或 SQLite 保存用户数据。
- ✅ 自动更新器 — 内置 Modrinth 更新检查器,确保您的服务器保持最新状态。
- ✅ 插件 API — 高度可扩展的 ChatProcessor 管道和 AddonManager,专为开发者设计。
? 开发者 API
StellarChat 为开发者提供了 API。请将 {VERSION} 替换为纯数字插件版本(例如 1.0.0,不要包含 "Beta" 或其他文字)。
Maven:
<dependency>
<groupId>io.github.klaidi4dev</groupId>
<artifactId>stellarchat-api</artifactId>
<version>{VERSION}</version>
<scope>provided</scope>
</dependency>
Gradle (Groovy):
dependencies {
compileOnly 'io.github.klaidi4dev:stellarchat-api:{VERSION}'
}
Gradle (Kotlin DSL):
dependencies {
compileOnly("io.github.klaidi4dev:stellarchat-api:{VERSION}")
}
? 命令
? 用户命令
/stellarchat help (别名: /sc, /schat) - 显示帮助信息
/msg <player> <message> (别名: /tell, /w, /m) - 发送私聊消息
/reply <message> (别名: /r) - 回复上一条私聊消息
/ignore <player> - 忽略/取消忽略特定玩家
/ignoreall - 切换忽略所有私聊消息
/global [message] (别名: /g) - 发送消息或切换到全球频道
/local [message] (别名: /l) - 发送消息或切换到本地频道
? 管理员与员工命令
/stellarchat reload - 重新加载所有插件配置
/stellarchat togglechat (别名: /tchat) - 切换全局聊天静音
/stellarchat broadcast <message> (别名: /bc) - 向服务器广播消息
/stellarchat spy - 切换社交间谍模式
/staff [message] (别名: /sc) - 发送消息或切换到员工频道
? AI 命令
/ai <question> (别名: /ask) - 向 AI 助手提问
? 依赖项
软依赖项(可选但推荐):
- PlaceholderAPI(用于聊天格式中的自定义占位符)
- LuckPerms(用于基于组的格式化和提及)
- Vault(用于频道消息费用)
- PlayerPoints(用于替代经济系统的消息费用)
- DiscordSRV(用于跨聊天集成)
必需依赖项:
? 占位符
您可以通过其他插件(如记分板或标签页列表)中的 PlaceholderAPI 使用以下占位符:
%stellarchat_channel% — 返回玩家当前激活的频道 ID
%stellarchat_channel_prefix% — 返回当前频道的格式化前缀
%stellarchat_last_message% — 返回玩家最后发送的消息
%stellarchat_mentions% — (即将推出)活动提及的数量
%stellarchat_reply_target% — 返回当前正在回复的玩家名称
%stellarchat_spy_enabled% — 根据间谍状态返回 "Yes" 或 "No"
? 权限
格式化权限
stellarchat.format.legacy — 允许使用 &a、&l 等传统颜色代码
stellarchat.format.hex — 允许使用 &#RRGGBB HEX 颜色
stellarchat.format.custom_hex — 允许使用 Kyori <#RRGGBB> HEX 颜色
stellarchat.format.minimessage — 允许使用 MiniMessage <gradient>、<rainbow> 等语法
动态令牌与标签
stellarchat.tag.item — 允许使用 [item]
stellarchat.tag.offhand — 允许使用 [offhand]
stellarchat.tag.helmet — 允许使用 [helmet]
stellarchat.tag.discord — 允许使用 [discord]
stellarchat.token.hp — 允许使用 [hp]
stellarchat.token.pos — 允许使用 [pos]
stellarchat.token.ping — 允许使用 [ping]
stellarchat.token.target — 允许使用 [target]
绕过权限
stellarchat.bypass.togglechat — 在全局聊天静音时仍可发言
stellarchat.bypass.ignore — 向忽略你的玩家发送消息
stellarchat.bypass.length — 绕过最大消息长度限制
stellarchat.bypass.cooldown — 绕过频道冷却时间
stellarchat.bypass.cost — 免费在付费频道中发送消息
stellarchat.bypass.links — 绕过反链接过滤器
stellarchat.bypass.spam — 绕过反垃圾信息过滤器
stellarchat.bypass.caps — 绕过大写限制过滤器
stellarchat.bypass.filter — 绕过脏话过滤器
通用功能
stellarchat.command — 基础命令权限
stellarchat.spy — 读取半径外本地频道的消息
stellarchat.channel.<name> — 访问受限频道(例如:stellarchat.channel.staff)
stellarchat.mention.everyone — 允许 @everyone 提及所有人
stellarchat.mention.role.<group> — 允许提及特定的 LuckPerms 用户组
stellarchat.mention.bypasscooldown — 绕过提及冷却时间
AI 权限
stellarchat.ai.use — 允许向 AI 提问
stellarchat.ai.limit.<group> — 应用特定速率限制(例如:stellarchat.ai.limit.vip)
stellarchat.ai.bypass — 绕过所有 AI 速率限制
✨ Feature List ✨
- ✅ AI Assistant — Integrate Gemini, Grok, Groq, or OpenRouter as a server assistant (
@ai). Includes context memory, database caching, and rate limiting.
- ✅ Chat Channels — Create unlimited channels (Global, Local, Staff, etc.) with custom hearing radius, cooldowns, and message costs.
- ✅ Chat Bubbles — Floating message bubbles above players' heads using 1.19.4+ TextDisplay entities with customizable animations and styling.
- ✅ Live Tokens & Tags — Interactive chat placeholders like
[item], [inv], [hp], [ping], [pos], and [target] with hover tooltips and click actions.
- ✅ Advanced Formatting — Full support for MiniMessage, Legacy color codes, and HEX/Gradients with granular permissions.
- ✅ Mention System — Ping players (
@Player), roles (@role), or @everyone with customizable sounds and particle effects.
- ✅ Chat Moderation — Built-in Anti-Spam, Anti-Caps, Anti-Links, and a Smart Word Filter with Leetspeak bypass detection.
- ✅ Economy Support — Charge players for sending messages in specific channels (supports Vault & PlayerPoints).
- ✅ DiscordSRV Integration — Seamlessly link your Minecraft chat channels with Discord text channels.
- ✅ Social Spy — Real-time monitoring of local chats, private messages, and restricted channels for staff.
- ✅ Private Messaging System — Fully featured
/msg and /reply with an /ignore and /ignoreall system.
- ✅ Custom Death Messages — Configurable death messages based on damage causes and entity types with hover/click event support.
- ✅ PlaceholderAPI Support — Interactive placeholders within chat formats and support for external PAPI placeholders.
- ✅ Dual Database Support — Save user data using flat-file JSON or SQLite.
- ✅ Auto-Updater — Built-in Modrinth update checker to keep your server up to date.
- ✅ Addon API — Highly extensible ChatProcessor pipeline and AddonManager for developers.
? Developer API
StellarChat provides an API for developers. Replace {VERSION} with the numeric plugin version only (e.g., 1.0.0, without "Beta" or other text).
Maven:
<dependency>
<groupId>io.github.klaidi4dev</groupId>
<artifactId>stellarchat-api</artifactId>
<version>{VERSION}</version>
<scope>provided</scope>
</dependency>
Gradle (Groovy):
dependencies {
compileOnly 'io.github.klaidi4dev:stellarchat-api:{VERSION}'
}
Gradle (Kotlin DSL):
dependencies {
compileOnly("io.github.klaidi4dev:stellarchat-api:{VERSION}")
}
? Commands
? User Commands
/stellarchat help (aliases: /sc, /schat) - Show help message
/msg <player> <message> (aliases: /tell, /w, /m) - Send a private message
/reply <message> (aliases: /r) - Reply to the last private message
/ignore <player> - Ignore/unignore a specific player
/ignoreall - Toggle ignoring all private messages
/global [message] (aliases: /g) - Send a message or switch to the Global channel
/local [message] (aliases: /l) - Send a message or switch to the Local channel
? Admin & Staff Commands
/stellarchat reload - Reload all plugin configurations
/stellarchat togglechat (aliases: /tchat) - Toggle global chat mute
/stellarchat broadcast <message> (aliases: /bc) - Broadcast a message to the server
/stellarchat spy - Toggle social spy mode
/staff [message] (aliases: /sc) - Send a message or switch to the Staff channel
? AI Commands
/ai <question> (alias: /ask) - Ask a question to the AI assistant
? Dependencies
Soft Dependencies (Optional but recommended):
- PlaceholderAPI (For custom placeholders in chat formats)
- LuckPerms (For group-based formatting and mentions)
- Vault (For channel message costs)
- PlayerPoints (For alternative economy message costs)
- DiscordSRV (For cross-chat integration)
Required Dependencies:
- None! The plugin works perfectly out of the box.
? Placeholders
You can use these placeholders via PlaceholderAPI in other plugins (like scoreboards or tablists):
%stellarchat_channel% — Returns the player's active channel ID
%stellarchat_channel_prefix% — Returns the formatted prefix of the active channel
%stellarchat_last_message% — Returns the player's last sent message
%stellarchat_mentions% — (Coming soon) Number of active mentions
%stellarchat_reply_target% — Returns the name of the player currently being replied to
%stellarchat_spy_enabled% — Returns "Yes" or "No" based on spy status
? Permissions
Formatting Permissions
stellarchat.format.legacy — Allows &a, &l color codes
stellarchat.format.hex — Allows &#RRGGBB hex colors
stellarchat.format.custom_hex — Allows Kyori <#RRGGBB> hex colors
stellarchat.format.minimessage — Allows MiniMessage <gradient>, <rainbow>, etc.
Live Tokens & Tags
stellarchat.tag.item — Allows [item]
stellarchat.tag.offhand — Allows [offhand]
stellarchat.tag.helmet — Allows [helmet]
stellarchat.tag.discord — Allows [discord]
stellarchat.token.hp — Allows [hp]
stellarchat.token.pos — Allows [pos]
stellarchat.token.ping — Allows [ping]
stellarchat.token.target — Allows [target]
Bypass Permissions
stellarchat.bypass.togglechat — Speak while chat is globally muted
stellarchat.bypass.ignore — Message players who are ignoring you
stellarchat.bypass.length — Bypass max message length limit
stellarchat.bypass.cooldown — Bypass channel cooldowns
stellarchat.bypass.cost — Send messages in paid channels for free
stellarchat.bypass.links — Bypass anti-links filter
stellarchat.bypass.spam — Bypass anti-spam filter
stellarchat.bypass.caps — Bypass anti-caps filter
stellarchat.bypass.filter — Bypass swear filter
General Features
stellarchat.command — Base command permission
stellarchat.spy — Read messages from local channels out of radius
stellarchat.channel.<name> — Access restricted channels (e.g., stellarchat.channel.staff)
stellarchat.mention.everyone — Allow pinging @everyone
stellarchat.mention.role.<group> — Allow pinging specific LuckPerms groups
stellarchat.mention.bypasscooldown — Bypass mention cooldowns
AI Permissions
stellarchat.ai.use — Allow asking the AI questions
stellarchat.ai.limit.<group> — Applies specific rate limits (e.g., stellarchat.ai.limit.vip)
stellarchat.ai.bypass — Bypass all AI rate limits
评论 0
登录后参与评分
还没有评论,来抢沙发吧