> 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/solarcrate/chuc-nang.md).

# Chức năng

### Hướng dẫn Cài đặt & Tạo Hòm (Crate Setup Tutorial)

#### Bước 1: Tạo tệp cấu hình Crate

Khi tạo một hòm mới, bạn có thể khởi tạo cấu hình bằng lệnh hoặc sao chép một tệp cấu hình hòm mẫu (ví dụ: `crates/common.yml`) trong thư mục `crates/` và đổi tên thành tên hòm bạn muốn (ví dụ: `legendary.yml`).

#### Bước 2: Tạo Khối đại diện (Crate Block Placement)

1. Cầm trên tay một khối block bất kỳ (ví dụ: Chest, Ender Chest, Amethyst Block, Spawner, v.v.).
2. Thực thi lệnh: `/sc addcrate legendary`.
3. Vật phẩm trên tay bạn sẽ được gán PDC marker và hiển thị tên đặc biệt: `[Crate: legendary]`.
4. Đặt khối block này xuống vị trí bạn muốn làm hòm đồ.
5. Plugin sẽ tự động nhận diện tọa độ, lưu vị trí vào tệp cấu hình và kích hoạt hiệu ứng hạt xung quanh block.

#### Bước 3: Cấu hình phần thưởng (Edit Workbench)

1. Chạy lệnh `/sc edit legendary` để mở giao diện **Edit Workbench** của hòm `legendary`.
2. Bố cục Workbench gồm 45 ô chứa đồ trống ở trên và dòng thanh công cụ ở đáy.
3. Kéo thả trực tiếp các vật phẩm phần thưởng từ túi đồ của bạn vào 45 ô phía trên.
4. **Cấu hình tỷ lệ & lệnh cho từng vật phẩm**:
   * **Click chuột phải (hoặc Shift + Right Click)** vào vật phẩm trong 45 ô để mở GUI tùy chỉnh chi tiết.
   * Tại đây bạn có thể cấu hình:
     * **Lệnh thực thi (Commands)**: Thêm các lệnh chạy từ Console khi trúng (hỗ trợ các placeholder `{player}`, `%player%`, `<player>`).
     * **Thông báo server (Broadcast)**: Bật/tắt thông báo cho toàn máy chủ khi trúng vật phẩm này.
     * **Trao vật phẩm gốc (Give Raw Item)**: Bật/tắt việc đưa vật phẩm block gốc in-game vào túi đồ người chơi.
5. Nhấp vào **Lưu lại** (Hòn ngọc lục bảo ở góc phải bên dưới) để áp dụng các thay đổi.

### Bố cục Giao diện (GUIs & Interface Layouts)

Tất cả các giao diện của SolarCrate được thiết kế theo phong cách tối giản, sang trọng (Minimalist & Premium Display) không sử dụng các kính màu trang trí viền rác mắt, đồng thời tối ưu hóa chống lấy đồ ma.

#### 1. Menu Tùy chỉnh hiệu ứng (`CrateParticleConfigGui`)

* **Trạng thái (Status)** (Slot 10): Bật/tắt hạt xung quanh block hòm.
* **Mật độ (Density)** (Slot 12): Tăng/giảm mật độ hạt hiển thị (+/- 5 mỗi click).
* **Kích thước (Size)** (Slot 14): Tăng/giảm kích cỡ hạt bụi màu (+/- 0.2).
* **Kiểu chuyển động (Style)** (Slot 16): Chuyển đổi giữa `DOUBLE_HELIX`, `RING`, `SPIRAL`, `SPARKLE`.
* **Màu sắc RGB** (Slot 20, 22, 24): Chỉ hiển thị dưới dạng thuốc nhuộm Đỏ/Lục/Lam khi hạt được chọn là `DUST`.
* **Chọn hiệu ứng (Select Effect)** (Slot 31 - Nether Star): Mở GUI danh sách các hạt.
* **Quay lại (Back)** (Slot 49 - Arrow): Quay về tổng quan Crate.

#### 2. Danh sách hiệu ứng (`CrateParticleSelectionGui`)

* Hiển thị 18 mẫu hạt hiệu ứng được sắp xếp đối xứng cân bằng trên Row 2, Row 3 và Row 4.
* Hạt đang sử dụng sẽ hiển thị tag màu xanh lá `[Đang dùng]`.
* Click chọn một hạt sẽ lưu ngay lập tức và đưa người chơi quay về menu Tùy chỉnh hiệu ứng.

#### 3. Giao diện Xác nhận mở hòm (`ConfirmationGui`)

* **Vật phẩm được chọn** hiển thị ở chính giữa (Slot 13).
* **Xác nhận (Confirm)** (Slot 15 - Kính màu lime): Thực hiện trừ key, phát quà, chạy lệnh và bắn pháo hoa.
* **Hủy bỏ (Cancel)** (Slot 11 - Kính màu đỏ): Hủy mở hòm và trả về.

***

### Cấu hình Chi tiết (Configuration Files)

#### 1. `config.yml`

Quản lý các cài đặt chung, âm thanh, thế giới hoạt động và các cài đặt chu kỳ tự động.

#### 2. `gui/confirmation.yml`

Tùy biến các nút bấm, slot hiển thị và lore của menu xác nhận mở hòm. Bạn có thể thay đổi vật liệu nút bấm sang các loại kính màu khác nhau.

#### 3. `lang/vi_vn.yml` & `lang/en_us.yml`

Chứa toàn bộ các thông điệp dịch thuật in-game. Hỗ trợ đầy đủ hệ màu Hex (VD: `<#00d2ff>`) và định dạng MiniMessage của Adventure.

***