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>, <✨>, 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

---