⚠️ Unofficial Maintenance Fork / Disclaimer

English: This project is a fork of the original Geyser Extras by Let's Go Away, which has been discontinued. This version is built directly from the original source code and includes fixes and patches for unresolved bugs and vulnerabilities left in the official release. Huge thanks to Let's Go Away for the amazing original project. If the original author wishes for this to be taken down, please contact me.

Tiếng Việt: Dự án này là một bản fork từ dự án Geyser Extras gốc của Let's Go Away hiện đã ngừng phát triển. Phiên bản này được build trực tiếp từ mã nguồn gốc, tích hợp thêm các bản sửa lỗi và vá lỗ hổng bảo mật còn tồn đọng từ bản phát hành chính thức. Xin gửi lời cảm ơn lớn tới Let's Go Away vì dự án gốc tuyệt vời này. Nếu tác giả gốc có yêu cầu gỡ bỏ, vui lòng liên hệ với tôi.

---

🇬🇧 GeyserExtras (Unofficial Bugfix Fork)

GeyserExtras is a plugin/extension which attempts to unify features for Bedrock Edition players on Java Edition Servers with GeyserMC, as well as providing other handy features for Bedrock Players.

📌 Note: The extension version of GeyserExtras for the `Geyser/extension folder.

✨ Detailed Features

⚔️ Combat Parity

• Attack Cooldown Indicator: Modifies the Attack Cooldown mechanics and UI to visually match Java Edition on the Bedrock screen.
• Java Combat Sounds: Brings authentic Java Edition combat sound effects to Bedrock players during fights.

🔄 Feature Parity

• Emote Chat Synchronization: Automatically sends an in-game chat message whenever a Bedrock player uses an emote, so Java players can see it. (Can be muted via /muteemotechat).
• Java Menus to Bedrock Forms: Ports and converts certain complex Java Edition-only server menus into native, clean Bedrock GUI Forms.
• Display Entities Support: Includes experimental support for Block Display Entities using FMBE.
• Bedrock Capes on Java: Allows Java players to see Bedrock Edition capes. (Requires the PacketEvents plugin installed on the server).

🛠️ Advanced Utilities

• Action Rebinding: Allows players to rebind certain native Bedrock actions to Java actions (e.g., configuring buttons to swap items to the offhand instantly).
• Optional Resource Packs: Allows players to dynamically select and load custom resource packs from the server's GeyserExtras/optionalpacks folder at their own convenience.
• Skin & Asset Saver: Automatically saves and exports player skins, custom geometry, and animation data directly into the GeyserExtras/skins directory.
• Quick Access Menu: Bedrock players can easily open the main features menu by simply double-tapping their Inventory button or typing the /ge command.

---

🇻🇳 GeyserExtras

GeyserExtras là một plugin/extension hỗ trợ đồng bộ hóa các tính năng độc quyền của Java Edition cho người chơi Bedrock Edition trên các Server Java thông qua GeyserMC, đồng thời bổ sung nhiều tiện ích mở rộng hữu ích khác cho game thủ Bedrock.

✨ Chi Tiết Các Tính Năng

⚔️ Cơ Chế Chiến Đấu

• Thanh Hồi Chiêu Java: Thay đổi hiển thị thanh thời gian hồi chiêu (Attack Cooldown) của Bedrock nhìn giống hệt như trên phiên bản Java Edition.
• Âm Thanh Chiến Đấu: Tích hợp và phát các hiệu ứng âm thanh chiến đấu đặc trưng của Java Edition cho người chơi Bedrock.

🔄 Đồng Bộ Hệ Thống (Parity)

• Đồng Bộ Hóa Emote: Gửi thông báo hành động (Emote) của Bedrock vào khung chat chung cho người chơi Java thấy (Có thể tắt bằng lệnh /muteemotechat).
• Giao Diện Menu Bản Địa: Chuyển đổi một số menu hệ thống vốn chỉ có trên Java Edition thành dạng biểu mẫu (Forms) nút bấm trực quan của Bedrock.
• Hỗ Trợ Thực Thể Hiển Thị: Hỗ trợ thử nghiệm tính năng Block Display Entity thông qua FMBE.
• Hiển Thị Áo Choàng: Cho phép người chơi Java nhìn thấy áo choàng của Bedrock Edition (Yêu cầu cài thêm plugin PacketEvents trên server).

🛠️ Tiện Ích Mở Rộng

• Cài Đặt Lại Phím Tắt: Cho phép gán/tùy chỉnh một số hành động Bedrock sang thao tác của Java (Ví dụ: bấm phím để đổi nhanh vật phẩm sang tay phụ - swap offhand).
• Tự Do Chọn Resource Pack: Người chơi có thể tự chọn và tải các gói tài nguyên bổ sung từ thư mục GeyserExtras/optionalpacks của server tùy theo ý muốn.
• Lưu Trữ Skin Tự Động: Hỗ trợ tự động lưu dữ liệu skin, cấu trúc mô hình (geometry) và hoạt ảnh (animation) của người chơi vào thư mục GeyserExtras/skins.
• Menu Truy Cập Nhanh: Mở Menu tính năng cực nhanh bằng cách nhấn đúp vào nút Mở hành trang (Inventory) hoặc gõ lệnh /ge trong khung chat.

---

🐛 Found a Bug? / Bạn tìm thấy lỗi?

If you encounter any bugs, issues, or crashes, please do not contact the original author. Instead, open a ticket on our dedicated issue tracker: 👉 GitHub Issue Tracker / Báo Lỗi Tại Đây

---

📄 License & Credits

• Original Project Repository: GitHub - GeyserExtras
• Original License: MIT License

MIT License

Copyright (c) 2024 LetsGoAway
Modifications Copyright (c) 2026 plpthien3562-a11y

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.