Tính năng ✨
Đây là tổng quan mọi thứ mà EnhancedEchest mang đến cho máy chủ Minecraft của bạn. Nhảy thẳng tới phần bạn quan tâm:
Rương Ender Lớn Hơn
Tối đa 54 ô, cấu hình theo bội số của chín.
Hệ Thống Nhiều Rương
Sở hữu nhiều rương, mỗi rương quản lý từ menu trong game.
Lưu Bằng Cơ Sở Dữ Liệu
SQLite, MySQL, MariaDB hoặc PostgreSQL; bất đồng bộ và dùng pool.
Không Nhân Đôi Vật Phẩm
Chống nhân đôi theo thiết kế, kể cả khi có người xem chung và quản trị viên.
Chuyển Dữ Liệu
Nhập dữ liệu rương Ender vanilla sẵn có của người chơi.
Đa Nền Tảng
Một file jar cho Paper, Folia và các bản fork Purpur.
📦 Rương Ender Lớn Hơn
EnhancedEchest thay rương Ender vanilla 27 ô bằng một GUI có thể cấu hình lên tới 54 ô.
Cùng Khối, Nhiều Không Gian Hơn
Người chơi mở rương Ender đúng theo cách họ vẫn luôn làm, bằng cách chuột phải vào khối rương Ender, và nhận được kho đồ lớn hơn thay vì màn hình vanilla.
- Mở bằng chuột phải hoặc qua
/ec - Khối rương Ender thật vẫn giữ hiệu ứng đóng/mở nắp
- Kích thước cấu hình theo bội số của 9, từ 9 đến 54
Kích Thước Tùy Chỉnh
Kích thước mặc định cho rương đầu tiên của người chơi được đặt bằng enderchest.default-size trong config.yml. Quản trị viên cũng có thể đổi kích thước từng rương riêng lẻ bằng /ee resize.
- Kích thước hợp lệ:
9,18,27,36,45,54 - Giá trị không hợp lệ được làm tròn về kích thước hợp lệ gần nhất
- Mặc định là
54(một rương đôi đầy đủ)
🗂️ Hệ Thống Nhiều Rương
Người chơi không còn bị giới hạn ở một rương Ender. Mỗi người chơi có thể sở hữu nhiều rương, quản lý qua một menu trong game.
Menu Danh Sách Rương
/eclist để mở một hộp thoại liệt kê mọi rương người chơi sở hữu, mỗi rương hiển thị số ô của nó. Ô tích Chế độ chỉnh sửa thay đổi điều xảy ra khi bấm vào một rương: khi tắt (mặc định), rương mở ngay; khi bật, bấm vào rương sẽ mở menu quản lý của nó, nơi người chơi có thể đổi tên, gán biểu tượng tùy chỉnh, hoặc chọn rương nào là rương chính. Ô tích chuyển trạng thái tại chỗ nên việc bật/tắt không bao giờ mở lại hộp thoại. Rương Chính
/ec và bằng chuột phải vào khối rương Ender. Cho đến khi chọn rương chính, những thao tác đó sẽ mở menu quản lý thay thế. Một rương mới không bao giờ tự động trở thành rương chính; người chơi tự đặt nó từ menu (và luôn có thể vào menu bằng /eclist). Tùy Chỉnh Từng Rương
- Đổi tên — một rương đã đặt tên sẽ hiển thị tên đó làm tiêu đề kho đồ (rương chưa đặt tên dùng Rương Ender hoặc Rương Ender {index})
- Chọn biểu tượng — chọn bất kỳ vật phẩm nào đại diện cho rương trong danh sách, với bộ chọn vật phẩm có tìm kiếm, hoặc đặt lại về biểu tượng rương Ender mặc định
Quản Lý Bởi Quản Trị Viên
/ee add, /ee resize và /ee delete. Xóa rương chính sẽ khiến người chơi không có rương chính cho đến khi họ chọn rương mới từ menu. Rương Cấp Theo Quyền
enhancedechest.additional_amount.<count>.slot.<size> cấp ngần ấy rương với kích thước đó, ví dụ ...2.slot.54 cho hai rương 54 ô. Các node khớp cộng dồn, việc cấp được đồng bộ khi mở, và xóa một node sẽ xóa các rương đó (vật phẩm bên trong được dồn sang một rương tạm có thể khôi phục). Rương cơ bản của người chơi luôn được bảo vệ. Xem trang Quyền. Xem Rương Của Người Chơi Khác
/ee view <player> quản trị viên có thể mở rương của bất kỳ người chơi nào, dù trực tuyến hay ngoại tuyến. Một rương sẽ mở trực tiếp; với nhiều rương, một menu lựa chọn cho phép bạn chọn (hoặc dùng /ee view <player> list để luôn hiển thị nó, hoặc <index> cho một rương cụ thể). Cấp admin.view để xem chỉ-đọc, hoặc thêm admin.edit để lấy và thêm vật phẩm. Quản trị viên tham gia vào cùng một kho đồ trực tiếp mà chủ rương thấy, nên nội dung không bao giờ có thể bị nhân đôi (trên Paper cả hai thậm chí có thể chỉnh sửa cùng lúc). 💾 Lưu Bằng Cơ Sở Dữ Liệu
Nội dung của mọi rương được tuần tự hóa và lưu vào cơ sở dữ liệu, không phải trong các file người chơi phẳng.
Nhiều Backend
- SQLite: tích hợp sẵn, không cần thiết lập, hoàn hảo cho máy chủ đơn lẻ
- MySQL / MariaDB: lưu trữ dùng chung cho các network
- PostgreSQL: cho các thiết lập đã chạy sẵn Postgres
Bất Đồng Bộ & Dùng Pool
Xem trang Cơ sở dữ liệu để biết cách thiết lập kết nối.
🛡️ Không Nhân Đôi Vật Phẩm
EnhancedEchest được xây dựng sao cho nội dung rương Ender không bao giờ có thể bị nhân đôi qua các lỗi reload.
- Nội dung được tải mới từ cơ sở dữ liệu mỗi lần rương được mở
- Nội dung được lưu ngay lập tức khi rương đóng hoặc người chơi thoát
- Một chuỗi chờ lưu (pending-save) đảm bảo lần mở tiếp theo luôn chờ mọi tác vụ lưu đang diễn ra hoàn tất trước khi tải, nên người chơi không bao giờ có thể mở lại và đọc dữ liệu cũ
- Khi hai người cùng xem một rương (ví dụ quản trị viên qua
/ee viewvà chủ rương), họ chia sẻ một kho đồ trực tiếp, nên ngay cả chỉnh sửa đồng thời cũng không thể nhân đôi vật phẩm (chỉnh sửa song song trên Paper; mỗi lần một người xem trên Folia)
🔄 Chuyển Dữ Liệu
Đã có người chơi với dữ liệu rương Ender vanilla? EnhancedEchest có thể nhập nó.
- Khi
migration.enabledlàtrue, rương Ender vanilla của người chơi chưa được chuyển sẽ được nhập tự động khi họ vào - Quản trị viên có thể kích hoạt chuyển dữ liệu thủ công cho một người chơi hoặc tất cả người đang trực tuyến bằng
/ee migrate run - Mỗi người chơi chỉ được chuyển một lần và được đánh dấu là đã xong sau đó
Xem trang Chuyển dữ liệu để biết chi tiết.
🌿 Hỗ Trợ Đa Nền Tảng
EnhancedEchest dùng một bộ lập lịch nhận biết vùng (FoliaLib) bên dưới, nên cùng một file jar chạy được trên:
| Nền tảng | Hỗ trợ |
|---|---|
| Paper | ✅ |
| Folia | ✅ |
| Purpur / các bản fork Paper | ✅ |
Được xây dựng và kiểm thử trên Minecraft 26.1.x với Java 25; các phiên bản Minecraft khác không được hỗ trợ.
Tất cả thư viện bên thứ ba (driver cơ sở dữ liệu, connection pool, bộ lập lịch) đều được shade và relocate vào trong jar, nên không cần tải thêm hay cài driver phía máy chủ.
🪨 Hỗ Trợ Bedrock (Geyser)
Các menu của EnhancedEchest được xây dựng trên Dialog API hiện đại của Paper, và Geyser tự động chuyển các dialog Java thành form Bedrock native. Điều đó nghĩa là người chơi Bedrock vào máy chủ của bạn qua proxy Geyser sẽ thấy menu rương /eclist được hiển thị dưới dạng form Bedrock đúng chuẩn, nút bấm, ô nhập, và tất cả, mà không cần cấu hình thêm từ phía bạn.
- Danh sách rương, hộp thoại đổi tên, và thao tác "Đặt làm rương chính" đều hiện ra dưới dạng giao diện Bedrock
- Không cần cài gì ở phía EnhancedEchest: việc chuyển đổi diễn ra trong Geyser
- Bản thân kho đồ rương là một container thông thường nên hoạt động bình thường trên Bedrock
Geyser đang đảm nhận việc này
Hỗ trợ này đến từ tính năng chuyển đổi form Java-sang-Bedrock có sẵn của Geyser, không phải từ một luồng mã riêng cho Bedrock trong plugin. Hãy giữ bản build Geyser của bạn cập nhật hợp lý để việc chuyển đổi dialog mượt mà nhất.
🔔 Thông Báo Cập Nhật
EnhancedEchest kiểm tra bản phát hành mới khi khởi động và lặng lẽ thông báo cho quản trị viên trong game khi có bản cập nhật, kèm một liên kết tải về bấm được.
🌐 Đa Ngôn Ngữ
Mọi văn bản hiển thị cho người chơi nằm trong các file ngôn ngữ có thể chỉnh sửa. Hãy tạo một bản dịch bằng cách sao chép thư mục en_US, dịch nó, và trỏ language tới locale mới của bạn. Tin nhắn hỗ trợ đầy đủ định dạng MiniMessage. Xem trang Ngôn ngữ.
📊 Thống Kê Sử Dụng
EnhancedEchest gửi dữ liệu sử dụng ẩn danh tới bStats, nên bạn có thể xem có bao nhiêu máy chủ chạy plugin cùng các phân tích như backend lưu trữ và ngôn ngữ. Việc thu thập là ẩn danh và có thể tắt toàn cục trong plugins/bStats/config.yml.
