> For the complete documentation index, see [llms.txt](https://kazamis.gitbook.io/kazami-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kazamis.gitbook.io/kazami-studio/wiki-bank.md).

# 🏦 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)