1. MÔ TẢ | DESCRIPTION

- Plugin GiftCode: Quản lý, phát hành và đổi mã quà tặng (gift code) cho server Minecraft (Spigot/Paper).

- Hỗ trợ phần thưởng đa dạng: lệnh console, vật phẩm, tiền, permission, giới hạn số lần sử dụng, giới hạn IP, yêu cầu permission, thời gian chơi tối thiểu, PlaceholderAPI, reload, đa ngôn ngữ.

- GiftCode plugin: Manage, generate and redeem gift codes for Minecraft servers (Spigot/Paper). Supports various rewards, usage limits, IP limits, permission, min playtime, PlaceholderAPI, reload, multi-language.


- Tương thích Paper/Spigot 1.13+.

- Compatible with Paper/Spigot 1.13+.


2. LỆNH CHÍNH | MAIN COMMANDS

Sử dụng: /giftcode <subcommand>

Usage: /giftcode <subcommand>


- <code> : Nhập gift code để nhận thưởng

→ Redeem a gift code


- reload : Tải lại cấu hình plugin

→ Reload plugin configuration


- admin create -n <code> -c <command> ... -u <maxuser> -ip <maxip> [-p <permission>] [-t <minplaytime>(phút)]

→ Tạo gift code mới | Create a new gift code

Ví dụ | Example: /giftcode admin create -n summer2025 -c give %player% diamond 5 -u 100 -ip 2 -p giftcode.vip -t 30m


- admin remove <code>

→ Xóa gift code | Remove a gift code


- admin reward add <command> <code>

→ Thêm phần thưởng vào code | Add reward to code


- admin reward remove <command> <code>

→ Xóa phần thưởng khỏi code | Remove reward from code


3. QUYỀN | PERMISSIONS

- giftcode.admin : Toàn quyền quản lý, tạo, xóa, chỉnh sửa, reload gift code.

→ Full access to manage, create, remove, edit, reload gift codes.


- giftcode.use : Quyền sử dụng mã (mặc định ai cũng dùng được, trừ khi code yêu cầu permission riêng).

→ Permission to redeem codes (default: everyone unless code requires specific permission).


4. PLACEHOLDERAPI

Plugin hỗ trợ các placeholder sau (dùng cho Hologram, tablist, scoreboard...)

The plugin supports the following placeholders (for use in Holograms, tablists, scoreboards...)


%gf_top1%, %gf_top2%, ... : Hiển thị code có số lượt sử dụng cao nhất (theo config.yml: top)

→ Shows top used codes (see config.yml: top)


Có thể dùng %player% trong lệnh thưởng để thay thế tên người chơi.

You can use %player% in reward commands to substitute player name.


5. CẤU HÌNH | CONFIGURATION

- Sửa file config.yml để định nghĩa gift code, phần thưởng, giới hạn, permission, minplaytime, v.v.

- Edit config.yml to define gift codes, rewards, limits, permission, minplaytime, etc.




- Sửa file lang.yml để thay đổi prefix, thông báo, title, broadcast khi nhận code.

- Edit lang.yml to change prefix, messages, title, broadcast on code redeem.



6. LƯU Ý | NOTES

- Mỗi code có thể giới hạn số lần sử dụng tổng, số lần theo IP, permission, thời gian chơi tối thiểu (minplaytime, đơn vị giây).

- Each code can limit total uses, per-IP uses, permission, min playtime (seconds).


- Dữ liệu người dùng lưu ở user.yml, không nên chỉnh sửa thủ công.

- User data is stored in user.yml, do not edit manually.


- Hỗ trợ mọi phiên bản Spigot/Paper từ 1.13 trở lên.

- Supports all Spigot/Paper versions from 1.13+.


- Nếu dùng PlaceholderAPI, plugin sẽ tự động đăng ký expansion.

- If PlaceholderAPI is present, plugin auto-registers expansion.


7.TÍNH NĂNG ẨN|HIDE FEATURES

- Tạo, xóa, chỉnh sửa gift code bằng lệnh.

- Hỗ trợ nhiều loại phần thưởng: lệnh console, tiền, vật phẩm, permission.

- Giới hạn số lần sử dụng theo người chơi và theo IP.

- Yêu cầu permission hoặc thời gian chơi tối thiểu để nhận code.

- Lưu trữ dữ liệu an toàn qua file user.yml.

- Reload cấu hình và ngôn ngữ không cần restart server.

- Hỗ trợ PlaceholderAPI (top code, playtime, v.v.).

- Thông báo, title khi nhận code thành công.

- Tab completion thông minh cho admin và người chơi.

- Tự hiển thị code trong config.yml khi người dùng nhập lệnh (nếu code có yêu cầu quyền,người dùng cần có quyền để hiển thị và sử dụng)