StageFX

StageFX

为您的灯光秀提供可动的摇头灯!

装饰

Minecraft 中可用的摇头聚光灯!

StageFX 为 Minecraft 添加了真正的摇头聚光灯!打造电影级演出、演唱会或剧场布景。它们不只是装饰:这些是完全可控的摇头聚光灯


✨ 包含内容

摇头灯

一种可放置的灯具,可投射出彩色光束。可安装在地板、天花板或墙壁上。可将它对准任意方向。可更改它的颜色、亮度、缩放等。

桁架

一种金属格栅方块,用于搭建高空灯架和安装结构。外观与真实舞台桁架完全一致。

灯光扳手

一种用于在游戏内快速重新配置灯具的工具。 右键单击:更改安装方向 Shift + 右键单击:更改灯体旋转角度 左键单击:通过单击打开游戏内控制 UI


🎛️ 可控制的内容

每个聚光灯都拥有一整套可调节属性:

  • Pan 与 Tilt:将光束对准 3D 空间中的任意位置(水平 360°,垂直 180°)
  • 颜色:任意 RGB 颜色,从深红到冷蓝
  • 亮度:从关闭到全强度的完整调光
  • 光束长度与宽度:从紧凑的窄光斑到宽泛的泛光(长 1–64 个方块)
  • 核心:切换明亮的内部锥体,以获得更真实的光束外观
  • 灯体旋转:以 90° 为增量旋转灯具外壳
  • 平滑移动:为手动移动设置过渡时间(0–200 tick)
  • 玩家追踪:让选定的聚光灯自动跟随任意玩家或实体
  • 目标定位:将光束指向某个特定点

🖥️ 内置 Web 仪表板

服务器:打开浏览器并访问 http://{YOUR_SERVER_IP}:8173(你可能需要转发端口 8173)。输入来自 config/stagefx/dashboard-token.txt 的认证令牌

单人游戏:打开浏览器并访问 http://127.0.0.1:8173。在你的 Minecraft 实例中输入来自 config/stagefx/dashboard-token.txt 的认证令牌(在 Windows 上:Modrinth 为 C:\Users\{username}\AppData\Roaming\ModrinthApp\profiles\{profile},默认 Minecraft 启动器为 C:\Users\{username}\AppData\Roaming\.minecraft)

  • 实时更新:更改会在游戏内和浏览器中即时同步
  • 实时等距舞台地图:在实时 3D 概览中查看所有灯具及其光束
  • 多灯具控制:选择多个灯具并一次性调整它们
  • 18 个预设:快速应用颜色和运动模式(红色、蓝色、圆形、追逐、波浪、漩涡等)
  • 序列与提示编辑器:通过定时提示、淡入淡出和运动动画构建灯光秀
  • 分组:按名称保存并调用灯具选择(在所有玩家和仪表板之间同步)

StageFX Desk (Web Dashboard)


🎮 使用方法

  1. 从“StageFX Spotlights”创造模式标签页中获取物品(聚光灯、桁架、扳手)
  2. 放置聚光灯到你的建筑上,它们会自动附着到你点击的面
  3. 使用命令瞄准(/mh rotate 45 -30)或右键单击以切换光束开/关
  4. 使用扳手更改安装方向或打开游戏内控制面板
  5. 在浏览器中打开灯光控制台以获得完整体验
  6. 构建一场演出,使用序列、提示和预设

⌨️ 命令

通过 /movinghead 命令(或简写 /mh)从聊天中控制一切:

  • /mh select 选择你正在看的灯具(或使用选项 all、nearby <radius> 或 <x> <y> <z>
  • /mh create 在你正在看的位置放置一个聚光灯
  • /mh rotate <pan> <tilt> 瞄准光束
  • /mh color <r> <g> <b> 设置颜色(每个通道 0–255)
  • /mh brightness <0.0-1.0> 设置强度
  • /mh beam <length> <width> 调整光束形状
  • /mh target <x> <y> <z> 自动瞄准任意点
  • /mh track <player> 跟随玩家移动
  • /mh untrack 停止所有追踪
  • /mh group create <name> 保存一组灯具
  • 以及更多...

🔧 工作原理

StageFX 使用自定义渲染管线,将聚光灯的灯臂、灯头和光束绘制为真实的 3D 几何体,而不仅仅是彩色粒子或发光效果。光束是一个光锥,它实际上会在世界中放置光源方块,因此它真正照亮了周围区域。

移动是平滑的:当你设置新的 pan 或 tilt 角度时,灯具会从当前位置平滑过渡到目标位置。玩家追踪每 tick 更新一次,因此光束会实时跟随其目标。

灯光控制台是一个自包含的 Web 应用,直接运行在 Minecraft 服务器内部;无需安装,无外部依赖。只需打开浏览器即可开始设计。


🔧 要求

  • Minecraft 1.21.11
  • Fabric Loader 0.19+
  • Fabric API 0.141.5+1.21.11
  • (可选)Iris + 着色器以获得最佳视觉效果

🚧 计划功能

  • DMX 控制系统
  • 与红石或外部系统集成
  • 更多预设

🎬 适用场景

  • 建造舞台、剧院或电视演播室的建筑玩家
  • 制作电影级镜头的内容创作者
  • 举办活动或演出的服务器
  • 所有喜欢 Minecraft 的灯光爱好者
  • 任何想要在 Minecraft 中实现交互式灯光的人