# Working moving head spotlights for Minecraft! _StageFX_ adds real moving head spotlights to Minecraft! Create cinematic shows, concerts, or theater sets. Not just decorative: These are **fully controllable moving head spotlights** --- ## ✨ What's included ### Moving Head A placeable light fixture that projects a colored beam. Mount it on floors, ceilings, or walls. Aim it anywhere. Change its **color**, **brightness**, **zoom**, and more. ### Truss A metal lattice block for building overhead rigs and mounting structures. Looks exactly like real stage trussing. ### Lighting Wrench A tool for quickly reconfiguring fixtures in-game. **Right-click**: Change the mount direction **Shift + Right-click**: Change the body rotation **Left-click**: Open the ingame control UI with a click --- ## 🎛️ What You Can Control Every spotlight has a full set of adjustable properties: - **Pan & Tilt**: Aim the beam anywhere in 3D space (360° horizontal, 180° vertical) - **Color**: Any RGB color you want, from deep reds to cool blues - **Brightness**: Full dimming from off to full intensity - **Beam Length & Width**: From a tight narrow spot to a wide flood (1–64 blocks long) - **Core**: Toggle the bright inner cone for a more realistic beam look - **Body Rotation**: Rotate the fixture housing in 90° increments - **Smooth Movement**: Set transition times for manual moves (0–200 ticks) - **Player Tracking**: Make selected spotlights follow any player or entity automatically - **Targeting**: Point the beams to one specific point --- ## 🖥️ Built-In Web Dashboard **Server**: Open your browser and go to `http://{YOUR_SERVER_IP}:8173` (you probably need to forward the port `8173`). Enter the auth token from `config/stagefx/dashboard-token.txt` **Singleplayer**: Open your browser and go to `http://127.0.0.1:8173`. Enter the auth token from `config/stagefx/dashboard-token.txt` in your Minecraft Instance (On Windows: `C:\Users\{username}\AppData\Roaming\ModrinthApp\profiles\{profile}` for Modrinth or `C:\Users\{username}\AppData\Roaming\.minecraft` for default Minecraft Launcher) - **Real-Time Updates**: Changes sync instantly in-game and in the browser - **Live Isometric Stage Map**: See all your fixtures and their beams in a real-time 3D overview - **Multi-Fixture Control**: Select multiple fixtures and adjust them all at once - **18 Presets**: Quick-apply colors and movement patterns (Red, Blue, Circle, Chase, Wave, Vortex, and more) - **Sequence & Cue Editor**: Build lighting shows with timed cues, fades, and movement animations - **Groups**: Save and recall fixture selections by name (synced between all players and dashboards) ![StageFX Desk (Web Dashboard)](https://cdn.modrinth.com/data/cached_images/3f1878bfac881275a3075d4dead7a3bebd5d9a80_0.webp) --- ## 🎮 How to Use 1. **Get the items** from the "StageFX Spotlights" creative tab (spotlight, truss, wrench) 2. **Place spotlights** on your build, they auto-attach to the face you click 3. **Aim with commands** (`/mh rotate 45 -30`) or **right-click** to toggle the beam on/off 4. **Use the wrench** to change the mount direction or open the in-game control panel 5. **Open the lighting desk** in your browser for the full experience 6. **Build a show** with sequences, cues, and presets --- ## ⌨️ Commands Control everything from the chat with the `/movinghead` command (or `/mh` for short): - `/mh select` Select the fixture you look at (or use options `all`, `nearby ` or ` ` - `/mh create` Place a spotlight where you're looking - `/mh rotate ` Aim the beam - `/mh color ` Set the color (0–255 per channel) - `/mh brightness <0.0-1.0>` Set the intensity - `/mh beam ` Shape the beam - `/mh target ` Auto-aim at any point - `/mh track ` Follow a player around - `/mh untrack` Stop all tracking - `/mh group create ` Save a group of fixtures - And many more... --- ## 🔧 How It Works StageFX uses a custom rendering pipeline to draw the spotlight's arm, head, and light beam as real 3D geometry, not just a colored particle or a glow effect. The beam is a cone of light that actually places light blocks in the world, so it genuinely illuminates the area around it. Movement is smooth: when you set a new pan or tilt angle, the fixture transitions smoothly from its current position to the target. Player tracking updates every tick, so the beam follows its target in real-time. The lighting desk is a self-contained web app that runs directly inside the Minecraft server; no installation, no external dependencies. Just open your browser and start designing. --- ## 🔧 Requirements - Minecraft **1.21.11** - **Fabric Loader 0.19+** - **Fabric API 0.141.5+1.21.11** - (Optional) **Iris + shaders** for best visuals --- ## 🚧 Planned Features - DMX control system - Integration with redstone or external systems - More Presets --- ## 🎬 Perfect For - Builders creating **stages, theaters or TV studios** - Content creators making **cinematics** - Servers hosting **events or shows** - All **Lighting Enthusiasts** who like Minecraft - Anyone who wants **interactive lighting in Minecraft**

craftXplorer

Organizations