TRUNG TÂM TÀI LIỆU KỸ THUẬT & HƯỚNG DẪN

Tài Liệu Tích Hợp & Sử Dụng Plugin

Hướng dẫn đầy đủ về cách cài đặt plugin bản quyền, cơ chế gắn IP tự động, di dời server và quy trình bảo vệ bản quyền số DLStore Shield™ cho Developer.

Dành Cho Khách Mua (Buyer) Dành Cho Tác Giả (Creator) Bảng Mã Lỗi In-Game

1. Hướng Dẫn Cài Đặt Cho Khách Hàng

Các bước đưa plugin vào máy chủ và kích hoạt bản quyền

1 Tải File .JAR Chính Thức

Sau khi thanh toán thành công, truy cập vào menu Plugin Của Tôi và bấm nút "Tải Bản Mới Nhất".

Lưu ý: File tải về đã được sàn tự động nhúng sẵn License Key và Dấu vân tay số của tài khoản bạn. Bạn không cần phải mở file ra để sửa bất kỳ thứ gì.

2 Cài Đặt Vào Server Minecraft & Kích Hoạt Tự Động

Chép file .jar vào thư mục plugins/ của máy chủ Minecraft (hỗ trợ Paper, Spigot, Purpur, Folia) và khởi động máy chủ.

[INFO]: [DLStoreVN] Đang kiểm tra bản quyền plugin...
[INFO]: [DLStoreVN] ✓ Bản quyền hợp lệ! Plugin đã kích hoạt và gắn IP máy chủ thành công.

3 Di Dời Máy Chủ Hoặc Đổi Nhà Cung Cấp VPS (Reset IP Binding)

Mỗi giấy phép mặc định cho phép chạy trên tối đa 2 địa chỉ IP máy chủ độc lập cùng lúc. Khi bạn chuyển sang máy chủ hoặc VPS mới:

  1. Vào mục Plugin Của Tôi trên web.
  2. Bấm nút Reset IP Binding dưới plugin tương ứng.
  3. Bật máy chủ mới lên $\rightarrow$ Plugin sẽ tự động nhận diện và gắn IP máy chủ mới tức thì.

2. Công Nghệ Bảo Vệ DLStore Shield™ Cho Seller

Bảo vệ sản phẩm 100% tự động, chống leak và decompile

Tự Động Tiêm Bytecode DRM

Khi tải file JAR thô lên, máy chủ tự động dùng Javassist chèn mã kiểm tra bản quyền vào đầu phương thức onEnable() của Class chính và nhúng SDK xác thực. Seller không cần viết thêm mã vào source code.

Làm Rối Mã Nguồn (ProGuard)

Toàn bộ class logic nội bộ, tên biến, tên hàm được mã hóa và làm rối, chỉ bảo toàn các API Bukkit/@EventHandler cần thiết, giúp chống dịch ngược mã nguồn tuyệt đối mà không ảnh hưởng hiệu năng TPS.

Constant Pool Invisible Watermark

Khi người mua tải plugin về, chữ ký bản quyền số được khắc chìm trực tiếp vào mã máy nhị phân Constant Pool. Nếu người mua phát tán file ra ngoài, công cụ Check Bản Quyền sẽ phát hiện chính xác danh tính người leak.

3. Bảng Mã Lỗi Xác Thực Thường Gặp

Ý nghĩa các thông báo xuất hiện trong console máy chủ
Mã Lỗi Thông Báo Console Cách Khắc Phục
ip_unauthorized IP Server chưa được cấp phép (đạt tối đa số slot). Truy cập Dashboard DLStoreVN $\rightarrow$ Bấm Reset IP Binding rồi khởi động lại server.
inactive / revoked License này đã bị vô hiệu hóa hoặc tạm khóa. Liên hệ hỗ trợ DLStoreVN để kiểm tra nguyên nhân giấy phép bị tạm ngưng.
not_found License Key không tồn tại trên hệ thống. Tải lại file plugin chính thức từ tài khoản của bạn tại store.dlvn.app.
connection_failed Không thể kết nối đến máy chủ xác thực. Kiểm tra kết nối mạng Internet hoặc tường lửa (Firewall) của máy chủ Minecraft.