2.2 KiB
大航海特效组件
guard_effect
是与礼物星雨完全独立的组件类型。账户注册或升级时创建一个初始实例，同一账户可以继续添加多个实例；每个实例分别拥有 settings、只读 OBS
token、publicId 和 WebSocket 广播通道。它只订阅 live.guard.buy，不接收普通礼物或连击事件。
从旧版本升级且账户尚无大航海组件时，服务会从最早的礼物特效实例复制主题、字体、星数、时长、性能模式及感谢文案作为初始设置。此后两个组件的设置互不关联。
青玉星落
舰长、提督或总督分别选择 captain.webm、admiral.webm 或 general.webm
全屏播放。视频约 8 秒，首尾各淡入/淡出 0.5 秒；第 4 秒开始在中央横向展开行书卷轴，依次显示可编辑的等级标题、开通或续费用户名，以及可编辑的收尾文字。标题模板可使用
{guard}
插入规范化的“舰长/提督/总督”，默认三行为“{guard}启航”、用户名、“相伴前行”。用户名缺失时才回退显示 UID。
大航海事件进入浏览器内存中的有界 FIFO，当前约八秒的视频或月夜庆祝完整结束后才播放下一项，不会覆盖正在播放的用户。队列按事件到达顺序排列并去重，容量可在控制台设置；达到上限时保留正在播放及已等待的事件，忽略新到达事件。该视觉队列不持久化，OBS 断线重连后只接收新事件。
感谢文字固定使用 Rust 静态服务同域提供的鸿雷行书简体 WOFF2，不读取 OBS 机器的系统字体。该字体随源文件提供的说明不包含开放再分发许可，公开或商业部署前需由部署者确认相应的 Web 嵌入和再分发授权。
静夜曲水
静夜主题使用透明月轮、水纹、身份、观众昵称与星光庆祝。控制台可以调整中文字体、文字亮度、星光数量、全屏持续时间和低性能模式。它不会绘制不透明的全场底色。
OBS 与预览
组件适配任意浏览器源尺寸，控制台提供舰长、提督和总督三个独立预览入口。OBS 地址与礼物星雨完全不同；场景需要两种特效时，应分别添加两个浏览器源。