# 🏦 Wiki Bank

**kBank** là một plugin ngân hàng mạnh mẽ và trực quan dành cho server Minecraft, cung cấp cho người chơi một hệ sinh thái tài chính hoàn chỉnh, từ **tài khoản ngân hàng**, **chuyển khoản**, đến **gửi tiết kiệm sinh lời.**

#### 🔑 Tính năng nổi bật:

* 📦 **Giao diện GUI đẹp mắt**: Gửi, rút, tiết kiệm và quản lý khoản vay dễ dàng.
* 🏦 **Hệ thống vay tiền**: Người chơi có thể vay tiền, trả lãi tự động theo thời gian thực.
* 💸 **Tính lãi thông minh**: Xác định số tiền cần trả sau khi hết hạn.
* 🔐 **Tích hợp Vault**: Đồng bộ số dư với hệ thống tiền tệ của server.
* 🎨 **Tùy chỉnh toàn bộ nội dung trong `lang.yml`**: Tên item, model, lore, title...
* 🧩 **Hỗ trợ PlaceholderAPI**: Chèn thông tin ngân hàng vào scoreboard, tablist, hologram...
* 🔄 **Lệnh quản trị /bank reload**: Tải lại toàn bộ cấu hình và ngôn ngữ mà không cần restart server.

***

#### 🔧 Yêu cầu:

* ✅ **Vault** (bắt buộc)
* ✅ **PlaceholderAPI** *(khuyến nghị để sử dụng placeholder)*
* ✅ Máy chủ Paper/Purpur/Spigot 1.16+ (hỗ trợ tốt nhất 1.17 – 1.21.x)

***

#### 🛠️ Cấu hình nhanh:

Tất cả nội dung hiển thị (GUI, text, tên item, lore...) đều cấu hình được trong `lang.yml` với hỗ trợ màu `&`, hex `#FFFFFF`, và **CustomModelData** nếu bạn dùng resource pack riêng.

***

**🏧 Quản Lý Tài Khoản Ngân Hàng**

* Tạo tài khoản bằng lệnh `/bank create`
* Xem thông tin tài khoản qua GUI hoặc lệnh `/bank`.
* Số tài khoản duy nhất, hiển thị ngày mở và tên chủ tài khoản.

**💸 Chuyển Khoản Người Chơi**

* Lệnh `/ck <người chơi|số tài khoản> <số tiền>` để chuyển tiền.
* Kiểm tra số dư, thông báo rõ ràng, bảo vệ chống gửi cho chính mình.

**💰 Gửi Tiết Kiệm Sinh Lời**

* Mở menu gửi tiết kiệm với nhiều kỳ hạn: 1, 3, 6, 12 tháng...
* Tự động tính lãi dựa theo kỳ hạn và lãi suất cấu hình.
* Hỗ trợ:
  * **Gửi mới (reset kỳ hạn)**
  * **Gửi thêm (giữ kỳ hạn cũ)** nếu đã có khoản gửi

**🧾 Kiểm Tra & Rút Tiền Gửi, Gửi thêm**

* Lệnh `/bank saving list` hiển thị khoản tiết kiệm.
* `/bank saving withdraw` để rút khi đến hạn (tự tính lãi).
* `/bank saving earlywithdraw` để rút sớm, **không có lãi**.
* `/bank saving menu` để gửi thêm tiền vào **tài khoản tiết kiệm**.
* Hệ thống lưu dữ liệu bằng SQLite/MySQL tùy cấu hình.

**📊 Giao Diện Đẹp & Tuỳ Biến**

* Menu GUI dễ sử dụng, thiết kế trực quan.
* Tuỳ chỉnh nội dung, item, custom model data, âm thanh, màu sắc.
* Hỗ trợ ngôn ngữ đa dạng qua `lang.yml`.

***

#### 🔧 Hỗ Trợ Plugin & API

* Hỗ trợ **Vault** để lấy tiền ngoài ngân hàng (Vault balance).
* Hỗ trợ **PlaceholderAPI** để hiển thị tiền gửi, lãi suất,...
* Dễ dàng cấu hình: lãi suất, thời hạn, tích hợp sePay,...

***

#### 🔒 Bảo Mật & Đáng Tin Cậy

* Kiểm tra kỹ đầu vào để tránh lỗi người dùng.
* Không thể chuyển tiền cho chính mình.
* Tất cả dữ liệu lưu trữ an toàn bằng SQLite hoặc MySQL.

***

#### 👑 Tác giả:

* 🔧 Phát triển bởi Kazami <mark style="color:purple;">**Studio**</mark>
* 🌐 Website: *<mark style="color:red;">đang cập nhật</mark>*
* 💬 Hỗ trợ: [Discord Kazami Studio](https://discord.gg/kQsg6JyT)


---

# 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-bank.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.