1. Mục đích
MCLink2 giúp bạn tạo link rút gọn kèm “mã xác minh” để người chơi thực hiện nhiệm vụ bên ngoài sau khi hoàn thành xong người chơi sẽ được chuyển đến web CODE sẽ nằm trên URL(thanh địa chỉ), sau đó nhập CODE về trong game để nhận thưởng (coin & point). Tất cả cài đặt (số lần, phần thưởng, thông báo…) đều nằm trong config.yml, dễ dàng tùy chỉnh.

2. Yêu cầu kèm theo

• Server: Paper/Spigot (những server khác chưa test), phiên bản mới test ở 1.21 (test ở những bản khác giúp tui, báo lại ở: https://discord.gg/wwCxYgpsKh).
  
  
• Vault (nếu bật coin): thả Vault.jar vào plugins/
  
  
• Plugin Economy (ví dụ EssentialsX, CMI, XConomy…) để Vault có provider
  
  
• PlayerPoints (nếu bật point): thả PlayerPoints.jar vào plugins/
  

Nếu bạn chỉ cần point, đơn giản tắt coin ở config; ngược lại tắt point nếu không dùng.

3. Cài đặt

1. Copy mclink2.jar vào thư mục plugins/.
   
   
2. Đảm bảo đã cài plugin Vault + plugin Economy và PlayerPoints.
   
   
3. Khởi động server lần đầu để tạo plugins/mclink2/config.yml.
   

4. Cấu hình (config.yml)
Mở plugins/mclink2/config.yml, chỉnh các phần sau:

# Thông tin API (bắt buộc)
token: "YOUR_TOKEN_API"
format: "json" # hoặc "text"
original-url: " https://example.com/task?player=<player>"

# Thưởng cho người chơi
enableCoins: true # NÊN CHỈNH rewardCoins VỀ 0 THAY VÌ TẮT | true để bật coin, false để tắt
rewardCoins: 10.0 # số coin mỗi lần verify

enablePoints: true # NÊN CHỈNH rewardPoints VỀ 0 THAY VÌ TẮT | true để bật point, false để tắt
rewardPoints: 5 # số point mỗi lần verify

# Độ dài mã (nếu random)
codeLength: 8

# Giới hạn hoạt động (trong perHours giờ)
limits:
getcode:
max: 5 # tối đa /getcode
perHours: 24
verifycode:
max: 3 # tối đa /verifycode
perHours: 24

# Tùy chỉnh thông báo hiển thị
messages:
prefix: "&7[&bMCLink2&7] "
getcode:
notPlayer: "&cChỉ người chơi mới có thể sử dụng lệnh này."
limitExceeded: "&cBạn chỉ được tạo tối đa &6{max}&c link trong &6{hours}&c giờ."
linkGenerated: "&aLink rút gọn của bạn: &b{url}"
apiError: "&cLỗi khi kết nối API: HTTP &6{code}"
apiStatusError: "&cAPI trả về lỗi: &6{status}"
linkError: "&cAPI trả về lỗi khi rút gọn link."
unexpectedError: "&cĐã có lỗi xảy ra: &6{error}"
verifycode:
notPlayer: "&cChỉ người chơi mới có thể sử dụng lệnh này."
usage: "&cUsage: /verifycode <code>"
limitExceeded: "&cBạn chỉ được nhận thưởng tối đa &6{max}&c lần trong &6{hours}&c giờ."
invalidCode: "&cMã không hợp lệ hoặc đã sử dụng."
success: "&aXác minh thành công! Bạn nhận được &6{coins}&a coins và &6{points}&a points."
reload:
noPermission: "&cBạn không có quyền sử dụng lệnh này."
success: "&aĐã reload lại config thành công."

• token, format, original-url: thông tin gọi API rút gọn.
  
  
• enableCoins/enablePoints & rewardCoins/rewardPoints: bật/tắt và số lượng thưởng.
  
  
• codeLength: độ dài mã khi random.
  
  
• limits: điều chỉnh số lần sử dụng lệnh trong khung giờ.
  
  
• messages: mọi thông báo đều lấy từ đây, thay {…} bằng giá trị thực.
  

5. Các lệnh sử dụng

Lệnh Mô tả
/getcode Tạo link rút gọn,vượt xong link xong nhận CODE; giới hạn theo config.limits
/verifycode <mã> Nhập CODE, nhận thưởng; giới hạn theo config.limits
/reload (alias) Reload lại config mà không cần restart server

• Với /reload, cần permission mclink2.reload (mặc định op có).
  

6. Ví dụ sử dụng

1. Người chơi gõ:
   
   /getcode
   
   → Chat hiển thị:
   [MCLink2] Link rút gọn của bạn: https://short.url/xyz123
   
   
2. Hoàn thành nhiệm vụ ngoài web, quay lại gõ:
   
   /verifycode ABCD1234
   
   → Chat hiển thị:
   [MCLink2] Xác minh thành công! Bạn nhận được 10.0 coins và 5 points.
   

7. Lưu ý

• URL gốc (original-url) PHẢI hợp lệ: bắt đầu http:// hoặc https://.
  
  
• Nếu không dùng coin, set enableCoins: false; tương tự với point.
  
  
• Mã pending chỉ lưu tạm trong RAM; server restart sẽ mất. Nếu cần bền, bạn phải mở rộng lưu vào file hoặc DB.
  
  
• Khi cập nhật config.yml, dùng /reload để áp dụng ngay.