🎲 Loto Vietnamese (Vietnamese Bingo)

(Scroll down for Vietnamese description)

Bring the traditional, festive atmosphere of Vietnam to your Minecraft server! Loto Vietnamese is not just a minigame; it's a complete experience with an intuitive GUI, lively sounds, and a flawless automated system. Designed and optimized for Survival/Towny servers, this plugin will be the "magnet" that draws players to interact with each other every day!

✨ Key Features

Intuitive GUI: Each player receives a unique, randomized ticket. Easily check your numbers with a single click (Right-click the ticket).
Smart Automated Calling System: Automatically calls numbers with a customizable interval. Numbers are displayed directly on the screen (Title) and Action Bar to ensure no one misses a number due to chat scrolling.
"Kinh" (Bingo) Mechanic: When a player gets 5 marked numbers in a horizontal row, they can call "KINH" (Bingo). The system will announce the winner, shoot fireworks, and automatically distribute the prize pool.
False Bingo Penalty: Absolute anti-cheat! Anyone who calls "KINH" without having enough matching numbers will be severely penalized (lose resources, sent to jail, or struck by lightning - fully customizable in Config).
Extreme Thrill: The system automatically announces in the chat when players are "waiting for a specific number" (e.g., Bon is waiting for number 25, got 1 row!), pushing the excitement to the max.
Resource Pack Support (CustomModelData): Comes with a custom-designed Resource Pack, turning called and uncalled numbers into sharp, visually appealing items (Supports 1.21.1 up to 1.21.4+).

🛠️ Commands

/loto start <material> <amount> - Open a Loto lobby with a custom entry fee (e.g., 8 DIAMOND).
/loto join - Buy a ticket and join the lobby.
/loto run - Start the game (Host or Admin only).
/loto kinh - Call out your win when you have 5 numbers in a row (Can be clicked directly in the GUI).
/loto recall - View the list of called numbers.
/loto cancel - Cancel the lobby and refund tickets (Admin only).
/loto reload - Reload the config file (Admin only).

⚙️ Permissions

loto.start, loto.join, loto.run, loto.kinh, loto.recall: Default for all players.
loto.admin: Admin permission to cancel games and reload the plugin (Default OP only).

📦 Installation

Download BonLoto.jar and place it in your server's plugins folder.
Restart the server to generate the Config file.
Crucial: Download the attached Resource Pack (in the Files/Versions section) and set it up for your players via server.properties for the best visual experience. (Uses CustomModelData 1001-1090 and 2001-2090).

🇻🇳 TIẾNG VIỆT (VIETNAMESE)

Mang không khí lễ hội truyền thống, rộn ràng của Việt Nam vào máy chủ Minecraft của bạn! Loto Vietnamese không chỉ là một minigame, mà là một trải nghiệm trọn vẹn với giao diện trực quan, âm thanh sống động và hệ thống tự động hóa hoàn hảo.

Được phát triển và tối ưu cho các máy chủ Sinh tồn / Towny, plugin này sẽ là "thỏi nam châm" thu hút người chơi tương tác với nhau mỗi ngày!

✨ Tính Năng Nổi Bật

Giao Diện Trực Quan (GUI): Mỗi người chơi nhận một tờ vé số độc nhất. Dò số dễ dàng chỉ bằng một cú click chuột (chuột phải vào vé).
Hệ Thống Gọi Số Thông Minh: Tự động xướng số với khoảng thời gian tùy chỉnh. Số được đẩy thẳng lên giữa màn hình (Title) và Action Bar để đảm bảo không ai bị lỡ số vì trôi Chat.
Cơ Chế "Kinh" (Bingo): Khi có đủ 5 số trên cùng một hàng ngang, người chơi có thể hô KINH. Hệ thống sẽ vinh danh, bắn pháo hoa và tự động chia thưởng hoành tráng.
Phạt "Kinh Sộ" (False Bingo): Chống gian lận tuyệt đối! Kẻ nào dám hô KINH bừa khi chưa đủ số sẽ bị phạt tài nguyên, tống giam vào tù, hoặc bị sét đánh bay màu (có thể tùy chỉnh trong Config).
Kịch Tính Tột Độ: Hệ thống tự động thông báo lên kênh chat những người chơi đang "chờ số" (ví dụ: Bon đang chờ số 25, được 1 hàng!), đẩy sự hồi hộp của phòng chơi lên mức tối đa.
Hỗ Trợ Resource Pack (CustomModelData): Đi kèm với bộ Resource Pack được thiết kế riêng, biến các số đã gọi và chưa gọi thành hình ảnh trực quan, sắc nét (Chuẩn 1.21.1 đến 1.21.4+).

🛠️ Danh Sách Lệnh

/loto start <vật_phẩm> <số_lượng> - Mở phòng chờ Lô Tô với phí tham gia tùy chọn (Ví dụ: 8 DIAMOND).
/loto join - Mua vé và tham gia phòng chờ.
/loto run - Bắt đầu ván đấu (Chỉ chủ phòng hoặc Admin mới được dùng).
/loto kinh - Hô chiến thắng khi tích đủ 5 số 1 hàng (Có thể click trực tiếp trong vé).
/loto recall - Xem lại danh sách các con số đã được xướng.
/loto cancel - Hủy phòng và hoàn trả tiền vé (Chỉ Admin).
/loto reload - Tải lại file cấu hình (Chỉ Admin).

⚙️ Quyền (Permissions)

loto.start, loto.join, loto.run, loto.kinh, loto.recall: Mặc định dành cho tất cả người chơi.
loto.admin: Quyền quản trị viên để hủy ván và reload plugin (Mặc định chỉ dành cho OP).

📦 Hướng Dẫn Cài Đặt

Tải file BonLoto.jar và cho vào thư mục plugins của server.
Khởi động lại server để tạo file Config.
Vô cùng quan trọng: Tải bộ Resource Pack đính kèm (hoặc ở mục Versions) và cài đặt cho người chơi trong server thông qua server.properties để hình ảnh vé số hiển thị đúng nhất. (Sử dụng CustomModelData từ 1001-1090 và 2001-2090).

Author (Tác giả): BonCT (Bon Chơi Tuốt)
Supported Versions (Phiên bản): Paper/Spigot 1.21.1 -> 1.21.4+

Loto - Vietnamese Bingo