# StageBox

## English

StageBox is a Minecraft music and stage decoration mod that adds portable speakers, synchronized audio, disco lights, LED screens, and stage equipment to your world.

Create your own concerts, karaoke rooms, clubs, parties, roleplay servers, city decorations, or any entertainment venue with a fully customizable music and lighting system.

## Features

- Portable StageBox Speaker
- Play custom music from local `.ogg` files
- Music GUI with:
  - Play
  - Pause / Stop
  - Previous
  - Next
  - Random
  - Playlist
  - Volume Control
- Animated speaker cones while music is playing
- Improved audio synchronization
- Fixed speaker desynchronization and crackling issues
- LED lighting effects
- Disco Light block with multiple lighting modes
- Disco Ball with rotating light effects
- Programmable LED Screen
- Display any custom text on LED Screens
- Multiple LED display modes and animations
- Power Cable system
- Connect Speakers, LED Lights, Disco Lights, Disco Balls and LED Screens together
- Connected devices synchronize automatically
- Individual GUI for every device with customizable settings
- Crafting recipes included

## Perfect for

- Concert Stages
- Karaoke
- Nightclubs
- Parties
- Roleplay Servers
- Cities
- Entertainment Areas
- Survival
- Creative Mode

---

## How to add music

1. Launch Minecraft once after installing StageBox.

2. Put your `.ogg` music files into:

config/stagebox/music

You can also organize songs into custom folders:

config/stagebox/music/YourPlaylist/song.ogg

3. Open the StageBox GUI and enjoy your music.

Only `.ogg` files are supported.

---

## Notes

- No music is included with the mod.
- Players must add their own `.ogg` files.
- Please only use music you have permission to use.

---

# Tiếng Việt

StageBox là mod hệ thống âm thanh và trang trí sân khấu cho Minecraft, bổ sung loa, đèn LED, đèn vũ trường, quả cầu Disco, màn hình LED và hệ thống dây điện giúp đồng bộ toàn bộ thiết bị.

Bạn có thể xây dựng sân khấu ca nhạc, karaoke, quán bar, nightclub, khu vui chơi, server roleplay hoặc trang trí thành phố với hệ thống âm thanh và ánh sáng chuyên nghiệp.

## Tính năng

- Loa StageBox
- Phát nhạc từ file `.ogg`
- Giao diện nghe nhạc gồm:
  - Phát
  - Dừng
  - Bài trước
  - Bài tiếp theo
  - Phát ngẫu nhiên
  - Playlist
  - Điều chỉnh âm lượng
- Màng loa nhún theo nhạc
- Đồng bộ âm thanh được tối ưu
- Đã khắc phục hiện tượng lệch âm và rè loa
- Đèn LED
- Đèn vũ trường (Disco Light) với nhiều chế độ
- Quả cầu Disco tạo hiệu ứng ánh sáng xoay
- Màn hình LED
- Có thể nhập bất kỳ nội dung văn bản nào lên màn hình LED
- Nhiều hiệu ứng và chế độ hiển thị LED
- Hệ thống dây điện kết nối:
  - Loa
  - Đèn LED
  - Đèn Disco
  - Quả cầu Disco
  - Màn hình LED
- Các thiết bị kết nối sẽ tự động đồng bộ với nhau
- Mỗi thiết bị đều có giao diện tùy chỉnh riêng
- Có đầy đủ công thức chế tạo

## Phù hợp để xây dựng

- Sân khấu ca nhạc
- Karaoke
- Nightclub
- Quán Bar
- Party
- Server Roleplay
- Thành phố
- Survival
- Creative

---

## Cách thêm nhạc

1. Chạy Minecraft một lần sau khi cài mod.

2. Chép file `.ogg` vào:

config/stagebox/music

Bạn cũng có thể tạo playlist riêng:

config/stagebox/music/TenPlaylist/baihat.ogg

3. Mở giao diện StageBox trong game để phát nhạc.

Chỉ hỗ trợ định dạng `.ogg`.

---

## Lưu ý

- Mod không kèm theo nhạc.
- Người chơi tự thêm file `.ogg`.
- Hãy sử dụng các file nhạc mà bạn có quyền sử dụng.

---

# Support / Hỗ trợ

If you need help installing the mod, adding `.ogg` music files, configuring devices, or reporting bugs, feel free to contact me.

Nếu bạn cần hướng dẫn cài đặt mod, thêm file `.ogg`, sử dụng các thiết bị hoặc muốn báo lỗi, hãy liên hệ với mình.

**Email:**  
**[email protected]**

Thank you for supporting StageBox ❤️

StageBox

English

StageBox is a Minecraft music and stage decoration mod that adds portable speakers, synchronized audio, disco lights, LED screens, and stage equipment to your world.

Create your own concerts, karaoke rooms, clubs, parties, roleplay servers, city decorations, or any entertainment venue with a fully customizable music and lighting system.

Features

• Portable StageBox Speaker
• Play custom music from local .ogg files
• Music GUI with:
  • Play
  • Pause / Stop
  • Previous
  • Next
  • Random
  • Playlist
  • Volume Control
  • Animated speaker cones while music is playing
  • Improved audio synchronization
  • Fixed speaker desynchronization and crackling issues
  • LED lighting effects
  • Disco Light block with multiple lighting modes
  • Disco Ball with rotating light effects
  • Programmable LED Screen
  • Display any custom text on LED Screens
  • Multiple LED display modes and animations
  • Power Cable system
  • Connect Speakers, LED Lights, Disco Lights, Disco Balls and LED Screens together
  • Connected devices synchronize automatically
  • Individual GUI for every device with customizable settings
  • Crafting recipes included

Perfect for

• Concert Stages
• Karaoke
• Nightclubs
• Parties
• Roleplay Servers
• Cities
• Entertainment Areas
• Survival
• Creative Mode

How to add music

1. Launch Minecraft once after installing StageBox.

2. Put your .ogg music files into:

config/stagebox/music

You can also organize songs into custom folders:

config/stagebox/music/YourPlaylist/song.ogg

1. Open the StageBox GUI and enjoy your music.

Only .ogg files are supported.

Notes

• No music is included with the mod.
• Players must add their own .ogg files.
• Please only use music you have permission to use.

Tiếng Việt

StageBox là mod hệ thống âm thanh và trang trí sân khấu cho Minecraft, bổ sung loa, đèn LED, đèn vũ trường, quả cầu Disco, màn hình LED và hệ thống dây điện giúp đồng bộ toàn bộ thiết bị.

Bạn có thể xây dựng sân khấu ca nhạc, karaoke, quán bar, nightclub, khu vui chơi, server roleplay hoặc trang trí thành phố với hệ thống âm thanh và ánh sáng chuyên nghiệp.

Tính năng

• Loa StageBox
• Phát nhạc từ file .ogg
• Giao diện nghe nhạc gồm:
  • Phát
  • Dừng
  • Bài trước
  • Bài tiếp theo
  • Phát ngẫu nhiên
  • Playlist
  • Điều chỉnh âm lượng
  • Màng loa nhún theo nhạc
  • Đồng bộ âm thanh được tối ưu
  • Đã khắc phục hiện tượng lệch âm và rè loa
  • Đèn LED
  • Đèn vũ trường (Disco Light) với nhiều chế độ
  • Quả cầu Disco tạo hiệu ứng ánh sáng xoay
  • Màn hình LED
  • Có thể nhập bất kỳ nội dung văn bản nào lên màn hình LED
  • Nhiều hiệu ứng và chế độ hiển thị LED
  • Hệ thống dây điện kết nối:
    • Loa
    • Đèn LED
    • Đèn Disco
    • Quả cầu Disco
    • Màn hình LED
  • Các thiết bị kết nối sẽ tự động đồng bộ với nhau
  • Mỗi thiết bị đều có giao diện tùy chỉnh riêng
  • Có đầy đủ công thức chế tạo

Phù hợp để xây dựng

• Sân khấu ca nhạc
• Karaoke
• Nightclub
• Quán Bar
• Party
• Server Roleplay
• Thành phố
• Survival
• Creative

Cách thêm nhạc

1. Chạy Minecraft một lần sau khi cài mod.

2. Chép file .ogg vào:

config/stagebox/music

Bạn cũng có thể tạo playlist riêng:

config/stagebox/music/TenPlaylist/baihat.ogg

1. Mở giao diện StageBox trong game để phát nhạc.

Chỉ hỗ trợ định dạng .ogg.

Lưu ý

• Mod không kèm theo nhạc.
• Người chơi tự thêm file .ogg.
• Hãy sử dụng các file nhạc mà bạn có quyền sử dụng.

Support / Hỗ trợ

If you need help installing the mod, adding .ogg music files, configuring devices, or reporting bugs, feel free to contact me.

Nếu bạn cần hướng dẫn cài đặt mod, thêm file .ogg, sử dụng các thiết bị hoặc muốn báo lỗi, hãy liên hệ với mình.

Email:
[email protected]

Thank you for supporting StageBox ❤️