# 📘 Plugin Tài Xỉu Minecraft

> **Phiên bản:** 0.1-beta\
> **Tác giả:** Kazami Studio\
> **Minecraft:** 1.20.6 – 1.21+\
> **Dependency:** Vault (bắt buộc)

***

### 🎮 Giới thiệu

Plugin **Tài Xỉu** mang trải nghiệm trò chơi cá cược phổ biến trong văn hóa Việt Nam vào thế giới Minecraft. Người chơi có thể đặt cược vào **Tài (11-17)** hoặc **Xỉu (3-10)** và nhận thưởng gấp đôi nếu đoán đúng. Hệ thống tích hũ (jackpot), âm thanh, GUI và lịch sử kết quả tạo ra trải nghiệm sinh động, hiện đại và hấp dẫn.

***

### 📦 Các tính năng chính

* ✅ Đặt cược vào **Tài** hoặc **Xỉu**
* 🎲 Xúc xắc 3 viên, tự động xử lý kết quả
* 💰 Tích hũ tự động – chia thưởng nếu nổ hũ
* 🧠 Cơ chế nhà cái thắng ngẫu nhiên theo % cấu hình
* 🖼️ GUI chọn cược, nhập số tiền bằng Anvil GUI
* 📜 Hiển thị **lịch sử 15 phiên gần nhất**
* 💎 Hiển thị tổng số tiền đã cược mỗi phiên
* 🧮 Tự động định dạng tiền theo chuẩn Việt Nam (1.000, 10.000, 1T...)
* 🔔 BossBar hiển thị thời gian còn lại mỗi vòng

***

### 🔧 Cấu hình

Tập tin cấu hình chính nằm tại:\
`/plugins/taiXiuPlugin/config.yml`

#### Các mục cấu hình:

```yml
round-time: 60                # Thời gian mỗi phiên (giây)
house-win-chance: 0.1         # Tỉ lệ % nhà cái thắng (0.1 = 10%)
jackpot-explode-chance: 0.15  # Tỉ lệ hũ nổ khi có người thắng (15%)
```

***

### 📘 Các lệnh

| Lệnh             | Mô tả                        | Quyền hạn  |
| ---------------- | ---------------------------- | ---------- |
| `/tai <số tiền>` | Đặt cược vào Tài             | Người chơi |
| `/xiu <số tiền>` | Đặt cược vào Xỉu             | Người chơi |
| `/txgui`         | Mở GUI chọn cược nhanh       | Người chơi |
| `/cau`           | Mở lịch sử 15 phiên gần nhất | Người chơi |

***

### 🧠 Cách hoạt động

1. **Người chơi đặt cược** trong thời gian đếm ngược (BossBar)
2. Hết thời gian, plugin **xúc 3 viên xúc xắc**
3. Tính tổng:
   * Từ 3 – 10: Xỉu
   * Từ 11 – 17: Tài
4. **So sánh cược và chia thưởng**
   * Nếu đúng: nhận lại ×2
   * Nếu sai: số tiền chuyển vào **hũ**
5. **Nếu hũ nổ**, những người thắng sẽ chia đều tiền hũ

***

### 🖼 GUI Cược

* Giao diện chính từ `taixiugui.yml` với slot, vật phẩm, tên, lore tùy chỉnh
* Khi click chọn, hiển thị Anvil GUI cho phép nhập tiền cược

***

### 📊 Hiển thị lịch sử (`/cau`)

Hiển thị 15 kết quả gần nhất:

* Ô **kính màu xám** đại diện cho Tài
* Ô **kính màu trắng** đại diện cho Xỉu
* Hiển thị số phiên và kết quả viên xúc xắc (🎲 1 | 4 | 6)

***

### 💰 Định dạng tiền

Plugin sử dụng `MoneyUtils.formatVietMoney(double amount)` để hiển thị:

* `1.000`, `10.000`, `1.000.000`
* Số lớn hơn `99.999.999` sẽ hiển thị dạng `1.2T`, `3.4T`...

***

### 🧩 Phụ thuộc

* **Vault** (bắt buộc)
* Plugin **economy** như EssentialsX, CMI, hoặc bất kỳ plugin nào hỗ trợ Vault

***

### 📥 Cài đặt

1. Tải plugin `.jar` và đặt vào thư mục `plugins`
2. Khởi động lại server
3. Cài Vault và plugin economy nếu chưa có
4. Cấu hình lại `config.yml`, `taixiugui.yml` nếu cần
5. Sử dụng các lệnh để bắt đầu chơi!

***

### ❓ Hỏi đáp

**Q: Tôi có thể điều chỉnh tỉ lệ hũ nổ không?**\
A: Có, sửa `jackpot-explode-chance` trong `config.yml`

**Q: Plugin có lưu dữ liệu cược không?**\
A: Hiện tại chỉ lưu lịch sử 15 phiên gần nhất trong RAM.

**Q: Có thể đặt cược khi phiên đang quay không?**\
A: Không, người chơi chỉ có thể đặt cược trong thời gian đếm ngược.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kazamis.gitbook.io/kazami-studio/wiki-plugin-tai-xiu-minecraft/plugin-tai-xiu-minecraft.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
