StellerChat

Minecraft 版本： 1.16.5 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： paper purpur

标签： economy game-mechanics social

---

✨ 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 ` (aliases: `/tell`, `/w`, `/m`) - Send a private message - `/reply ` (aliases: `/r`) - Reply to the last private message - `/ignore ` - 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 ` (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 ` (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 `` hex colors - `stellarchat.format.minimessage` — Allows MiniMessage ``, ``, 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.` — Access restricted channels (e.g., `stellarchat.channel.staff`) - `stellarchat.mention.everyone` — Allow pinging `@everyone` - `stellarchat.mention.role.` — Allow pinging specific LuckPerms groups - `stellarchat.mention.bypasscooldown` — Bypass mention cooldowns AI Permissions - `stellarchat.ai.use` — Allow asking the AI questions - `stellarchat.ai.limit.` — Applies specific rate limits (e.g., `stellarchat.ai.limit.vip`) - `stellarchat.ai.bypass` — Bypass all AI rate limits

---