==================================================
COWQUEST v5.3.1
==================================================
Plugin nhiệm vụ 26 cấp cho Minecraft 1.21, có menu kiểu DeluxeMenus
và form có icon cho người chơi Bedrock (PE).
Plugin dùng thêm (không bắt buộc): PlaceholderAPI, Vault, PlayerPoints, Floodgate
--------------------------------------------------
I. CHỨC NĂNG
--------------------------------------------------
1. Hệ thống nhiệm vụ
- 5 nhóm có sẵn, mỗi nhóm 26 cấp: Tiều Phu, Thợ Mỏ, Nông Dân, Ngư Dân, Thợ Săn
- Loại mục tiêu: đào/phá block, đặt block, giết quái, giết người chơi
ngẫu nhiên, câu cá, chế tạo, nung, nhân giống, ăn uống, phù phép
- Chỉ tiêu tăng dần theo công thức base + growth, có thể mở thêm mục tiêu
ở cấp cao (min-level)
- Phần thưởng riêng cho từng cấp (lệnh console + chữ thông báo)
- Nhận / hủy nhiệm vụ, giới hạn số nhóm làm cùng lúc
- Mở khóa nhóm theo quyền hoặc theo cấp của nhóm khác
- Bỏ qua Creative và các world bị tắt
- Hiện tiến độ trên action bar, tiêu đề khi xong cấp, âm thanh tùy chỉnh
2. Tự reset nhiệm vụ
- Hoàn thành TẤT CẢ nhiệm vụ -> sau một khoảng thời gian (mặc định 1 ngày,
tính giờ thật kể cả lúc offline) tiến độ được đặt lại
- Chạy lệnh khi hoàn thành / khi reset, báo người chơi hoặc cả server
3. Menu tùy chỉnh (thư mục menus/)
- Tương thích cú pháp DeluxeMenus: copy menu cũ vào rồi /cowquest menu reload
- Điều kiện: quyền, tiền, exp, vật phẩm, so sánh, regex...
- Hành động: [player] [console] [openguimenu] [takemoney] [sound] [title]...
- Thay giao diện /nv bằng menu tự thiết kế (gui.yml -> custom-menu)
4. Người chơi Bedrock (PE)
- Cần Floodgate. Người chơi PE nhận form có icon thay cho giao diện rương
- Menu tùy chỉnh tự chuyển thành form, người chơi Java không bị ảnh hưởng
5. Kinh tế và tiền tệ
- Vault hoặc kinh tế riêng của plugin
- Loại tiền: money, xu (PlayerPoints), cấp exp, điểm exp, vật phẩm
(kim cương...), tiền tùy chỉnh qua placeholder
6. Bảng xếp hạng: /nv top (tổng và theo từng nhóm)
7. PlaceholderAPI
%cowquest_total% %cowquest_rank% %cowquest_active% %cowquest_balance%
%cowquest_level_<nhóm>% %cowquest_done_<nhóm>% %cowquest_percent_<nhóm>%
%cowquest_name_<nhóm>% %cowquest_status_<nhóm>% %cowquest_bar_<nhóm>%
%cowquest_obj_<nhóm>_1% (dòng mục tiêu số 1, 2, 3...)
%cowquest_top_1_name% %cowquest_top_1_value%
%cowquest_top_<nhóm>_1_name%
%cowquest_reset_in% %cowquest_reset_seconds% %cowquest_resets%
%cowquest_all_complete%
8. Tùy chỉnh lệnh (commands.yml): tên, alias, quyền, mở thẳng nhóm hoặc menu
Ví dụ: tieuphu: { action: "quest:tieuphu" } -> /tieuphu mở thẳng nhóm Tiều Phu
9. Tự chép dữ liệu từ thư mục CowQuest-Premium cũ sang CowQuest
--------------------------------------------------
II. LỆNH VÀ QUYỀN
--------------------------------------------------
/nv (/nhiemvu, /quest) mở menu nhiệm vụ
/nv nhan <nhóm> nhận nhiệm vụ
/nv huy <nhóm> hủy nhiệm vụ
/nv top [nhóm] bảng xếp hạng
/cowquest (/cq) help danh sách lệnh
/cowquest menu open <id> [người] [tham số]
/cowquest menu list | reload
/cowquest form kiểm tra form PE / Floodgate (admin)
/cowquest reload tải lại cấu hình (admin)
/cowquest eco ... quản lý tiền (admin)
/cowquest reset | setlevel ... quản lý tiến độ (admin)
Quyền: cowquest.use (mặc định ai cũng có), cowquest.admin (op)
--------------------------------------------------
III. CẤU TRÚC FILE (plugins/CowQuest/)
--------------------------------------------------
config.yml cài đặt chung (kiểu chữ, nhận nhiệm vụ, kinh tế, tiền tệ, reset)
messages.yml mọi tin nhắn
commands.yml tùy chỉnh lệnh
gui.yml giao diện rương
forms.yml form + icon cho người chơi PE
quests/*.yml mỗi nhóm nhiệm vụ 1 file (tên file = ID nhóm)
menus/*.yml menu tùy chỉnh (tên file = id menu)
data.yml tiến độ người chơi
balances.yml số dư (kinh tế riêng)
Sửa file xong gõ /cowquest reload
--------------------------------------------------
IV. GIAO DIỆN MẪU (ký hiệu dùng chung)
--------------------------------------------------
# = kính đen (viền) C = kính xanh (góc) . = ô trống
Số liệu trong mẫu (cấp 9, 35%...) chỉ để minh họa.
--------------------------------------------------
1) MENU CHÍNH /nv (rương 6 hàng)
Tiêu đề: "Hệ thống nhiệm vụ"
--------------------------------------------------
C # # # H # # # C
# . . . . . . . #
# . . . . . . . #
# . . a b c d e # (slot 20-24: các nhóm nhiệm vụ)
# . . . . . . . #
C # # # X T # # C
H = Hồ sơ người chơi (slot 4): Tổng tiến độ 12/130, đang làm 3 nhóm
a = Tiều Phu b = Thợ Săn c = Thợ Mỏ d = Nông Dân e = Ngư Dân
T = Đồng hồ "Làm mới nhiệm vụ" (slot 50)
X = Đóng (slot 49)
Tooltip mỗi nhóm:
Tiều Phu
Chặt gỗ, xây nhà, làm mái.
Cấp độ: 9/26
████░░░░░░░░ 35%
● Đang thực hiện
▸ Nhiệm vụ hiện tại
• Chặt gỗ : 12/48
• Xây nhà : 0/16
▶ Chuột trái: xem chi tiết
▶ Chuột phải: nhận nhiệm vụ
▶ Shift + chuột phải: hủy nhiệm vụ
--------------------------------------------------
2) MENU NHÓM (26 cấp), ví dụ Tiều Phu
--------------------------------------------------
C # # # I # # # C
# . 1 2 3 4 5 6 7 # (slot 10-16)
# . 8 9 . . . . . # (slot 19-25)
# . . . . . . . . # (slot 28-34)
# . . . . . . . . # (slot 37-41)
B # P # A # N # C
I = Thông tin nhóm (slot 4)
Cấp 1-8 = kính xanh lá, "✔ Cấp N", đã hoàn thành
Cấp 9 = vật phẩm của nhóm, "Cấp 9 (đang làm)"
Cấp 10-26 = kính xám, "Chưa mở khóa"
B = Quay lại (slot 45) P = Nhóm trước (slot 47)
A = Nhận / Hủy / Chưa mở khóa (slot 49)
N = Nhóm sau (slot 51)
Nút ở slot 49 đổi theo trạng thái:
Nhận nhiệm vụ (ngọc lục bảo, sáng) khi chưa nhận
Hủy nhiệm vụ (thuốc nhuộm đỏ) khi đang làm, Shift + chuột trái để hủy
Chưa mở khóa (barrier) khi chưa đủ điều kiện
--------------------------------------------------
3) MENU TÙY CHỈNH nv.yml (rương 5 hàng)
Bật: gui.yml -> custom-menu: main: "nv"
Tiêu đề: "NHIỆM VỤ"
--------------------------------------------------
# # # # # # # # #
# . a . b . c . # (slot 11, 13, 15)
# . . d . e . . # (slot 21, 23)
# . . . T . . . # (slot 31)
# # # # X # # # # (slot 40)
a = Tiều Phu (rìu sắt) b = Thợ Săn (cung) c = Thợ Mỏ (cuốc sắt)
d = Nông Dân (cuốc) e = Ngư Dân (cần câu)
T = Đồng hồ làm mới X = Đóng
Chuột trái = xem chi tiết, chuột phải = nhận, Shift + chuột phải = hủy
--------------------------------------------------
4) MENU chinh.yml (rương 3 hàng, lệnh /menuchinh)
Tiêu đề: "MENU CHÍNH"
--------------------------------------------------
# # # # # # # # #
# . N . R . H . # (slot 11, 13, 15)
# # # # X # # # # (slot 22)
N = Nhiệm vụ (sách và bút) -> chạy /nhiemvu
R = Bảng xếp hạng (mũ vàng): "Hạng của bạn: #3"
H = Đầu người chơi
X = Đóng
--------------------------------------------------
5) MENU vidu.yml (rương 4 hàng, lệnh /cqvidu)
Tiêu đề: "Ví dụ (số lượng)"
--------------------------------------------------
# # # # # # # # #
# . S . M . G . # (slot 11, 13, 15)
# # # # # # # # #
# # # # A # # # # (slot 31)
S = Kiếm kim cương (đổi thành "Không đủ tiền" nếu thiếu tiền)
M = May rủi (giấy) G = Giờ theo world (đồng hồ)
A = Chỉ admin (command block)
--------------------------------------------------
6) FORM BEDROCK (PE)
--------------------------------------------------
Form 1 - Menu chính
┌──────────────────────────────┐
│ Hệ thống nhiệm vụ │
│ Tổng tiến độ: 12/130 │
│ Làm mới sau: 23 giờ 40 phút │
│ Chọn một nhóm nhiệm vụ để │
│ xem chi tiết. │
│ [icon] Tiều Phu │
│ Cấp 9/26 • Đang làm │
│ [icon] Thợ Săn │
│ Cấp 4/26 • Đang làm │
│ [icon] Thợ Mỏ │
│ Cấp 1/26 • Chưa nhận │
│ [icon] Nông Dân │
│ Cấp 1/26 • Chưa nhận │
│ [icon] Ngư Dân │
│ Cấp 26/26 * Hoàn thành│
│ [x] Đóng │
└──────────────────────────────┘
Form 2 - Chi tiết một nhóm
┌──────────────────────────────┐
│ Tiều Phu │
│ Chặt gỗ, xây nhà, làm mái. │
│ Hoàn thành: 8/26 │
│ • Đang thực hiện │
│ » Nhiệm vụ hiện tại │
│ • Chặt gỗ : 12/78 │
│ [x] Hủy nhiệm vụ │
│ [sách] Xem tất cả cấp │
│ [<-] Nhóm trước: Thợ Săn │
│ [->] Nhóm sau: Thợ Mỏ │
│ [<-] Quay lại │
└──────────────────────────────┘
(Chưa nhận: nút "Nhận nhiệm vụ" thay cho "Hủy nhiệm vụ")
(Chưa mở khóa: nút "Chưa mở khóa")
Form 3 - Tất cả cấp
┌──────────────────────────────┐
│ Tiều Phu - các cấp │
│ ✔ Cấp 1 ... ✔ Cấp 8 │
│ » Cấp 9 (đang làm) │
│ Cấp 10 ... 26: chưa mở khóa │
│ [<-] Quay lại │
└──────────────────────────────┘
Form 4 - Xác nhận hủy
┌──────────────────────────────┐
│ Hủy nhiệm vụ Tiều Phu? │
│ Bạn sẽ mất tiến độ của cấp │
│ hiện tại. │
│ [x] Hủy nhiệm vụ │
│ [v] Giữ lại │
└──────────────────────────────┘
Ghi chú form PE: Bedrock chỉ có 16 màu chữ nên màu hex tự đổi sang màu
gần nhất; các ký tự ▸ ▶ ◀ ● ★ được thay bằng » » « • *.
Menu tùy chỉnh: mỗi vật phẩm có hành động click thành 1 nút form, vật phẩm
trang trí bị bỏ.
--------------------------------------------------
V. KHẮC PHỤC NHANH
--------------------------------------------------
- Lệnh bị plugin khác chiếm: dùng /cowquest:<lệnh> hoặc đặt
override-existing: true trong commands.yml
- Menu không mở: xem log khi /cowquest menu reload (cảnh báo bắt đầu bằng [menu])
- Người chơi PE không thấy form: cài Floodgate, kiểm tra /cowquest form,
xem log có dòng [form]
- Icon nút PE bị ô tím-đen: dùng icons.auto: curated hoặc ghi icon riêng
(url: hoặc path:) trong forms.yml
- Tiền PlayerPoints không chạy: cần plugin PlayerPoints bật, currency type: points