StageBox

English

StageBox is a Minecraft music, lighting, and stage equipment mod that lets you build fully functional concerts, karaoke rooms, nightclubs, festivals, parties, roleplay venues, entertainment areas, and custom stages.

Play your own .ogg music, create playlists, synchronize multiple speakers, connect stage equipment together, control lighting effects, display custom text on LED screens, create animated Pixel Light installations, add smoke and spark effects, track players with moving spotlights, and control your entire setup from an animated DJ Controller.

StageBox combines music, lighting, visual effects, and stage equipment into one connected and customizable system for both Survival and Creative builds.

---

Features

StageBox Speaker

The StageBox Speaker is the main music system of the mod.

Features:

• Play custom .ogg music files
• Create playlists using folders
• Play
• Pause
• Resume
• Stop
• Previous Track
• Next Track
• Shuffle
• Volume Control
• Playback Progress
• Automatic Next Track
• Animated speaker cones while music is playing
• Multiple connected speakers can stay synchronized
• Optimized audio and network synchronization

Music is loaded from:

config/stagebox/music

Each subfolder inside the music directory becomes a separate playlist.

Example:

config/stagebox/music/MyPlaylist/song.ogg

---

DJ Controller

The DJ Controller lets you control your StageBox music and connected stage equipment from a fully animated DJ booth.

Music controls include:

• Playlist browser
• Song list
• Song search
• Play
• Pause
• Resume
• Stop
• Previous Track
• Next Track
• Shuffle
• Volume
• Playback Progress
• Current Song Display

The DJ Controller also includes a Device tab for controlling connected StageBox equipment.

DJ Controllers and StageBox Speakers connected to the same network share the same playback session, so they can control the same music without creating separate audio systems.

The DJ model includes animated:

• Left and right turntables
• Front EQ bars
• Top EQ bars
• Power-on animation
• Active loop animation
• Power-off animation

Available DJ Controller colors:

• Original
• Blue
• Cyan
• Green
• Orange
• Pink
• Purple
• Red
• White
• Yellow

---

Stage Lights

StageBox includes customizable stage lighting that can be connected to the music system.

You can adjust:

• Color
• Speed
• Brightness
• Beam Size
• Range
• Power
• Synchronization
• Lighting Mode

Laser Modes

• Sweep
• Pulse
• Fan

Moving / Disco Light Modes

• Rotate
• Sparkle
• Orbit

Stage Lights can operate manually or synchronize with StageBox playback.

---

Disco Ball

Add a classic Disco Ball to your stage or entertainment area.

Features include:

• Rotating light effects
• Customizable settings
• StageBox synchronization
• Integration with the connected stage network

---

LED Screen

Build programmable LED screens using connected LED Screen blocks.

LED Screens support:

• Custom text
• Custom colors
• Multiple display modes
• Adjustable animation speed
• Adjustable brightness
• Adjustable text size
• StageBox synchronization

Connected LED blocks automatically work together as one screen.

Large LED displays are optimized so they can be controlled as one logical display instead of treating every LED block as a separate device.

---

Pixel Light

Pixel Lights can be placed next to each other to create large animated light strips and installations.

Connected Pixel Lights automatically form one logical device.

Pixel Light includes 16 animation modes:

• Solid
• Chase
• Comet
• Rainbow
• Rainbow Chase
• Pulse
• Alternate
• Wipe
• Bounce
• Color Cycle
• Scanner
• Twinkle
• Fill
• Wave
• Random Chase
• Strobe

Additional settings include:

• Multiple colors
• Rainbow color mode
• Speed up to 1000%
• Tail Length up to 200
• StageBox synchronization

The Pixel Light renderer is optimized for large installations.

---

Tracking Spotlight

The Tracking Spotlight can automatically follow players around your stage.

Tracking modes:

• Fixed
• Nearest Player
• Selected Player

Features include:

• Smooth horizontal movement
• Smooth vertical movement
• Automatic player tracking
• Adjustable tracking range
• Adjustable brightness
• Adjustable beam size
• Surface illumination
• Player illumination

The spotlight continuously follows the current position of the selected or nearest player.

It is useful for concerts, roleplay events, performances, shows, and moving stage effects.

---

Smoke Machine

Add atmospheric smoke effects to your stage with the Smoke Machine.

Available modes:

• Continuous
• Pulse
• Burst
• Intermittent
• Wave
• Ramp
• Rolling
• Haze
• Random
• Swell

Adjustable settings:

• Density
• Output Speed
• Spread
• Rise
• Lifetime
• Frequency

Smoke effects are client-side and optimized to support larger stage setups.

---

Spark Fountain

Create cold-spark style stage effects with the Spark Fountain.

The effect is visual only and does not cause fire or damage.

Available modes:

• Fountain
• Burst
• Pulse
• Double
• Triple
• Wave
• Buildup
• Rapid
• Twinkle
• Random

Available colors:

• Gold
• White
• Orange
• Red
• Green
• Blue
• Cyan
• Magenta
• Rainbow

Adjustable settings:

• Height
• Width
• Density
• Intensity
• Duration
• Frequency
• Sparkle

---

Cable System

StageBox includes a cable system for connecting speakers and stage equipment together.

Cables are available in multiple colors and can connect devices such as:

• StageBox Speakers
• Stage Lights
• Disco Lights
• Disco Balls
• LED Screens
• Pixel Lights
• Tracking Spotlights
• Smoke Machines
• Spark Fountains
• DJ Controllers

Connected devices automatically become part of the StageBox network.

The network is optimized so connecting or removing stage equipment does not restart the currently playing song when the speaker network itself has not changed.

---

Music Synchronization

StageBox is designed to keep connected speakers and devices synchronized.

The playback system supports:

• Multiple connected Speakers
• Shared playback state
• Play / Pause / Resume / Stop
• Automatic Next Track
• Playlist synchronization
• DJ Controller integration
• Device hot-connect
• Network merge and split handling

Stage equipment can be added or removed while music is playing without unnecessarily restarting the current track.

---

Parrot Dance

Vanilla Minecraft parrots can dance when they are near a StageBox Speaker that is currently playing music.

Bring a parrot near your stage and let it join the party. 🦜🎵

---

Perfect For

StageBox is useful for building:

• Concert Stages
• Karaoke Rooms
• Nightclubs
• Bars
• Parties
• Festivals
• Music Events
• Roleplay Servers
• Cities
• Entertainment Areas
• Dance Floors
• Survival Builds
• Creative Builds

---

How to Add Music

1. Install StageBox and launch Minecraft once.

2. Put your .ogg music files into:

config/stagebox/music

You can also create folders to organize your music into playlists.

Example:

config/stagebox/music/MyPlaylist/song.ogg

Each folder becomes a separate playlist inside StageBox.

1. Open a StageBox Speaker or DJ Controller and select your music.

Only .ogg audio files are supported.

---

Notes

• StageBox does not include any music.
• Players must provide their own .ogg files.
• Music files are loaded from the Minecraft configuration folder.
• Please only use music that you have permission to use.

---

Tiếng Việt

StageBox là mod âm thanh, ánh sáng và thiết bị sân khấu dành cho Minecraft, cho phép bạn xây dựng sân khấu ca nhạc, phòng karaoke, nightclub, quán bar, lễ hội, party, khu vui chơi, server roleplay và nhiều công trình giải trí khác.

Bạn có thể phát nhạc .ogg của riêng mình, tạo Playlist, đồng bộ nhiều Loa StageBox, kết nối các thiết bị sân khấu, điều khiển ánh sáng, hiển thị nội dung trên Màn hình LED, tạo hệ thống Đèn Pixel, sử dụng Đèn Bám Người, Máy Khói, Máy Phun Tia Lửa và điều khiển toàn bộ hệ thống bằng Bàn DJ có animation.

StageBox kết hợp âm nhạc, ánh sáng, hiệu ứng và thiết bị sân khấu thành một hệ thống hoàn chỉnh có thể sử dụng trong cả Survival và Creative.

---

Tính năng

Loa StageBox

Loa StageBox là hệ thống phát nhạc chính của mod.

Có các chức năng:

• Phát nhạc .ogg tùy chỉnh
• Tạo Playlist bằng thư mục
• Phát
• Tạm dừng
• Tiếp tục
• Dừng
• Bài trước
• Bài tiếp theo
• Phát ngẫu nhiên
• Điều chỉnh âm lượng
• Hiển thị tiến trình bài hát
• Tự động chuyển sang bài tiếp theo
• Màng loa chuyển động khi đang phát nhạc
• Nhiều loa kết nối với nhau có thể đồng bộ
• Hệ thống âm thanh và mạng được tối ưu

Nhạc được đọc từ:

config/stagebox/music

Mỗi thư mục con trong thư mục music sẽ trở thành một Playlist riêng.

Ví dụ:

config/stagebox/music/NhacCuaToi/baihat.ogg

---

Bàn DJ

Bàn DJ cho phép điều khiển nhạc và các thiết bị sân khấu StageBox từ một bàn điều khiển có animation.

Các chức năng điều khiển nhạc:

• Danh sách Playlist
• Danh sách bài hát
• Tìm kiếm bài hát
• Phát
• Tạm dừng
• Tiếp tục
• Dừng
• Bài trước
• Bài tiếp theo
• Phát ngẫu nhiên
• Điều chỉnh âm lượng
• Thanh tiến trình
• Hiển thị bài hát hiện tại

Bàn DJ còn có tab Thiết bị để điều khiển các thiết bị StageBox đang được kết nối.

Bàn DJ và Loa StageBox trong cùng một network sử dụng chung một phiên phát nhạc, vì vậy nhiều Bàn DJ và nhiều loa có thể cùng điều khiển hệ thống.

Model Bàn DJ có animation:

• Hai đĩa DJ quay
• EQ phía trước
• EQ phía trên
• Animation bật nguồn
• Animation khi hoạt động
• Animation tắt

Có 10 phiên bản màu:

• Gốc
• Xanh dương
• Lục lam
• Xanh lá
• Cam
• Hồng
• Tím
• Đỏ
• Trắng
• Vàng

---

Đèn Sân Khấu

StageBox có hệ thống ánh sáng sân khấu có thể kết nối và đồng bộ với hệ thống phát nhạc.

Có thể điều chỉnh:

• Màu
• Tốc độ
• Độ sáng
• Kích thước tia
• Khoảng cách
• Bật / Tắt
• Đồng bộ
• Chế độ hiệu ứng

Chế độ Laser

• Quét
• Nhịp
• Xòe

Chế độ Cầu Xoay

• Xoay
• Lấp lánh
• Quỹ đạo

Đèn có thể hoạt động thủ công hoặc đồng bộ theo trạng thái phát nhạc của StageBox.

---

Quả Cầu Disco

Trang trí sân khấu hoặc khu vui chơi bằng Quả Cầu Disco.

Có:

• Hiệu ứng ánh sáng xoay
• Các tùy chỉnh hiệu ứng
• Đồng bộ với StageBox
• Hoạt động cùng hệ thống thiết bị được kết nối

---

Màn hình LED

Bạn có thể ghép nhiều block Màn hình LED lại với nhau để tạo thành một màn hình lớn.

Màn hình LED hỗ trợ:

• Hiển thị nội dung văn bản tùy chỉnh
• Thay đổi màu
• Nhiều chế độ hiển thị
• Điều chỉnh tốc độ
• Điều chỉnh độ sáng
• Điều chỉnh kích thước chữ
• Đồng bộ với StageBox

Các block LED được kết nối sẽ tự động hoạt động cùng nhau như một màn hình.

Hệ thống được tối ưu để những màn hình LED rất lớn được điều khiển như một thiết bị duy nhất thay vì hàng nghìn thiết bị riêng biệt.

---

Đèn Pixel

Các Đèn Pixel đặt sát nhau sẽ tự động kết nối để tạo thành những dãy đèn và hệ thống ánh sáng lớn.

Toàn bộ dãy Pixel được xem như một thiết bị duy nhất.

Có 16 chế độ hiệu ứng:

• Solid
• Chase
• Comet
• Rainbow
• Rainbow Chase
• Pulse
• Alternate
• Wipe
• Bounce
• Color Cycle
• Scanner
• Twinkle
• Fill
• Wave
• Random Chase
• Strobe

Có thể điều chỉnh:

• Màu
• Chế độ Rainbow
• Tốc độ tối đa 1000%
• Độ dài đuôi tối đa 200
• Đồng bộ StageBox

Renderer của Đèn Pixel được tối ưu để hỗ trợ số lượng đèn lớn.

---

Đèn Bám Người

Đèn Bám Người có khả năng tự động theo dõi người chơi trên sân khấu.

Có 3 chế độ:

• Cố định
• Người chơi gần nhất
• Người chơi được chọn

Các tùy chỉnh gồm:

• Góc ngang
• Góc dọc
• Khoảng cách theo dõi
• Độ sáng
• Kích thước tia

Đầu đèn và tia sáng có thể di chuyển mượt theo vị trí hiện tại của người chơi.

Phù hợp cho sân khấu ca nhạc, biểu diễn, sự kiện và server roleplay.

---

Máy Khói

Máy Khói tạo hiệu ứng khói giúp sân khấu có không khí sống động hơn.

Có 10 chế độ:

• Continuous
• Pulse
• Burst
• Intermittent
• Wave
• Ramp
• Rolling
• Haze
• Random
• Swell

Có thể điều chỉnh:

• Mật độ
• Tốc độ phun
• Độ lan
• Độ bay lên
• Thời gian tồn tại
• Tần suất

Hiệu ứng khói được xử lý phía client và được tối ưu cho các hệ thống sân khấu lớn.

---

Máy Phun Tia Lửa

Máy Phun Tia Lửa tạo hiệu ứng cold spark dành cho sân khấu.

Hiệu ứng chỉ mang tính hình ảnh và không gây cháy hoặc sát thương.

Có 10 chế độ:

• Fountain
• Burst
• Pulse
• Double
• Triple
• Wave
• Buildup
• Rapid
• Twinkle
• Random

Các màu:

• Vàng kim
• Trắng
• Cam
• Đỏ
• Xanh lá
• Xanh dương
• Lục lam
• Hồng tím
• Cầu vồng

Có thể điều chỉnh:

• Chiều cao
• Độ rộng
• Mật độ
• Cường độ
• Thời gian
• Tần suất
• Độ lấp lánh

---

Hệ thống dây kết nối

StageBox có hệ thống dây để kết nối các thiết bị với nhau.

Có thể kết nối:

• Loa StageBox
• Đèn Sân Khấu
• Đèn Disco
• Quả Cầu Disco
• Màn hình LED
• Đèn Pixel
• Đèn Bám Người
• Máy Khói
• Máy Phun Tia Lửa
• Bàn DJ

Các thiết bị được kết nối sẽ trở thành một phần của hệ thống StageBox và có thể đồng bộ với nhau.

Hệ thống mạng được tối ưu để việc thêm hoặc tháo thiết bị sân khấu không làm bài hát đang phát bị khởi động lại nếu mạng loa không thực sự thay đổi.

---

Đồng bộ âm nhạc

StageBox được thiết kế để nhiều loa và thiết bị có thể hoạt động cùng nhau.

Hệ thống hỗ trợ:

• Nhiều Loa StageBox kết nối
• Trạng thái phát nhạc dùng chung
• Phát / Tạm dừng / Tiếp tục / Dừng
• Tự động chuyển bài
• Đồng bộ Playlist
• Điều khiển bằng Bàn DJ
• Kết nối thiết bị khi nhạc đang phát
• Xử lý khi network được gộp hoặc tách

Bạn có thể thêm hoặc tháo thiết bị sân khấu trong khi nhạc đang phát mà không làm bài hát bị reset một cách không cần thiết.

---

Vẹt nhảy theo nhạc

Vẹt Vanilla Minecraft ở gần Loa StageBox đang phát nhạc có thể nhảy giống như khi nghe Jukebox. 🦜🎵

Bạn có thể đặt vài chú vẹt gần sân khấu để buổi biểu diễn trông sống động hơn.

---

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

StageBox phù hợp cho:

• Sân khấu ca nhạc
• Karaoke
• Nightclub
• Quán Bar
• Party
• Festival
• Sự kiện âm nhạc
• Server Roleplay
• Thành phố
• Khu vui chơi
• Sàn nhảy
• Survival
• Creative

---

Cách thêm nhạc

1. Cài StageBox và chạy Minecraft một lần.

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

config/stagebox/music

Bạn có thể tạo thêm thư mục để chia nhạc thành các Playlist.

Ví dụ:

config/stagebox/music/NhacCuaToi/baihat.ogg

Mỗi thư mục sẽ trở thành một Playlist riêng trong StageBox.

1. Mở Loa StageBox hoặc Bàn DJ và chọn bài hát muốn phát.

StageBox chỉ hỗ trợ file âm thanh .ogg.

---

Lưu ý

• StageBox không kèm theo nhạc.
• Người chơi tự thêm các file .ogg của mình.
• File nhạc được đọc từ thư mục cấu hình Minecraft.
• Hãy chỉ sử dụng những file nhạc mà bạn có quyền sử dụng.

---

Support / Hỗ trợ

If you need help installing StageBox, 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 StageBox, 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:
hotrottpingdev@gmail.com

Thank you for supporting StageBox ❤️