Tích hợp và placeholder NoxBoosters

Dịch vụ trung tâm dùng trong tài liệu là NoxBoosters 0.1.0, source aeea4cd. Boost chỉ tác động gameplay khi plugin khác đọc và áp giá trị key.

Plugin sử dụng đã đối chiếu

Plugin / commit đã đọc	Key đăng ký	Luồng trả thưởng trong source
NoxHoes 5637a9a	hoes.money	Bonus bán thu hoạch, AutoSell túi đồ và thưởng MONEY.
NoxPickaxes 5a96bf3	pickaxe.money	AutoSell túi đồ và thưởng MONEY.
NoxGens 8386416	gens.sell_price	Bán trong túi, sell wand, bán hàng lưu trong gen, thanh toán khi nhặt/nâng cấp và AutoSell.

NoxGens dùng giá trị của người bán ở luồng thủ công; AutoSell dùng UUID chủ gen. Giá bán đã gồm boost được tính lúc lấy hàng; khoản Vault đang chờ chỉ trả lại số tiền đã lưu, không nhân boost lần nữa. Chủ gen offline chỉ nhận giá trị global/event, không nhận nguồn cá nhân, rank, đảo hoặc pet.

Dependency và economy provider của từng plugin sử dụng cũng phải sẵn sàng. Bảng trên xác nhận luồng trong source tại các commit đã ghi; không chứng nhận mọi bản cài và cấu hình server.

Không consumer nào đã đối chiếu đăng ký hoes.essence_chance. Một dòng trần được comment hoặc mục cấu hình pet có tên này chưa bật xác suất essence. Các key khác, gồm hiệu ứng sản lượng nông trại, cần consumer đăng ký và thực sự áp dụng.

Bonus rank LuckPerms

Đặt meta người dùng hoặc group theo dạng noxboost.<key-đã-đăng-ký>. Ví dụ với group vip có sẵn:

/lp group vip meta set noxboost.hoes.money 0.10

Meta hiệu lực là phần tăng ADD_PERCENT không âm. Ví dụ yêu cầu +10% cho hoes.money; vẫn áp trần nguồn và trần cuối. NoxBoosters đọc meta hiệu lực do LuckPerms cung cấp, không tự cộng mọi mục của các group; người online được refresh khi LuckPerms tính lại dữ liệu người dùng.

Nguồn pet và nguồn tùy chỉnh

NoxPets tại source f693f20 cộng modifier cấu hình của pet đang trang bị, rồi gửi ADD_PERCENT vào nguồn pets. Key chưa đăng ký được log và bỏ qua. Bonus vẫn cần key có consumer và chịu trần phần cộng mặc định 1.0 của nguồn pets.

Lập trình viên lấy BoostService qua Bukkit Services để đăng ký key hoặc đóng góp nguồn riêng. Đăng ký và thay đổi nguồn chạy trên server thread. setSource thay toàn bộ map key của nguồn đó; plugin tạo nguồn chịu trách nhiệm refresh và dọn dữ liệu. Trạng thái nguồn riêng của người chơi bị xóa khi quit. Dùng ID riêng thay cho ID nguồn có sẵn.

PlaceholderAPI

Cài và bật PlaceholderAPI trước khi NoxBoosters khởi động. Identifier của expansion là noxboosters.

Placeholder	Giá trị
%noxboosters_multiplier_hoes.money%	Giá trị key MULTIPLIER đã đăng ký, ví dụ 2.00; không kèm dấu ×.
%noxboosters_global_count%	Số bản ghi booster global đang chạy; không gồm event theo lịch.
%noxboosters_personal_time_farm_money_2x_30m%	Thời gian cá nhân còn lại của người online, tính bằng giây nguyên làm tròn lên; không có hoặc offline thì 0.
%noxboosters_chance_<registered_key>%	Giá trị key CHANCE đã đăng ký dạng tỷ lệ, ví dụ 0.05 là 5%. Thay <registered_key> bằng key thật.

Key lạ hoặc sai kiểu trả null cho PlaceholderAPI xử lý. Menu /boosters hiện chance dạng phần trăm, còn placeholder trả tỷ lệ 0..1. Placeholder thời gian cá nhân đọc dữ liệu phiên online; giá trị 0 khi offline không có nghĩa booster đang tạm dừng đã bị xóa khỏi lưu trữ. Nếu bật thêm consumer trong lúc server chạy, dùng /nbadmin reload để kiểm tra lại tham chiếu cấu hình với key mới.

Phạm vi kiểm chứng

Tài liệu dựa trên source và cấu hình đi kèm ở các commit đã chốt. TESTING.md của NoxBoosters ghi các test và smoke check server đã chạy trước đó, đồng thời liệt kê kiểm tra gameplay, đảo, phục hồi lỗi và tải còn lại trước release. Lần cập nhật wiki này chưa chạy lại server. Cần kiểm tra tiền thực và hành vi trên đúng bộ plugin của bạn trước khi công bố tương thích.