> For the complete documentation index, see [llms.txt](https://onic-studio.gitbook.io/solarplugins-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onic-studio.gitbook.io/solarplugins-docs/plugins/solarchat/gioi-thieu.md).

# Giới thiệu

***

## Tổng quan & Tính năng chính

**SolarChat** là một plugin quản lý chat hiệu năng cao, tối ưu hóa cho Folia và Paper, tích hợp sẵn các tính năng:

* **Quản lý Chat nâng cao**: Định dạng tin nhắn màu sắc (Hex/RGB), định dạng chat riêng cho từng nhóm LuckPerms (`group-formats`).
* **Hệ thống Anti-Spam & Lọc từ cấm**: Chống spam theo thời gian chờ (cooldown), giới hạn số lượng tin nhắn gửi nhanh (rate-limit), chặn tin nhắn trùng lặp, và lọc từ ngữ không phù hợp (chặn hoặc thay bằng kí tự ẩn).
* **Hover Stats & GUI Thống kê**: Di chuột vào tên người chơi trong chat để hiện thông tin chi tiết; click để mở giao diện GUI `/viewstats` hiển thị số dư Vault, mảnh ngọc, số quái giết, khối đã đặt/đào, thời gian chơi, v.v.
* **Tích hợp Discord cực mạnh**:
  * Đồng bộ tin nhắn Minecraft sang Discord qua Webhook (hiển thị skin avatar người chơi) hoặc qua Discord Bot thông thường.
  * Đồng bộ các sự kiện: Tham gia (Join), Thoát (Quit), Chết (Death - hiển thị chi tiết nguyên nhân), Đạt thành tựu (Advancement - kèm hình ảnh/icon của thành tựu đó giống DiscordSRV).
  * Cập nhật tự động Chủ đề kênh Discord (Channel Topic) hiển thị số lượng người chơi trực tuyến.
  * Cập nhật Trạng thái hoạt động (Bot Activity Status) động.
  * Sử dụng thư viện runtime giúp plugin có kích thước cực nhẹ (<100KB) và mượt mà.
* **Liên kết tài khoản (Account Linking)**: Liên kết tài khoản Minecraft và Discord thông qua mã bảo mật 6 chữ số ngắn hạn. Cung cấp các lệnh Discord `/profile` và `/stats` để kiểm tra tài khoản đã liên kết từ Discord.
* **Hệ thống Tin nhắn riêng (Msg/Reply/Ignore)**: Nhắn tin riêng giữa các người chơi, tính năng phản hồi nhanh `/r`, chế độ giám sát tin nhắn của Staff (`/socialspy`), chặn người chơi làm phiền `/ignore`.
* **Hệ thống ChatPing**: Nhắc tên người chơi trong chat (ví dụ `@TenNguoiChoi`) sẽ phát âm thanh và hiển thị thông báo nổi trên màn hình (ActionBar/Title).
* **Hiệu ứng Nhìn đêm (Nightvision)**: Lệnh bật/tắt hiệu ứng nhìn trong bóng tối `/nightvision`, tự động cấp lại khi hồi sinh.
* **Báo cáo người chơi (Report)**: Lệnh gửi báo cáo người chơi kèm lý do `/report`, thông báo cho Staff trong game và tự động gửi Embed đẹp mắt về Discord Webhook chuyên dụng của ban quản trị.
* **Thông báo tự động (Announcements)**: Phát thông báo định kỳ theo danh sách với hiệu ứng âm thanh tùy biến cho từng tin nhắn, có lệnh bật/tắt nhận thông báo cho cá nhân người chơi.
* **Phần thưởng hạ gục & Thể thao (KillReward)**: Khuyến khích tinh thần ứng xử đẹp trong game bằng cách trao thưởng (tiền Vault, vật phẩm qua lệnh, âm thanh, thông báo nổi) khi người chơi hạ gục người chơi khác và gõ các từ khóa chúc mừng như "GG" hoặc "EZ" trong khung chat. Module đi kèm tính năng chống lạm dụng/farming bằng giới hạn nhận thưởng tối đa theo giờ và cơ chế phát hiện chặn tài khoản clone cùng địa chỉ IP.