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:

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:

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