Nâng cấp từ bản 26.3.6-premium
Điểm nổi bật
- Phần thưởng nạp lần đầu: Tặng thêm khuyến mãi và chạy lệnh thưởng cho người chơi nạp lần đầu.
- Áp dụng cho cả nạp thẻ lẫn nạp ngân hàng.
- Khuyến mãi lặp lại theo tuần và khung giờ: Đặt "giờ vàng", "cuối tuần x2" một lần là chạy mãi, không cần sửa ngày mỗi tuần.
- Tự động thông báo khuyến mãi cho cả server bằng chat và bossbar.
- Lệnh
/khuyenmaimới để người chơi xem các khuyến mãi đang chạy và sắp diễn ra. - Hỗ trợ SePay: Tự động duyệt chuyển khoản qua 11 ngân hàng.
- Không còn mất giao dịch khi người chơi thoát game: Vào lại là tiếp tục được, phần thưởng vẫn được trao đủ.
- Khóa cổng thanh toán trên database để cấu hình không bị sửa nhầm hoặc sửa trái phép.
Tính năng mới
Phần thưởng nạp lần đầu
Bật trong mục first-donate của config.yml (mặc định tắt), xem chi tiết tại Khuyến mãi nạp lần đầu.
extra-ratelà tỉ lệ khuyến mãi được cộng thêm vào lần nạp đầu tiên.1.0nghĩa là thêm 100%.- Cộng dồn với khuyến mãi đang chạy (nếu có).
commandschạy sau khi nạp thành công.- Placeholder:
%PLAYER%,%AMOUNT%,%POINT%,%POINT_UNIT%,%EXTRA_RATE%.
- Placeholder:
- Áp dụng cho cả nạp thẻ cào và nạp ngân hàng.
- Chỉ tính lần nạp thành công đầu tiên của người chơi trên server.
- Trường hợp nhiều giao dịch xử lý cùng lúc không bị tính nạp lần đầu hai lần.
- Nếu người chơi đang offline lúc nạp ngân hàng thành công, lệnh thưởng được xếp hàng và chạy khi họ vào lại server.
Khuyến mãi lặp lại hàng tuần
Ngoài kiểu "từ ngày... đến ngày..." như trước, giờ có thể hẹn khuyến mãi theo thứ trong tuần và khung giờ trong khuyenmai.yml.
- Ví dụ "giờ vàng" 18:00 - 22:00 mỗi ngày, hoặc trọn ngày thứ 7 và chủ nhật.
- Có thể kết hợp cả
daysvàhours. - Có thể giới hạn trong một khoảng
from/to.- Ví dụ: "Chỉ các cuối tuần trong tháng 9".
- File mẫu mới có sẵn nhiều ví dụ (đang để tắt), chỉ cần bỏ dấu
#là dùng được. - Thời gian nhận cả định dạng có giây
dd/MM/yyyy HH:mm:ss.- Muốn khuyến mãi kéo dài trọn ngày thì đặt
23:59:59. - Áp dụng cả cho
extra-untiltrongconfig.yml.
- Muốn khuyến mãi kéo dài trọn ngày thì đặt
Xem hướng dẫn tại Lịch khuyến mãi, hoặc dùng công cụ Tạo lịch khuyến mãi để không phải tự viết config.
Thông báo khuyến mãi toàn server
- Chat
- Tự động gửi thông báo ngay khi khuyến mãi bắt đầu.
- Nhắc lại định kỳ (mặc định 5 phút/lần).
- Gửi lời cảm ơn khi kết thúc.
- Bossbar (mặc định tắt)
- Hiển thị suốt thời gian khuyến mãi.
- Tự đổi màu xanh, vàng, đỏ khi sắp hết giờ.
- Các dòng chữ luân phiên nhau.
- Chat và bossbar bật tắt độc lập nhau.
- Nội dung, chu kỳ và cách hiển thị đều chỉnh được trong mục
thong-baocủakhuyenmai.yml.- Muốn tắt thông báo nào thì để danh sách trống (
active: []hoặcended: []).
- Muốn tắt thông báo nào thì để danh sách trống (
- Người chơi vào server giữa chừng vẫn thấy bossbar khuyến mãi đang chạy.
Xem chi tiết tại Thông báo khuyến mãi.
Lệnh /khuyenmai
Hoặc /lichkhuyenmai. Người chơi xem danh sách khuyến mãi theo trang, gồm:
- Trạng thái:
●đang diễn ra,○sắp diễn ra. ★đánh dấu khuyến mãi đang thực sự được áp dụng.- Khi nhiều khuyến mãi trùng giờ, khuyến mãi có tỉ lệ cao nhất sẽ được áp dụng.
- Còn bao lâu hết, hoặc bao lâu nữa bắt đầu.
- Ví dụ: "Còn 1 ngày, 5 giờ".
- Nút chuyển trang bấm được (đầu, trước, sau, cuối).
Toàn bộ giao diện, kể cả nút phân trang, tùy chỉnh được trong messages.yml.
Hỗ trợ SePay
- Danh sách ngân hàng được hỗ trợ
- Chỉ cần API token lấy tại my.sepay.vn.
- Riêng VietinBank: Nội dung chuyển khoản tự thêm tiền tố
SEVQR(theo yêu cầu của SePay).- Có cả trong mã QR lẫn hướng dẫn chuyển khoản tay.
Xem hướng dẫn tại Nạp qua chuyển khoản ngân hàng.
Hỗ trợ TheSieuRe
- Thêm TheSieuRe (thesieure.com).
- Cấu hình tại
providers/thesieure.yml:partner-id,partner-key.
- Cấu hình tại
Xem thêm tại Nạp thẻ cào.
Thoát game không còn mất giao dịch
- Trước đây, người chơi thoát game khi đang chờ chuyển khoản thì giao dịch bị hủy. Giờ giao dịch vẫn được giữ cho tới khi hết hạn.
- Khi vào lại server, người chơi nhận được nhắc nhở và có thể dùng:
/bank resume: Lấy lại mã QR và tiếp tục chờ (thời gian đếm ngược được giữ nguyên)./bank cancel: Hủy giao dịch.
- Nếu người chơi đã chuyển khoản xong trong lúc offline, tiền vẫn được ghi nhận. Thông báo nạp thành công được gửi khi họ vào lại.
Phần thưởng không bị mất khi người chơi offline
Các lệnh thưởng được xếp hàng chờ nếu người chơi không online, và tự chạy khi họ vào lại server:
- Lệnh thưởng khi nạp ngân hàng thành công.
- Thưởng nạp lần đầu.
- Thưởng mốc nạp (
mocnap.yml). minimum-donate-commands.
Ngoài ra:
- Không bị chạy trùng, kể cả khi danh sách thưởng có nhiều lệnh giống nhau.
- Với hệ thống nhiều server dùng chung database, lệnh chỉ chạy lại trên đúng server đã ghi nhận giao dịch.
Xem thêm tại Lệnh thưởng khi offline.
Khóa cổng thanh toán (/dotman configdb)
- Khóa cổng thanh toán trên database: Sau khi chạy
/dotman configdb, cổng nạp thẻ và cổng ngân hàng được "chốt" trên database.- Nếu ai đó sửa
providertrong file config, plugin sẽ bỏ qua thay đổi đó. - Muốn đổi cổng hợp lệ, xem hướng dẫn 3 bước ghi ngay trong
config.ymlvàbanking.yml.
- Nếu ai đó sửa
- Cảnh báo đỏ khi chạy
configdbnếu:- Cổng thanh toán bị đổi so với lần khóa trước.
- Thông tin nhận tiền (số tài khoản, tên tài khoản...) bị thay đổi dù vẫn dùng cổng cũ.
- Không còn ghi đè nhầm: Nếu file config đang để giá trị mẫu (
username,api-key...) hoặc đã xóa thông tin nhạy cảm, plugin giữ nguyên dữ liệu thật trên database.- Sau khi
configdbxong, có thể xóa API / mật khẩu trong file cho an toàn.
- Sau khi
Xem thêm tại Bảo mật cấu hình.
Lệnh /dotman testpoint
/dotman testpoint <số tiền>(viết tắt/dotman tp): Tính thử số point người chơi sẽ nhận khi nạp thẻ và khi nạp thủ công, có tính cả khuyến mãi đang áp dụng.- Chỉ để xem, không cộng point thật.
Bug fix
- Sửa lỗi màu trong tên khuyến mãi không hiển thị đúng.
- Không còn báo "khuyến mãi đã kết thúc" khi khuyến mãi chỉ bị một khuyến mãi khác có tỉ lệ cao hơn đè lên.
- Thanh thời gian bossbar hiển thị đúng sau khi dùng
/bank resume. - Giao dịch có mã QR hết hạn trong lúc người chơi offline được dọn dẹp đúng cách.
- Không còn cảnh báo "Ngân hàng đã tắt do lỗi đăng nhập" khi reload trong lúc tính năng ngân hàng đang tắt.
- Server 1.8.x không còn lỗi do bossbar.
- Phiên bản này không hỗ trợ bossbar nên bossbar mốc nạp và bossbar khuyến mãi được tự động tắt.
- Không còn lỗi khi gặp item có material mà XSeries chưa hỗ trợ.
- Sửa lỗi tương thích khi chạy trên Minecraft 1.12.2.
- Khi
extra-untiltrongconfig.ymlsai định dạng, plugin chỉ cảnh báo và coi như khuyến mãi đã hết hạn.- Không còn lỗi khi nạp cấu hình.
- Khi không đọc được cấu hình nạp thẻ trên database, hệ thống nạp thẻ tạm khóa an toàn và báo người chơi chuyển sang nạp ngân hàng.
- Trước đây tình huống này làm plugin lỗi khi khởi động.
- PlaceholderAPI
- Hiển thị đúng version của plugin.
- Không còn bị hỏng khi dùng
/papi reload.
- Discord Webhook: Để trống
usernamevàavatar_urlthì dùng tên và ảnh đã cài sẵn trong Discord, không còn bị lỗi gửi.
Khác
Xử lý khuyến mãi thống nhất
- Nạp thẻ, nạp ngân hàng và nạp thủ công cùng dùng một quy tắc chọn khuyến mãi.
- Khuyến mãi trong
khuyenmai.ymlđược ưu tiên. - Không có thì mới dùng
extra-rate/extra-untiltrongconfig.yml.
- Khuyến mãi trong
- Khuyến mãi
extra-rategiờ cũng có tên hiển thị, đổi tại mụclegacy-nametrongkhuyenmai.yml.
Dễ cấu hình hơn
- Khi file khuyến mãi bị điền sai, plugin bỏ qua đúng mục đó và báo lỗi rõ ràng trên một dòng trong console.
- Các mục khác vẫn hoạt động bình thường.
- Ví dụ: Thiếu thời gian, để trống giá trị, giờ kết thúc trước giờ bắt đầu.
Cấu hình ngân hàng gọn gàng hơn
banking.ymlchỉ còn các cài đặt chung.- Bật/tắt, công thức tính point, lệnh thưởng, bossbar...
- Thông tin riêng của từng cổng thanh toán được tách ra file riêng trong
providers/banking/.mbbank.yml,payos.yml,sepay.yml,payment-service.yml.
- Chọn cổng thanh toán bằng một dòng duy nhất:
provider: MBBANK | PAYOS | SEPAY | PAYMENT-SERVICE.- Plugin chỉ tạo file cấu hình cho cổng đang dùng.
Dùng công cụ Tạo cấu hình ngân hàng để chuyển cấu hình cũ sang cấu trúc mới.
Giao diện chuyển khoản mới
- Khung "Thông tin chuyển khoản" được thiết kế lại, rõ ràng hơn.
- Đổi tên "Nội dung CK", thêm thời hạn giao dịch qua placeholder
%EXPIRY%.
- Đổi tên "Nội dung CK", thêm thời hạn giao dịch qua placeholder
- PayOS có thêm dòng link thanh toán cho người chơi không quét được QR.
Thông báo /dotman configdb
- Kết quả
configdbđược báo rõ từng phần:- Đã lưu.
- Chỉ khóa cổng.
- Chưa lưu (kèm lý do).
- Bỏ qua vì đang tắt.
- Thông báo
configdbđược thiết kế lại.- Có trạng thái
✔/⚠/✘cho từng phần. - Hiển thị giá trị cũ và mới (ẩn API key và mật khẩu), kèm hướng dẫn việc cần làm.
- Có trạng thái
Tên file và file mẫu
- Tên file jar nay có kèm version, ví dụ
DotMan-26.4-premium.jar. - File
discord.ymlmới có sẵn giá trị trống, file cũ giữ nguyên.
Lưu ý khi nâng cấp
- Cần cập nhật MineVNLib lên phiên bản mới nhất.
- Cấu hình
banking.ymlcũ vẫn chạy bình thường.- Plugin chỉ hiện cảnh báo "Đang sử dụng cấu hình banking legacy" trong console.
- Có thể chuyển sang cấu trúc mới khi thuận tiện.
- Sau khi nâng cấp, nên chạy lại
/dotman configdb <mật khẩu>rồi/dotman reloadđể khóa cổng thanh toán trên database. - Muốn dùng thưởng nạp lần đầu, bật
first-donate.enabledtrongconfig.yml.
