Cài đặt NoxBoosters

Hướng dẫn áp dụng cho NoxBoosters 0.1.0, source aeea4cd. Plugin biên dịch Java 21 với Paper 1.21.4. Module API biên dịch Java 17 không có nghĩa plugin server chạy được trên Java 17.

Yêu cầu

Thành phần	Yêu cầu
Server	Paper 1.21.4 là mốc biên dịch đã đối chiếu; kiểm tra phiên bản server thực tế trước khi dùng.
Java	Hỗ trợ bytecode Java 21.
Plugin bắt buộc	NoxCore, LuckPerms, SuperiorSkyblock2; cả ba đều là hard dependency.
Lưu trữ	MariaDB truy cập được, tài khoản có quyền tạo và cập nhật bảng của plugin.
Plugin sử dụng boost	Cần để có key hữu ích; ví dụ tích hợp NoxHoes, NoxPickaxes hoặc NoxGens đã đối chiếu.
Plugin tùy chọn	PlaceholderAPI nếu cần placeholder.

plugin.yml khai báo HikariCP và MariaDB JDBC là thư viện được server tải. Server cần truy cập được kho thư viện tương ứng.

Cài và cấu hình

1. Sao lưu dữ liệu plugin và database hiện có trước khi thay bản đã cài.
2. Cài các plugin bắt buộc và đặt NoxBoosters-0.1.0.jar vào plugins/. JAR plugin đã chứa API; JAR API riêng dùng làm dependency cho lập trình viên.
3. Khởi động một lần để tạo plugins/NoxBoosters/. Nếu kết nối database mặc định thất bại, NoxBoosters tự disable; các file cấu hình vẫn được tạo.
4. Dừng server rồi sửa kết nối MariaDB trong plugins/NoxBoosters/config.yml. Ví dụ dưới dùng tài khoản riêng; thay bằng thông tin của bạn:

database:
  host: 127.0.0.1
  port: 3306
  name: noxboosters
  user: noxboosters
  password: 'replace-with-your-password'
  pool-size: 4

5. Khởi động lại. Plugin tự tạo bảng; chờ log Booster storage ready trước khi kích hoạt booster.
6. Dùng quyền admin chạy /nbadmin keys. Chỉ key do plugin đang bật đăng ký mới xuất hiện. Xử lý lỗi Unknown key trước khi dùng ví dụ liên quan.

Đổi thông tin kết nối database cần restart server. /nbadmin reload không tạo lại connection pool.

Thử booster cá nhân đầu tiên

Khi NoxHoes đã bật và đăng ký hoes.money, chạy:

/nbadmin give Steve player farm_money_2x_30m
/nbadmin inspect Steve hoes.money

Steve phải online và có ít nhất một ô túi trống. Cầm vật phẩm ở tay chính, nhấn chuột phải rồi inspect lại. Với cấu hình mặc định và không có modifier khác, hệ số trung tâm là ×2 trong 30 phút thời gian thực. Plugin sử dụng boost quyết định khoản tiền thực tế.

Mở /boosters để kiểm tra, sau đó thử phần thưởng thật từ plugin sử dụng trên server thử. Hệ số hiển thị đúng chưa xác nhận toàn bộ luồng trả thưởng.

Lưu trữ và phục hồi

Booster thời gian thực vẫn hết hạn khi người chơi hoặc server offline. Booster cá nhân ONLINE_TIME tạm dừng khi quit và tắt plugin đúng quy trình; khi online, dữ liệu được checkpoint mỗi 30 giây ở tốc độ tick bình thường. Hard crash có thể hoàn lại phần thời gian kể từ lần lưu thành công gần nhất.

Vật phẩm kích hoạt lỗi hoặc bị từ chối đi vào hàng chờ cục bộ refunds.properties. Plugin thử giao lại khi tải dữ liệu người chơi hoặc mở /boosters; người chơi offline, túi đầy hoặc loại booster không còn hợp lệ có thể khiến vật phẩm tiếp tục chờ. Serial đã dùng bị từ chối và tiêu hủy bản trùng. Sao lưu thư mục dữ liệu plugin cùng database.