==================================================================
HƯỚNG DẪN SỬ DỤNG PLUGIN BETABV
(Hệ thống Đào Nhanh - VeinMine & Ba Lô - Backpack)
==================================================================
**BetaBV** là một plugin mạnh mẽ, ổn định và hiệu quả, cung cấp các tính năng hữu ích và có khả năng tùy biến cao, phù hợp cho mọi loại máy chủ sinh tồn.
---------------------------------
II. ƯU ĐIỂM NỔI BẬT
---------------------------------
* **An toàn cho vật phẩm:** Ba lô luôn hiển thị đầy đủ nhưng sẽ "khóa" các ô chưa mở khóa, đảm bảo vật phẩm không bị mất khi người chơi tụt cấp.
* **Tiết kiệm thời gian:** Tính năng Đào Nhanh (VeinMine) tự động gom vật phẩm và kinh nghiệm về chân người chơi.
* **Hiệu suất cao:** Plugin được tối ưu hóa để không gây lag, sử dụng cơ chế lưu trữ bất đồng bộ và bộ nhớ đệm (cache) thông minh.
* **Tùy biến mạnh mẽ:** Hầu hết mọi khía cạnh của plugin, từ công thức tính cấp độ, giới hạn, âm thanh, đến tin nhắn, đều có thể được chỉnh sửa trong file `config.yml`.
* **Trải nghiệm mượt mà:** Dữ liệu được tải trước một cách thông minh khi người chơi tham gia server, đảm bảo không có độ trễ khi sử dụng tính năng.
---------------------------------
III. LƯU Ý KHI DÙNG VỚI GEYSERMC (CHO NGƯỜI CHƠI PE/BEDROCK)
---------------------------------
* Để đảm bảo plugin có thể xác định và lưu đúng dữ liệu cho người chơi từ phiên bản PE/Bedrock, bạn **NÊN** cài đặt thêm plugin **[Floodgate]( https://geysermc.org/projects/floodgate)**.
* Floodgate giúp người chơi Bedrock tham gia server Java mà không cần tài khoản Java, và cung cấp một UUID (mã định danh) duy nhất cho mỗi người chơi, giúp các plugin như BetaBV hoạt động chính xác.
---------------------------------
I. LỆNH DÀNH CHO NGƯỜI CHƠI
---------------------------------
1. /b
- Công dụng: Mở ba lô cá nhân của bạn.
- Cách hoạt động:
+ Số dòng trong ba lô bạn có thể sử dụng sẽ tăng lên dựa trên cấp độ (Level) của bạn.
+ Ba lô sẽ luôn hiển thị ở kích thước tối đa, nhưng các ô/dòng bạn chưa mở khóa sẽ bị khóa lại. Bạn không thể đặt vật phẩm vào các ô bị khóa.
+ Tính năng này giúp bảo vệ vật phẩm của bạn không bị mất nếu bạn bị tụt cấp.
2. /v
- Công dụng: Mở giao diện để tùy chỉnh các loại khối bạn muốn sử dụng tính năng Đào Nhanh.
- Cách sử dụng:
+ **Để THÊM một khối:** Mở GUI /v, sau đó click vào khối đó trong túi đồ của bạn ở phía dưới.
+ **Để XÓA một khối:** Click vào khối đó trong giao diện /v ở phía trên.
- Chú ý:
+ Mọi hành động khác như kéo thả, shift-click, bấm phím số... đều bị vô hiệu hóa để đảm bảo an toàn.
+ Chỉ các vật phẩm là "khối" (block) mới có thể được thêm vào.
3. Cách dùng VeinMine:
- Giữ phím `SHIFT` (phím ngồi) và phá một khối đã được cấu hình trong /v.
- Toàn bộ các khối cùng loại liền kề sẽ bị phá vỡ và rơi ra.
- Số lượng khối tối đa bạn có thể phá một lần phụ thuộc vào cấp độ của bạn.
---------------------------------
II. CẤU HÌNH (config.yml)
---------------------------------
File `config.yml` cho phép bạn tùy chỉnh sâu mọi khía cạnh của plugin. Dưới đây là giải thích chi tiết:
**[vein-mine] - Cấu hình Đào Nhanh**
- `enable-level-progression`: `true` để bật giới hạn đào theo cấp độ, `false` để ai cũng đào được tối đa.
- `max-blocks`: Số khối tối đa tuyệt đối có thể đào trong một lần (để chống lag server).
- `base-blocks`: Số khối cơ bản người chơi có thể đào ở cấp 0.
- `level-step`: Cần bao nhiêu cấp độ để được tăng giới hạn đào.
- `blocks-per-step`: Số khối được cộng thêm mỗi khi người chơi đạt mốc `level-step`.
*Ví dụ: `level-step: 5`, `blocks-per-step: 8`. Cứ mỗi 5 cấp, người chơi sẽ đào thêm được 8 khối.
- `cooldown`: Thời gian chờ (tính bằng mili giây) giữa hai lần sử dụng Đào Nhanh. `1000` = 1 giây.
- `default-blocks`: Danh sách các khối được mặc định cho phép Đào Nhanh khi người chơi chưa tự cấu hình.
**[backpack] - Cấu hình Ba Lô**
- `title`: Tiêu đề của ba lô. Có thể dùng `%player%` (tên người chơi) và `%rows%` (số dòng đã mở khóa).
- `enable-level-progression`: `true` để bật mở khóa dòng theo cấp độ, `false` để ai cũng có ba lô tối đa.
- `max-rows`: Số dòng tối đa của ba lô (giới hạn là 6).
- `default-rows`: Số dòng người chơi có sẵn ở cấp 0.
- `level-step`: Cần bao nhiêu cấp độ để mở khóa thêm một dòng mới.
**[messages] - Cấu hình Tin Nhắn**
- Cho phép bạn chỉnh sửa nội dung và màu sắc của tất cả các thông báo mà plugin gửi cho người chơi.
**[sounds] - Cấu hình Âm Thanh**
- Cho phép bạn thay đổi âm thanh khi mở/đóng các giao diện.
- Định dạng: `"TÊN_ÂM_THANH:ÂM_LƯỢNG:CAO_ĐỘ"`.
* `TÊN_ÂM_THANH`: Lấy từ danh sách âm thanh của Minecraft.
* `ÂM_LƯỢNG`: Mặc định là `1.0`.
* `CAO_ĐỘ`: Mặc định là `1.0`.
---------------------------------
IV. HIỆU SUẤT
---------------------------------
Plugin này được thiết kế với hiệu suất cao làm ưu tiên hàng đầu, đảm bảo hoạt động mượt mà ngay cả trên các máy chủ đông người chơi.
* **Lưu trữ bất đồng bộ:** Mọi thao tác lưu dữ liệu (đóng ba lô, thay đổi cấu hình VeinMine) đều được thực hiện trên một luồng riêng. Điều này giúp server không bị "khựng" (lag spike) và luôn phản hồi nhanh.
* **Bộ nhớ đệm thông minh (Caching):** Dữ liệu VeinMine của người chơi được tải vào RAM khi họ tham gia. Mọi thao tác kiểm tra khi đào mỏ đều diễn ra trong RAM, nhanh hơn hàng nghìn lần so với việc đọc file liên tục, giúp giảm tải đáng kể cho đĩa cứng.
* **Thuật toán an toàn:** Thuật toán Đào Nhanh luôn có một giới hạn khối tối đa (`max-blocks`). Điều này đảm bảo an toàn tuyệt đối, ngăn chặn nguy cơ gây quá tải server khi gặp các mạch quặng khổng lồ.
**Kết luận:** Với các kỹ thuật tối ưu trên, bạn có thể yên tâm rằng plugin BetaBV sẽ không phải là nguyên nhân gây lag cho máy chủ của bạn.
Cảm ơn bạn đã sử dụng plugin!
Phát triển bởi Beta Team.