Spatial Audio System

A BelugaLab audio mod, built on Manta.

English

Spatial Audio System (SAS) plays your own audio files inside the world. Write an mp3 / ogg / wav
from your PC onto a recording medium with the Memory Device, play it back from a Playback Device, and
use the Range Board to define where the sound is audible and how it fades — departure melodies,
in-building announcements, background music. Works in multiplayer, and every screen is rendered
through the BelugaExperience design workflow on top of the Manta UI runtime.

Features

• Play your own audio — mp3 / ogg / wav from your PC, up to 10 MB per file
• 3D range control — the Range Board defines a box where the sound is audible, with per-direction fade-out
• ♪ Schedule — queue up to 6 media and play them in order, each repeating 1–10 times
• Cover art — artwork embedded in the audio file is shown on the device screens
• Redstone automation — the Playback Device fires on a rising edge, for stations, cutscenes, and ambient triggers
• Access modes — the first player to open a device becomes its owner; switch it between public and private
• Multiplayer-safe — audio is stored on the server and streamed to each client, so there is no per-client desync
• Built-in wiki — every screen documented in-game, with hover hints and F1 (EN / JA)
• Public API — addon mods can trigger playback and hook playback completion

Requirements

Network access and bundled native files

Manta (web video, optional) - This mod embeds Manta, BelugaLab's UI library. Manta can play web video in game using the Chromium Embedded Framework (CEF). For that feature only:

• Download: the official CEF runtime for Windows x64 (cef_binary_122.1.13+gde5b724+chromium-122.0.6261.130_windows64, about 310 MB) from cef-builds.spotifycdn.com, the download site the CEF project itself lists.
• When: never at install or game start - only when web video is actually played, or when you run /manta video prewarm.
• Integrity: the archive's SHA-256 is pinned (5da30b576d17517407463be01f1d07a1d1d60cad453e923e204360fa257e007e) and checked before anything is extracted. On a mismatch the file is deleted and nothing is installed.
• Bundled native files: mcss-chrome.dll (Manta's CEF binding) and mcss-chrome-helper.exe (the subprocess entry point Chromium requires), both built by BelugaLab. When the game client starts they are copied to <game folder>/mcss-chrome-native (about 1 MB; skipped if already there). The DLL is loaded at start only if the CEF runtime was installed earlier.
• Processes: while web video is in use, CEF starts mcss-chrome-helper.exe as Chromium's child processes (several can run at once). No other program is started. When the game starts, Manta ends copies of the helper left over from a previous session - only ones started from its own mcss-chrome-native folder.

Open source

SAS is MIT-licensed — published at
github.com/hololocheck/SpatialAudioSystem.
Addon mods should build against the stable belugalab.sas.api package, which can broadcast playback,
read range and medium metadata, and listen for PlaybackEndedEvent. The internal
com.spatialaudiosystem.* package is not an API surface and may be repackaged between versions.

日本語

Spatial Audio System (SAS) は、自分の音声ファイルをワールド内で再生する Mod です。PC 内の
mp3 / ogg / wav を記憶装置で記録媒体に書き込み、再生装置で再生し、範囲指定ボードで「どこまで
聞こえるか・どう減衰するか」を決めます。発車メロディ、館内放送、BGM などに使えます。マルチ
プレイ対応。全画面を Manta UI ランタイム上の BelugaExperience デザインワークフローで描画して
います。

特徴

• 自分の音声を再生 — PC 内の mp3 / ogg / wav を、1 ファイル最大 10 MB まで
• 3D 範囲制御 — 範囲指定ボードで音の聞こえる箱を定義し、方向ごとにフェードアウト
• ♪ スケジュール — 最大 6 件の媒体を並べて順番に再生。各エントリ 1〜10 回
• ジャケット表示 — 音声ファイルに埋め込まれたアートワークをデバイス画面に表示
• レッドストーン自動化 — 立ち上がり信号で再生。駅放送・カットシーン・環境音トリガに
• アクセスモード — 最初に開いたプレイヤーが所有者。公開 / 非公開を切り替え可能
• マルチプレイ安全 — 音声はサーバー側に保存して各クライアントへ配信するため desync なし
• 内蔵 wiki — 全画面をゲーム内で解説。ホバーヒントと F1 対応（英/日）
• 公開 API — addon mod から再生指示・再生完了のフックが可能

必要な環境

ネットワーク通信と同梱ネイティブファイル

Manta（Web 動画・任意機能） — この Mod は BelugaLab の UI ライブラリ Manta を内包しています。Manta は Chromium Embedded Framework（CEF）でゲーム内に Web 動画を表示できます。この機能に限り:

• ダウンロード: Windows x64 用の CEF 公式ランタイム（cef_binary_122.1.13+gde5b724+chromium-122.0.6261.130_windows64、約 310 MB）を、CEF プロジェクト自身が案内している配布元 cef-builds.spotifycdn.com から取得します。
• タイミング: 導入時・起動時には行いません。Web 動画を実際に再生したとき、または /manta video prewarm を実行したときだけです。
• 完全性: アーカイブの SHA-256（5da30b576d17517407463be01f1d07a1d1d60cad453e923e204360fa257e007e）を固定し、展開前に照合します。一致しなければファイルを削除し、何も導入しません。
• 同梱ネイティブファイル: mcss-chrome.dll（Manta の CEF バインディング）と mcss-chrome-helper.exe（Chromium が必要とするサブプロセスの起動口）。どちらも BelugaLab がビルドしたものです。クライアント起動時に <ゲームフォルダ>/mcss-chrome-native へコピーされます（約 1 MB。既にあれば省略）。DLL を起動時に読み込むのは CEF ランタイムが導入済みの場合だけです。
• プロセス: Web 動画を使っている間だけ、CEF が mcss-chrome-helper.exe を Chromium の子プロセスとして起動します（同時に複数動くことがあります）。それ以外のプログラムは起動しません。ゲーム起動時には、前回のセッションで残った helper のうち、mcss-chrome-native フォルダから起動されたものだけを終了します。

オープンソース

SAS は MIT ライセンスで
github.com/hololocheck/SpatialAudioSystem
に公開しています。addon mod は安定 API の belugalab.sas.api パッケージを参照してください
（再生指示、範囲・媒体メタデータの取得、PlaybackEndedEvent の購読が可能）。内部パッケージ
com.spatialaudiosystem.* は API 表面ではなく、バージョン間でリパッケージされる可能性があります。