UNIVERSAL TRANSLATOR EN ⇄ VI  v2.0.0
Dịch tiếng Anh → tiếng Việt VÀ tiếng Việt → tiếng Anh HOÀN TOÀN OFFLINE cho Minecraft Bedrock (Script API).
Đây là engine dịch dựa trên luật (từ điển hơn 5.000 từ gốc + các dạng chia + ~240 cụm cố định + ~120 từ viết tắt chat, phủ nhiều chủ đề:
đời sống, công việc/kinh doanh, học tập, công nghệ, du lịch, ẩm thực, thể thao, giải trí, cảm xúc/tính
cách, và các mẫu câu giao tiếp trang trọng lẫn thân mật, kèm ngữ pháp cơ bản), KHÔNG phải AI.

=== CHỌN ĐÚNG GÓI ===
1) UVT_EN-VI_v2.0_STABLE.mcpack   — luôn chạy, không cần bật thử nghiệm. Không tự động dịch được
   (Minecraft bản ổn định chưa hỗ trợ can thiệp vào chat), lệnh /translate vẫn đăng ký nhưng chưa
   có gì để bật/tắt.
2) UVT_EN-VI_v2.0_BETA_26.30.mcpack / _26.40 / _26.50 — TỰ ĐỘNG dịch mọi tin nhắn chat, thay hẳn
   dòng tiếng Anh bằng bản dịch tiếng Việt. Không cần làm gì thêm, mặc định đã BẬT sẵn cho mọi người.
   Cần: bật "Beta APIs" trong Cài đặt thế giới → Thử nghiệm, và chọn gói khớp phiên bản game
   (26.30.x → gói 26.30; 26.40.x → gói 26.40; 26.50.x → gói 26.50). Sai phiên bản thì script không nạp được.
   (Lý do: sự kiện chat của Script API hiện vẫn là beta; bản ổn định không có sự kiện này.)
Chỉ bật MỘT gói dịch cho mỗi thế giới.

=== CÀI ĐẶT ===
Mở file .mcpack bằng Minecraft → vào thế giới → Behavior Packs → kích hoạt gói. Xong, không cần
làm gì thêm — với gói BETA, chat tiếng Anh của mọi người sẽ tự động hiện ra bằng tiếng Việt.

=== LỆNH DUY NHẤT: /translate ===
/translate            Xem trạng thái hiện tại của bạn (đang bật/tắt, dịch sang ngôn ngữ nào).
/translate on         Bật dịch cho riêng bạn (mặc định đã bật sẵn).
/translate off         Tắt dịch cho riêng bạn — bạn sẽ thấy nguyên văn tiếng Anh, không ảnh hưởng người khác.
/translate vi          Chọn: dịch chat người khác sang TIẾNG VIỆT cho bạn (đang hoạt động).
/translate en          Chọn: chat TIẾNG VIỆT của người khác được dịch sang TIẾNG ANH cho bạn.
                        (Addon tự nhận biết tin nhắn là tiếng Anh hay tiếng Việt; câu đã cùng ngôn ngữ với
                        lựa chọn của bạn thì giữ nguyên.)
Cài đặt on/off và vi/en là RIÊNG CHO TỪNG NGƯỜI CHƠI — người này bật không ảnh hưởng người khác.
Có thể gõ /tr thay vì /vi:translate nếu server không có lệnh nào khác trùng tên ngắn đó.
Người gửi tin nhắn luôn thấy nguyên văn tin nhắn tiếng Anh của chính mình; bản dịch (chữ màu trắng
bình thường, không tô màu riêng) chỉ hiện ra với NHỮNG NGƯỜI KHÁC đang bật /translate vi.

=== ENGINE DỊCH LÀM ĐƯỢC GÌ ===
- Câu chào hỏi/cụm cố định, viết tắt chat (gg, brb, idk, thx, pls...).
- Câu hỏi có/không, câu hỏi what/where/who/why/how/how many, câu mệnh lệnh, phủ định.
- Thì (đã/đang/sẽ), động từ khuyết thiếu (can/should/must...), so sánh, sở hữu ('s, my, your).
- Đảo trật tự Anh → Việt (tính từ đứng sau danh từ, "iron sword" → "kiếm sắt") và loại từ
  ("3 diamonds" → "3 viên kim cương", "a sword" → "một thanh kiếm").
- Từ vựng phủ nhiều chủ đề: đời sống, công việc, học tập, công nghệ, du lịch, ẩm thực, thể thao,
  giải trí, cảm xúc/tính cách, và câu giao tiếp trang trọng lẫn thân mật.
- Từ không có trong từ điển (tên người, từ lạ) được giữ nguyên. Nếu bản dịch hiểu <60% số từ, hoặc
  tin nhắn đã là tiếng Việt, addon giữ nguyên bản gốc thay vì hiện bản dịch sai.
Chiều Việt → Anh (mới, v2.0): tự suy ra thì, số nhiều, mạo từ (a/the) và thứ tự từ tiếng Anh vì tiếng Việt
không đánh dấu các thứ đó — nên độ chính xác thấp hơn chiều Anh → Việt; hiểu cả tiếng Việt gõ không dấu.
Giới hạn: câu dài/phức tạp, mệnh đề lồng nhau, thành ngữ
hiếm, tiếng lóng ít gặp có thể dịch chưa chuẩn.

=== KHI GẶP LỖI ===
Bật Content Log (Cài đặt → Creator → Content Log GUI) và tìm dòng bắt đầu bằng "[UVT]".
- "chatHook=none"  → gói STABLE (đúng như thiết kế) hoặc chưa bật Beta APIs.
- "chatHook=after" → game chỉ hỗ trợ hiện thêm bản dịch, chưa thay được dòng gốc (một số bản game
  cũ hơn); mọi lệnh /translate vẫn hoạt động bình thường, chỉ khác là không xóa được dòng tiếng Anh.
- "chatHook=before" → mọi tính năng hoạt động đầy đủ, kể cả thay thế dòng gốc.
- Không thấy "[UVT] đã nạp" → script không nạp: sai phiên bản gói BETA, hoặc chưa kích hoạt gói.

=== MỞ RỘNG TỪ ĐIỂN ===
Từ điển nằm trong thư mục scripts/: lexicon.js (từ đã tinh chỉnh, có loại từ) và các file ext*_*.js
(danh sách dạng  từ=nghĩa#loại_từ  ngăn cách bằng dấu |). Thêm từ mới vào file ext phù hợp rồi nén
lại thành .mcpack. Mục trong lexicon.js luôn được ưu tiên hơn các file ext*.
