NexaChat | Modern Chat System v1.0.2

---

What is NexaChat?

NexaChat is a modern Minecraft chat infrastructure plugin designed for servers that need more than basic chat formatting.

It combines clean chat rendering, advanced channels, private messaging, moderation tools, anti-spam protection, rule-based filtering, item/inventory sharing, database storage, optional plugin integrations and cross-server synchronization in one configurable system.

Every external plugin integration is handled as a soft hook. If an optional plugin is missing, NexaChat will continue loading safely instead of breaking your server startup.

---

Main Highlights

• Two engine modes: performance mode for the full chat pipeline and lightweight mode for simpler servers.
• Modern rendering stack: MiniMessage, Adventure, legacy colors, section colors and hex color support.
• Advanced channel system: global, local, staff, trade, private and custom channels.
• Private messaging tools: /msg, /reply, /ignore, /socialspy and PM toggle support.
• Item and inventory sharing: show items, inventories, ender chests and shulker contents directly in chat.
• Anti-spam and filter stack: cooldowns, duplicates, caps, repeated characters, similarity checks, command spam and rate limits.
• Rule engine: trigger actions from chat, commands, signs, books and optional packet checks.
• Network-ready routing: synchronize chat, staff chat, PMs, mentions, punishments and moderation events.
• Database support: SQLite by default with MySQL, MariaDB and YAML fallback options.
• Soft hook ecosystem: LuckPerms, PlaceholderAPI, Vault, EssentialsX, DiscordSRV, TAB, ProtocolLib, ItemsAdder, Oraxen, Nexo and more.
• Premium release structure: license validation, obfuscation profile and a modern showcase page.

---

Dual Engine System

NexaChat includes two different engine modes so server owners can choose the best workflow for their setup.

Performance Mode

• Full chat processing pipeline.
• Normalization, spam checks, filters and rule engine.
• Format selection, placeholder parsing, rendering and output routing.
• Designed for servers that want maximum control and advanced moderation behavior.

Lightweight Mode

• Shorter and faster chat pipeline.
• Lazy module activation.
• Designed for servers that want clean formatting and core chat tools without unnecessary overhead.

NexaChat automatically selects the correct listener environment at runtime, supporting Paper/Leaf AsyncChatEvent and Spigot AsyncPlayerChatEvent behavior.

---

Chat Formatting & Rendering

NexaChat gives server owners full control over how chat looks and behaves.

• MiniMessage support.
• Adventure component rendering.
• Legacy ampersand color support.
• Section-code color support.
• Hex color support.
• JSON hover text.
• Click actions.
• Rank-based format selection by permission weight.
• Internal placeholders.
• PlaceholderAPI expansion.
• LuckPerms prefix, suffix and primary group support.
• Vault chat metadata fallback.
• TAB prefix/suffix fallback.
• EssentialsX and SkinsRestorer display-name compatibility.
• Emoji and static icon replacements.
• Rank icons and permission icons.
• Custom glyph maps through supported resource plugins.

The metadata priority system is designed to give clean results even when multiple plugins provide player names, ranks, prefixes or suffixes.

---

Mention System

NexaChat includes a configurable mention system designed to avoid messy false pings.

• Exact player mention detection.
• Boundary-aware matching.
• Configurable @ symbol requirement.
• Case-insensitive matching.
• Mention highlight formatting.
• Sound feedback for mentioned players.
• Works inside the normal chat formatting pipeline.

Example: mentioning Alex will not accidentally ping a player named Alexander.

---

Channels & Routing

NexaChat includes a flexible channel system for both small servers and larger networks.

Built-in Channels

• Global chat.
• Local chat.
• Staff chat.
• Trade chat.
• Private channels.

Custom Channels

• Create custom channel definitions from configuration.
• Set permissions per channel.
• Set cooldowns per channel.
• Set range limits.
• Set allowed worlds.
• Enable or disable logging.
• Enable or disable cross-server routing.
• Control visibility behavior.

Local Chat

• Filters recipients by world first.
• Then filters by distance.
• Useful for survival, SMP, town, roleplay and proximity-chat style servers.

Network Routing

• Cross-server chat routing.
• Cross-server staff chat routing.
• BungeeCord plugin-message support.
• Velocity plugin-message support.
• Redis pub/sub transport for network events.

---

Private Messaging System

NexaChat includes the core private messaging tools server networks expect.

• /msg command.
• /reply command.
• /ignore command.
• /socialspy command.
• PM toggle support.
• Conversation cache.
• Notification sound support.
• Vanish-aware PM targeting through EssentialsX when available.
• Essentials-first or NexaChat-first command compatibility mode.

Staff members can monitor private messages through social spy if they have permission, while players can block unwanted communication using ignore controls.

---

Item, Inventory & Container Sharing

NexaChat lets players show valuable items and containers in chat without giving anyone edit access.

Supported Share Tokens

• [item] - share the held item.
• {item} - alternate held item share token.
• [inv] - share a player inventory snapshot.
• [ec] - share an ender chest snapshot.
• [enderchest] - alternate ender chest token.
• [shulker] - share shulker contents.

Share Protection

• Read-only GUI snapshots.
• Automatic expiry.
• Audit logging.
• Safe previews for items, inventories, ender chests and shulker boxes.

This is perfect for trading, auction discussions, staff checks, survival servers and economy-based communities.

---

Filtering, Anti-Spam & Rule Engine

NexaChat includes a complete moderation pipeline for chat and related text inputs.

Normalization

• Unicode normalization.
• Accent stripping.
• Lowercase normalized copy.
• Control-character cleanup.
• Replacement map support.

Anti-Spam Checks

• Chat cooldowns.
• Duplicate message detection.
• Repeated character detection.
• Caps ratio checks.
• Similarity checks.
• Time-window rate limits.
• Command spam detection.
• Adaptive point system.

Filters

• Blocked word list.
• Regex filter list.
• URL advertising detection.
• IP advertising detection.
• Global whitelist support.

Rule Engine Triggers

• Chat messages.
• Commands.
• Signs.
• Books.
• Optional packet checks through ProtocolLib.

Rule Actions

• Cancel.
• Replace or rewrite.
• Warn.
• Mute.
• Kick.
• Run commands.
• Reply to sender.
• Broadcast.
• Actionbar output.
• Title output.
• Bossbar output.
• Discord publish.
• Proxy publish.
• Log.

---

Moderation & Audit Tools

NexaChat includes built-in moderation features while also supporting external punishment plugins through command templates.

• Global chat mute.
• Storage-backed player mute.
• Warning system.
• Threshold-based actions.
• Kick support.
• Clear chat command.
• Punishment event publishing.
• Mute event publishing.
• Private message event publishing.
• CoreProtect and Plan detection for audit/analytics context.

External Punishment Support
NexaChat can dispatch configured punishment commands to external moderation plugins.

• LiteBans command templates.
• AdvancedBan command templates.
• LibertyBans command templates.

This allows NexaChat to handle detection and routing while your existing punishment system handles bans, mutes and punishments.

---

Network Synchronization

NexaChat is designed for servers that may start small but grow into multi-server networks.

Supported Network Transports

• Redis pub/sub.
• BungeeCord plugin messages.
• Velocity plugin messages.

Network Event Types

• Chat.
• Staff chat.
• Global mute.
• Player mute.
• Private messages.
• Mentions.
• Punishments.
• Spam cooldowns.

This makes it possible to keep chat, staff tools and moderation events synchronized across your network.

---

Storage System

NexaChat includes multiple storage options for different server sizes.

• SQLite - default storage for simple setups.
• MySQL - recommended for larger production servers.
• MariaDB - supported for production database setups.
• YAML fallback - configurable fallback provider for readable recovery and smaller servers.
• Async batch chat logging - reduces unnecessary blocking during chat logging.

Storage can be used for player settings, ignores, private channel members, mutes, violations and chat logs.

---

Integration System

All integrations are soft hooks. Missing plugins will not stop NexaChat from loading.

Supported Integrations & Hooks

• LuckPerms - prefix, suffix and primary group metadata.
• PlaceholderAPI - placeholder expansion after internal context.
• Vault - chat metadata fallback and economy placeholders.
• MiniMessage / Adventure - main component rendering stack.
• ProtocolLib - optional packet rule listener.
• DiscordSRV - chat, staff chat, mentions and moderation log publish.
• EssentialsX - nicknames, vanish-aware PMs, mute respect and command compatibility mode.
• BungeeCord - plugin-message network event publishing and receiving.
• Velocity - namespaced plugin-message network event publishing and receiving.
• Redis - real pub/sub transport for network events.
• ItemsAdder - config-backed glyph provider.
• Oraxen - config-backed glyph provider.
• Nexo - config-backed glyph provider.
• TAB - prefix/suffix metadata fallback.
• DeluxeMenus - command bridge for opening configured menus.
• SkinsRestorer - display compatibility fallback.
• LiteBans / AdvancedBan / LibertyBans - external punishment command templates.
• CoreProtect / Plan - audit and analytics context hooks.

Prepared Integration Surfaces

The following systems have prepared hook surfaces or adapter contracts and are intended for expanded automation in future updates:

• WorldGuard / GriefPrevention region rule surface.
• Towny / Lands / Factions / SuperiorSkyblock group channel surface.
• RabbitMQ / Kafka enterprise event bus contract.

These are kept safe and no-op when the related plugin or runtime client is not available.

---

Commands

• /nexachat reload - reload the plugin configuration.
• /nexachat status - view plugin and hook status.
• /nexachat perf - view performance information.
• /nexachat preset lightweight - switch to the lightweight preset.
• /nexachat gui - open the configured GUI bridge.
• /nexachat share <id> - open a shared snapshot.
• /chat - chat settings and controls.
• /channel - channel switching and management.
• /clearchat - clear chat for players.
• /mutechat - toggle global chat mute.
• /msg - send private messages.
• /reply - reply to the last private conversation.
• /ignore - ignore or unignore players.
• /socialspy - toggle staff PM monitoring.
• /mail - mail command surface.
• /announcement - broadcast announcement tools.

---

Configuration Files

NexaChat is modular and configuration-driven.

• config.yml
• integrations.yml
• network.yml
• moderation.yml
• formats.yml
• channels.yml
• rules.yml
• filters.yml
• spam.yml
• normalization.yml
• outputs.yml
• emoji.yml
• storage.yml
• announcements.yml

This structure keeps chat formatting, moderation, filters, storage, integrations, network routing and announcements separated instead of forcing everything into one impossible-to-read config file.

---

Compatibility Notes

• Requires Java 21.
• Designed for Minecraft 1.21.x.
• Optional plugins are detected at runtime.
• Missing integrations are treated as unavailable hooks, not fatal dependencies.
• Redis, MySQL, MariaDB, SQLite, HikariCP and Triumph GUI are bundled into the shaded jar.
• Paper-provided Adventure APIs stay provided.
• RabbitMQ and Kafka are contract-only in this build.
• WorldGuard/claim automation and full clan plugin member lookup are prepared integration surfaces and should not be treated as full automation yet.

---

Why Choose NexaChat?

Most chat plugins only handle formatting, channels or simple moderation.

NexaChat is built as a complete chat infrastructure layer:

• It can format chat cleanly.
• It can route messages across a network.
• It can protect chat from spam and bypass attempts.
• It can integrate with permission, placeholder, punishment, Discord and proxy systems.
• It can store moderation and player communication data.
• It can give players modern features like item, inventory and shulker sharing.
• It can scale from a single server to a larger network setup.

If you want a chat plugin that feels modern, configurable and network-ready without hard-depending on every plugin in your stack, NexaChat is built for that.