Plugin Việt Nam FarmContest | Tạo cuộc thi khai thác nông sản | Nông sản đột biến v2.0.2-RELEASE

FarmContest​

---

Tính Năng Nổi Bật​

1. Hệ Thống Cuộc Thi Nông Sản Tự Động (Farm Contest)​

• Xoay tua tự động: Tự động bắt đầu/kết thúc cuộc thi và chọn ngẫu nhiên các loại nông sản (Mía, Xương rồng, Bí ngô, Dưa hấu, Lúa mì...) theo lịch trình.
• Bảng xếp hạng thời gian thực: Tính điểm, cập nhật thứ hạng và trả thưởng chính xác tuyệt đối cho từng người chơi.
• Giao diện BossBar trực quan: Hiển thị thời gian đếm ngược và trạng thái điểm số ngay trên màn hình.
• Chống gian lận (Anti-Cheat) thông minh: Tự động ghi nhớ các khối do người chơi tự đặt để ngăn chặn việc đặt xuống - phá ra lấy điểm vô hạn.

---

2. Nông Sản Đột Biến (Mutation System) & Shop GUI​

• Đột biến ngẫu nhiên: Thu hoạch nông sản có tỷ lệ nhận được nông sản đột biến với các thuộc tính siêu hiếm và hệ số nhân điểm (Multiplier) cực khủng.
• Phụ thuộc Biome: Một số loại đột biến chỉ xuất hiện ở các vùng sinh thái (Biome) nhất định, khuyến khích người chơi khám phá thế giới.
• Cửa hàng Đột Biến (Mutation Shop): Giao diện GUI đẹp mắt cho phép người chơi mua bán, trao đổi và nâng cấp các loại hạt giống/nông sản đột biến.

---

3. Lưu Trữ Dữ Liệu & Tích Hợp Linh Hoạt​

• Đa nền tảng Database: Hỗ trợ SQLite (mặc định, không cần cài đặt thêm).
• Đồng bộ mượt mà: Tự động tải/lưu dữ liệu người chơi khi Tham gia (Join) hoặc Thoát (Quit) server mà không gây lag.
• Tích hợp Vault: Hỗ trợ thưởng tiền trực tiếp vào tài khoản ngân hàng của người chơi.
• Tích hợp PlaceholderAPI: Dễ dàng đưa điểm số, thứ hạng lên Scoreboard, Tablist, Hologram hoặc Chat format.

---

Hướng Dẫn Cài Đặt​

1. Tải file FarmContest.jar mới nhất ở mục Releases.
2. Đặt file .jar vào thư mục /plugins/ của máy chủ.
3. (Khuyên dùng)Cài đặt thêm các plugin hỗ trợ:
   • Vault (Để thưởng tiền) - Plugin Economy
   • PlaceholderAPI (Để hiển thị thông số lên Scoreboard/Tab).
4. Khởi động lại Server để plugin tự tạo file cấu hình.

---

Lệnh & Phân Quyền​

/farmcontest help — hiện danh sách lệnh (không quyền, ai cũng dùng được)


/farmcontest start — bắt đầu contest (quyền: farmcontest.admin)


/farmcontest stop — dừng contest (quyền: farmcontest.admin)


/farmcontest top — xem bảng xếp hạng điểm top 10 (không quyền riêng, nhưng yêu cầu contest đang chạy)


/farmcontest info [player] — xem điểm bản thân; nếu thêm [player] cần quyền farmcontest.info.other


/farmcontest profile [player] — xem hồ sơ nông dân (số cuộc thi tham gia, số lần top1/2/3, tổng nông sản thu hoạch); nếu xem người khác cần quyền farmcontest.profile.other


/farmcontest shop — mở GUI shop thu mua nông sản đột biến (yêu cầu có Vault, chỉ người chơi dùng được)


/farmcontest mutation give <player> <crop> <mutation> [weight_min] [weight_max] — trao nông sản đột biến cho người chơi, có thể tuỳ chỉnh khoảng cân nặng (quyền: farmcontest.admin)


/farmcontest add <player> <points> [silent:true/false] — cộng điểm cho người chơi, chỉ hoạt động khi contest đang chạy (quyền: farmcontest.admin)


/farmcontest take <player> <points> [silent:true/false] — trừ điểm người chơi, chỉ hoạt động khi contest đang chạy (quyền: farmcontest.admin)


/farmcontest set <player> <points> [silent:true/false] — gán điểm cụ thể cho người chơi, chỉ hoạt động khi contest đang chạy (quyền: farmcontest.admin)


/farmcontest reset — xóa dữ liệu điểm của contest (quyền: farmcontest.admin)


/farmcontest reload — tải lại config.yml và mutation.yml (quyền: farmcontest.admin)


/farmcontest time — xem thời gian còn lại tới contest tiếp theo (không quyền riêng)


Alias: /fc dùng thay cho /farmcontest, cú pháp giống hệt.

---

Tích Hợp PlaceholderAPI​

Sử dụng các placeholder sau trong Scoreboard (FeatherBoard, TAB...), Chat hoặc Hologram:

• %farmcontest_status% — Trạng thái cuộc thi (Đang diễn ra / Đã kết thúc).
• %farmcontest_time_remaining% — Thời gian còn lại của cuộc thi.
• %farmcontest_crop% — Loại nông sản đang thi đấu trong vòng này.
• %farmcontest_score% — Điểm số hiện tại của người chơi.
• %farmcontest_position% — Thứ hạng hiện tại của người chơi trong BXH.

---

Khả Năng Tương Thích​

• Phiên bản Minecraft hỗ trợ: 1.20.4 - 1.21.x (và các bản nâng cấp tương lai).
• Software: Paper, Spigot, Purpur

---