Plugin Việt Nam ZOE-HOME [ FREE ] 2026-01-24

# ZOE-HOMES
**[English Below]**
## Tiếng Việt
**ZOE-HOMES** là một plugin quản lý home (nhà) chuyên nghiệp dành cho máy chủ Minecraft, hỗ trợ GUI trực quan và hệ thống ngôn ngữ linh hoạt. Plugin được thiết kế để mang lại trải nghiệm tốt nhất cho người chơi với giao diện đẹp mắt và dễ sử dụng.
### Tính Năng
* **Giao Diện GUI Trực Quan* Quản lý danh sách home thông qua giao diện GUI đẹp mắt (hỗ trợ phân trang).
* **Hệ Thống Phân Quyền Chi Tiết* Giới hạn số lượng home cho từng nhóm người chơi thông qua permission (`zhome1` - `zhome100`).
* **Đa Ngôn Ngữ* Hỗ trợ nhiều ngôn ngữ (Mặc định: Tiếng Việt và Tiếng Anh), có thể tùy chỉnh toàn bộ tin nhắn.
* **Tùy Chỉnh Prefix* Cho phép hiển thị prefix (tiền tố) màu sắc cho tên home trong GUI.
* **Admin Command* Lệnh dành cho Admin để dịch chuyển đến home của người chơi khác.
* **Hỗ Trợ Folia* Tương thích với server Folia và các server 1.20+.
### Cài Đặt
1. Tải file `.jar` và bỏ vào thư mục `plugins` của server.
2. Khởi động lại server.
3. Chỉnh sửa `config.yml` và các file ngôn ngữ trong thư mục `plugins/ZOE-HOMES/` theo ý muốn.
4. Dùng lệnh `/zhome reload` để cập nhật thay đổi.
### Lệnh (Commands)
Alias: `/zhome`, `/home`, `/homes`
| Lệnh | Mô Tả | Quyền (Permission) |
| :--- | :--- | :--- |
| `/zhome` | Mở GUI danh sách home (hoặc xem danh sách lệnh nếu tắt GUI trong config). | Mặc định |
| `/zhome set <tên>` | Đặt home mới tại vị trí đang đứng. | Mặc định |
| `/zhome delete <số_thứ_tự>` | Xóa home theo số thứ tự. | Mặc định |
| `/zhome tp <số_thứ_tự>` | Dịch chuyển đến home. | Mặc định |
| `/zhome rename <số> <tên_mới>` | Đổi tên home. | Mặc định |
| `/zhome list` | Xem danh sách home dạng chat. | Mặc định |
| `/zhome reload` | Tải lại file config và ngôn ngữ. | `zhomes.admin` |
| `/homeadmin <player> <home>` | Dịch chuyển đến home của người chơi khác. | `zhomes.admin` |
### ️ Quyền Hạn (Permissions)
* `zhomes.admin`: Quyền quản trị viên (dùng lệnh reload, homeadmin, không giới hạn home).
* `zhome<số>`: Giới hạn số lượng home tối đa mà người chơi có thể đặt.
* Ví dụ: `zhome1` (1 home), `zhome5` (5 homes), `zhome100` (100 homes).
* Hệ thống sẽ lấy số lớn nhất mà người chơi có quyền.
### Cấu Hình (Configuration)
Tùy chỉnh trong `config.yml`:
```yaml
settings:
lang: vi # Ngôn ngữ (vi/en/smallcap)
teleport-delay: 5 # Thời gian chờ dịch chuyển
open-gui-on-command: true # Mở GUI khi gõ /zhome không có tham số
set-home-prefix: "&b" # Màu/Prefix cho tên home trong GUI
```
---
## English
**ZOE-HOMES** is a professional home management plugin for Minecraft servers, featuring an intuitive GUI and a flexible language system. It is designed to provide the best user experience with a beautiful and easy-to-use interface.
### Features
* **Intuitive GUI* Manage homes via a sleek GUI with pagination support.
* **Granular Permissions* Limit the number of homes per player/group using permissions (`zhome1` - `zhome100`).
* **Multi-Language* Supports multiple languages (Default: Vietnamese & English), fully customizable messages.
* **Configurable Prefix* Customizable color prefixes for home names in the GUI.
* **Admin Tools* Commands for admins to teleport to other players' homes.
* **Folia Support* Compatible with Folia and modern 1.20+ servers.
### Installation
1. Download the `.jar` file and place it in your server's `plugins` folder.
2. Restart the server.
3. Configure `config.yml` and language files in `plugins/ZOE-HOMES/` as needed.
4. Use `/zhome reload` to apply changes.
### Commands
Aliases: `/zhome`, `/home`, `/homes`
| Command | Description | Permission |
| :--- | :--- | :--- |
| `/zhome` | Open Homes GUI (or show help if GUI is disabled). | Default |
| `/zhome set <name>` | Set a new home at current location. | Default |
| `/zhome delete <index>` | Delete a home by its index number. | Default |
| `/zhome tp <index>` | Teleport to a specific home. | Default |
| `/zhome rename <index> <name>` | Rename a home. | Default |
| `/zhome list` | List homes in chat. | Default |
| `/zhome reload` | Reload config and language files. | `zhomes.admin` |
| `/homeadmin <player> <home>` | Teleport to another player's home. | `zhomes.admin` |
### ️ Permissions
* `zhomes.admin`: Admin permission (reload, homeadmin, unlimited homes).
* `zhome<number>`: Limit the maximum number of homes a player can set.
* Example: `zhome1` (1 home), `zhome5` (5 homes), `zhome100` (100 homes).
* The system checks for the highest number the player has permission for.
### Configuration
Customize in `config.yml`:
```yaml
settings:
lang: en # Language (vi/en/smallcap)
teleport-delay: 5 # Teleport cooldown in seconds
open-gui-on-command: true # Open GUI on /zhome command
set-home-prefix: "&b" # Prefix/Color for home names in GUI
```
---
**Author* tsumuri19