StellerChat

✨ 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

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags