# ⚡ AOLAR ULTRA CHAT MANAGEMENT SYSTEM ⚡

HIGH-PERFORMANCE CHAT CORE FOR PAPER 1.21+
> Experience a new era of chat moderation and customization. Built entirely around the cutting-edge Adventure MiniMessage engine, Aolar delivers lightning-fast processing speeds with zero overhead, giving your staff ironclad control and your players unmatched expression.

---

## PRESTIGE FEATURES

Premium ChatColor Matrix
An interactive, ultra-modern GUI offering jaw-dropping preset gradients and real-time custom Hex input fields. Give your players the visual identity they deserve.

️ The 5-Tier Sentinels (Filters)
Absolute chat purity. Fully automated systems designed to crush toxicity instantly:
* Anti-Advertising ➔ Drops network threats, unauthorized IPs, external links, and web domains.
* Anti-Caps ➔ Detects and suppresses aggressive uppercase screaming.
* Anti-Spam ➔ Intelligent rate-limiters with adaptive cooldowns and duplicate message barriers.
* Anti-Swear ➔ Deep profanity validation engine utilizing fully expandable dictionary matrices.
* Anti-Unicode ➔ Mitigates crash exploits, non-standard symbols, and character-width bypasses.

️ Tactical Surveillance Core
Real-time operations monitoring. Keep tabs on server interactions with zero lag:
* Social Spy ➔ Intercept and monitor direct messages across the server network.
* Command Spy ➔ Watch executed backend commands live as they occur.

Total Crowd Control
Instantly freeze or wipe text buffers across the network with /mutechat or /clearchat.

---

## PLACEHOLDER ARSENAL

### Native Placeholders
* %player% ➔ Core player username
* %displayname% ➔ Custom metadata display identity
* %ping% ➔ Real-time network latency connection matrix (ms)
* %world% ➔ Identifier of current active world dimension
* %prefix% ➔ Associated primary Vault hierarchy prefix
* %suffix% ➔ Associated secondary Vault hierarchy suffix
* %x% %y% %z% ➔ Current precise block world-space coordinates
* %gamemode% ➔ Active operational game state mode
* %level% ➔ Current total numeric experience pool layer
* %health% ➔ Active structural health pool measurement

### PlaceholderAPI Expansion Nodes
* %aolar_player% ➔ Native player username string
* %aolar_ping% ➔ Current latency tracking digit
* %aolar_world% ➔ Targeted world space identification tag
* %aolar_chatcolor% ➔ Active applied player custom color gradient formatting data

---

## CHAT FORMATTING ENGINE

### Default Layout Format
[dark_gray] [gold] %prefix% [dark_gray]] [gold] %player% [dark_gray]» %message%

### ⚙️ Engine Attributes
* Fully customizable format matrix utilizing raw MiniMessage composition tags.
* Native internal translation arrays support: %player%, %displayname%, %prefix%, %suffix%, %world%, %ping%, %message%.
* Full synchronization layer tracking for external PlaceholderAPI tokens.
* The system dynamically tracks and embeds a player's selected custom color/gradient profile directly inside the %message% output string.

---

## ️ COMMAND CONTROLS & PERMISSION DIRECTIVES

### Player Terminal
| Action | Purpose | Access Token |
| :--- | :--- | :--- |
| /chatcolor | Activates the advanced gradient & hex UI selector. | aolar.chatcolor |
| /msg <player> <msg> | Opens a secure encrypted direct messaging tunnel. | aolar.msg |
| /reply <msg> | Responds instantaneously to the last incoming direct signal. | aolar.msg |
| /ping [player] | Evaluates current connection and network status values. | aolar.ping |

### Operations & Moderation Terminal
| Action | Purpose | Access Token |
| :--- | :--- | :--- |
| /clearchat | Purges the public chat feed for all server participants. | aolar.clearchat |
| /mutechat | Locks the active public chat channel globally. | aolar.mutechat |
| /commandspy | Toggles a live monitoring layout of system commands. | aolar.commandspy |
| /socialspy | Toggles a live interception display of private messaging channels. | aolar.socialspy |

---

## SYSTEM BYPASS KEYS

### ️ Executive Permissions
* aolar.admin ➔ Full master control over configurations, live file reloads, and administrative actions.
* aolar.mutechat.bypass ➔ Grants chat capability during a global channel mute phase.
* aolar.clearchat.bypass ➔ Protects the user from screen clears when chat wipe routines are executed.
* aolar.signcolors ➔ Grants power to project Hex, RGB, and MiniMessage styling variables on signs.

### Filter Nullification Elements
Assign these to bypass defensive filters for operations management or staff tiers.

* aolar.filter.bypass.advertising ➔ Disables link, domain, and external network address blockades.
* aolar.filter.bypass.caps ➔ Permits unrestricted use of uppercase characters.
* aolar.filter.bypass.spam ➔ Removes operational rate limits and phrase restriction safeguards.
* aolar.filter.bypass.swear ➔ Neutralizes the profanity scanner and word exclusion filters.
* aolar.filter.bypass.unicode ➔ Allows the utilization of special character strings and symbol maps.
* aolar.filter.bypass.commands ➔ Permits authorization for commands logged in the forbidden operations table.

---

## FRAMEWORK ATTRIBUTES
* Infrastructure Target: Paper 1.21+ (and high-optimization modern downstream forks)
* Visual Standard: Adventure MiniMessage Syntax Integration (<gradient:gold:yellow>Text</gradient>)
* Integration Support: Full PlaceholderAPI Ecosystem Hook