> 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/solarelo/gioi-thieu.md).

# Giới thiệu

***

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

**SolarElo** là một plugin quản lý điểm Elo và xếp hạng PvP hiệu năng cao, tối ưu hóa toàn diện cho Folia và Paper, tích hợp sẵn các tính năng cao cấp:

* **Hệ thống Xếp hạng Elo đa dạng**:
  * Hỗ trợ 4 chế độ tính điểm Elo:
    * `FORMULA`: Tính theo công thức Elo chuẩn quốc tế với K-factor.
    * `RANDOM`: Điểm nhận/mất ngẫu nhiên trong khoảng min-max cấu hình.
    * `KD`: Điểm nhận/mất dựa vào tỷ lệ K/D của sát thủ và nạn nhân.
    * `CUSTOM`: Điểm nhận/mất dựa trên công thức toán học tự định nghĩa.
  * Giới hạn điểm Elo tối thiểu tùy chỉnh.
* **Hệ thống Cấp bậc & Thăng hạng (Rank System)**:
  * Tự động thăng cấp/hạ cấp khi Elo thay đổi.
  * Chạy các lệnh tùy biến từ console khi người chơi lên hạng/xuống hạng (`rankup-commands`).
  * Tùy chỉnh tên hiển thị (Display) và tiền tố (Prefix) cho từng rank riêng biệt.
* **Hệ thống Chống farm & Khai thác (Anti-Farm)**:
  * **IP / Subnet Check**: Ngăn chặn nhận Elo khi hạ gục tài khoản clone cùng địa chỉ IP hoặc cùng dải IP subnet `/24`.
  * **Same Player Cooldown**: Đặt thời gian chờ tối thiểu giữa các lần giết cùng một người chơi để nhận Elo.
  * **Repeat Kill Limit**: Tự động giảm một nửa điểm Elo nhận được (Diminished) nếu giết cùng một người chơi vượt quá giới hạn cho phép trong 1 giờ.
  * **Activity Checks (AFK)**: Chặn nhận Elo nếu nạn nhân không di chuyển (no-move) hoặc không tấn công lại (no-attack) trong khoảng thời gian quy định. **Đặc biệt, yêu cầu di chuyển (`no-move-seconds`) chỉ áp dụng cho lần chết đầu tiên** (khi số lần chết = 0) giúp chống tài khoản clone vừa đăng nhập đứng yên farm điểm mà không ảnh hưởng tới PvP thông thường.
  * **Spawn Camping Check**: Chặn nhận Elo nếu nạn nhân bị giết trong thời gian ngắn sau khi hồi sinh (Spawn) và trong phạm vi bảo vệ của điểm spawn.
  * **Elo Difference Check**: Chặn nhận Elo nếu chênh lệch điểm Elo giữa Killer và Victim quá lớn (mặc định > 200). Chống tình trạng cao thủ đi săn/farm newbie để lấy điểm.
* **Tin nhắn PvP Tương tác cao (Interactive Chat & Hover Stats)**:
  * Tự động gửi thông báo khi một người chơi hạ gục người chơi khác.
  * **Hover tooltip**: Di chuột vào tên người chơi để hiển thị chỉ số PvP chi tiết (Elo, Cấp bậc, K/D Ratio, Số mạng giết/chết, Chuỗi thắng hiện tại) cấu hình tại `messages.yml`.
  * **Click action**: Nhấp chuột trực tiếp vào tên người chơi để tự động thực thi lệnh `/elo <tên>` mở giao diện xem thông tin **Stats GUI**.
* **Hệ thống Mùa giải & Tự động trao thưởng (Seasonal ELO & Auto Rewards)**:
  * Tổ chức thi đấu theo mùa thông qua lệnh quản lý `/eloadmin season reset`.
  * **Soft-Reset ELO**: Elo của người chơi được nén lại theo công thức `1000 + (Elo hiện tại - 1000) * multiplier` để cân bằng giữa người chơi cũ và mới khi bước sang mùa giải mới.
  * **Auto-Reward Commands**: Tự động thực thi các lệnh console phát thưởng (vật phẩm, VIP, lệnh Permission) cho TOP thứ hạng hoặc khoảng thứ hạng được định cấu hình.
* **Phần thưởng Chuỗi hạ gục (Kill Streak)**:
  * Thưởng thêm phần trăm Elo khi đang có chuỗi giết liên tiếp.
  * Tự động gửi thông báo chuỗi hạ gục (Title/Subtitle) ở các mốc cấu hình (milestones).
  * Phạt trừ thêm điểm Elo khi chết lúc đang giữ chuỗi hạ gục cao.
* **Hệ thống Săn tiền thưởng Cao thủ (Elo Bounty System)**:
  * Treo thưởng tự động khi người chơi đạt mốc chuỗi hạ gục (Streak Bounties) hoặc đứng TOP thứ hạng cao trên server (Rank Bounties như TOP 1, TOP 2, TOP 3).
  * Hạ gục người chơi bị treo thưởng giúp nhận thêm Elo và tự động kích hoạt phần thưởng lệnh Console (ví dụ phát quà, cộng tiền).
  * Hệ thống tự động phát thông báo toàn Server khi có người đạt mốc bị treo thưởng hoặc khi phần thưởng được tuyên bố thu về (claim).
* **Hệ thống Hao hụt Elo do không hoạt động (Elo Decay System)**:
  * Tự động kiểm tra và trừ một lượng Elo (mặc định là 20 Elo) cho các người chơi trong **TOP 10** nếu họ không có bất kỳ thay đổi Elo nào trong khoảng thời gian quy định (ví dụ: `24h`, `3d`, v.v.).
  * Hỗ trợ cấu hình khoảng thời gian quét (`check-interval`) và thời gian không hoạt động tối đa (`inactive-threshold`) với các đơn vị: `m` (phút), `h` (giờ), `d` (ngày).
  * Người chơi đang trực tuyến sẽ nhận được thông báo trực quan khi bị trừ điểm Elo do không hoạt động.
* **Tích hợp Discord Webhook**:
  * Tự động gửi thông báo dạng văn bản đẹp mắt về kênh Discord khi xảy ra các sự kiện: PvP Kill, Hạ gục TOP 1 Server, Lên hạng (Rank up).
* **Hiệu ứng & Âm thanh tùy biến (Sounds & Particles)**:
  * Phát âm thanh và hiệu ứng hạt (Particle) tương thích cho các sự kiện: Cộng điểm Elo (+), Trừ điểm Elo (-), Nhận bonus Elo, Lên hạng, Xuống hạng.
* **Tích hợp bStats & PlaceholderAPI**:
  * Tự động gửi thống kê bStats bảo mật.
  * Hỗ trợ đầy đủ các placeholder cho bảng điểm (Scoreboard), Tablist, Chat, v.v.