# 🧩 TÍNH NĂNG CHÍNH

#### 📍 Quản lý Home cơ bản

* Cho phép người chơi:
  * Tạo nhà
  * Xoá nhà
  * Dịch chuyển về nhà
* Tất cả nhà được lưu trong **database** (MySQL/SQLite).
* Mỗi nhà có tên như `home1`, `home2`, v.v.

#### 🗂 Menu Giao Diện GUI

* Dùng lệnh `/he` để mở **menu quản lý nhà**.
* Hiển thị:
  * Slot nhà đã tạo
  * Slot trống
  * Nút **mua thêm slot**
  * Nút tạo hoặc xoá nhà
* Tuỳ chỉnh giao diện qua `menuhome.yml`.

***

#### 💰 Hệ thống Mua Thêm Nhà

* Giao diện mua nhà mở bằng cách ấn vào nút **"Mua thêm nhà"** trong GUI chính.
* Cấu hình gói mua slot trong `buyhome.yml`.
* Khi mua:
  * Trừ tiền thông qua Vault
  * Tự động cập nhật quyền `homeextra.limit.X` qua **LuckPerms**
  * Không thể vượt quá **giới hạn tối đa 14 slot**

🛒 **Các loại gói hỗ trợ:**

```yaml
packages:
  slot1:
    slot: 11
    price: 10000
    add: 1
    display:
      material: "GOLD_INGOT"
      name: "&6+1 slot nhà"
      lore:
        - "&7Mua thêm 1 slot nhà"
        - "&fGiá: &a10000$"
      custom-model-data: 1

  full:
    slot: 22
    price: 50000
    add: 14
    display:
      material: "NETHER_STAR"
      name: "&cMua Full 14 Slot Nhà"
      lore:
        - "&7Mở khóa toàn bộ slot nhà"
        - "&fGiá: &c50000$"
      custom-model-data: 2
```

***

#### 📊 Tính năng mở rộng

* ✅ **Giới hạn theo quyền**: quyền `homeextra.limit.X` xác định số slot người chơi có thể dùng.
* ✅ **PlaceholderAPI**: hỗ trợ placeholders như:
  * `%homeextra_homecount%`: số nhà đã tạo (  sắp có )
  * `%homeextra_limit%`: số slot tối đa hiện tại ( sắp có )
* ✅ **LuckPerms API**: cập nhật quyền tự động sau khi mua.
* ✅ **Vault**: hỗ trợ trừ tiền khi mua slot.
* ✅ **MySQL/SQLite Support**: lưu dữ liệu nhà vào CSDL.

***

### ⚙️ Cấu hình

#### `setting/menuhome.yml`

* Tuỳ chỉnh giao diện menu chính (tên menu, icon, vị trí các nút…).

#### `setting/buyhome.yml`

* Tuỳ chỉnh các gói mua slot, GUI giao diện mua nhà.

#### `config.yml`

* Các thiết lập chung như delay dịch chuyển, âm thanh, hiệu ứng...

***

### 🚀 Cài đặt

1. Cài đặt các plugin phụ thuộc:
   * **Vault**
   * **LuckPerms**
   * **PlaceholderAPI** (nếu dùng placeholder)
2. Tải plugin HomeExtra vào thư mục `plugins/`.
3. Khởi động server và chỉnh sửa các file:
   * `config.yml`
   * `menuhome.yml`
   * `buyhome.yml`

***

### 📌 Lệnh

| Lệnh                | Quyền             | Mô tả                      |
| ------------------- | ----------------- | -------------------------- |
| `/he`               | `homeextra.use`   | Mở menu nhà                |
| `/homeextra reload` | `homeextra.admin` | Reload config và giao diện |

***

### 💬 Liên hệ & Hỗ trợ

* 🌐 Website: [kazamistudio.dev](https://kazamistudio.dev)
* 🧠 Discord: Kazami Studio Support

***

### ✅ Kết luận

**HomeExtra** là plugin không thể thiếu cho các server sinh tồn, RPG, hoặc Skyblock khi bạn muốn **giới hạn và quản lý số lượng nhà của người chơi một cách thông minh và trực quan**. Dễ cấu hình, dễ mở rộng và tương thích nhiều plugin phổ biến.


---

# 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/homeextra-wiki/homeextraplus-v2.0/tinh-nang-chinh.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.