✨ 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

🔌 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