ВЕРСИИ (7)

## English ### Major Changes - **Sound Handy (new item)** — a remote for your own Playback Devices. Right-click a device to target it; right-click elsewhere for the handy screen (a small panel in the bottom-right: the list of your devices, and a device page opened by clicking a row). Shift + wheel walks through the devices, the middle button plays / stops the target, **Shift + R** shows and edits the target's range board from where you stand, **Shift + H** outlines the target through blocks. A mini HUD in the bottom-left names the target, the medium it holds (an icon coloured by format, and the file name), its state, its range and whether the highlight is on; the rows slide when the target changes. Test playback from the handy is heard by you alone, where you stand. - **Redstone output** — the red redstone button on the device screen opens up to sixteen rules tying redstone to playback: "While playing" outputs for as long as the device plays, "On start / On stop / On end" pulse after a delay. Power, delay and pulse length are set by wheel; a rule can be narrowed to one schedule entry. Rising-edge input starts playback as before. - **Manta 2.5.0 is bundled (jar-in-jar)** — required range `[2.5.0,3)`. Update the other BelugaLab mods (TSU 1.1.0 / ASC 1.2.0) at the same time; a build that embeds Manta 1.x requires `[1.1.74,2)`, and one Manta cannot satisfy both ranges. Since 2.2.0 Manta draws UI text with its own raster at the on-screen pixel size, and 2.5.0 draws tooltips, HUDs and wiki pages the same way. On Windows the text uses the system's own fonts (Yu Gothic, Microsoft YaHei, Segoe UI and others; nothing is redistributed); `/manta font off` returns to the previous font. ### Added - **Every sound reaches a player who arrives late, from the sound's current position.** One-shots are now delivered on joining, on arriving from another dimension, and on walking into range, just like ∞ sounds. - **∞ button for normal playback** (right of play / stop): the medium in the single slot repeats until stopped. - **Sixteen schedule entries** (six before), with a scrolling list. Each row's × became a **stop** button; deleting an entry moved to the **trash can** right of its media slot. - **Playback range preset** — without a range board, hover the "Playback range" row on the device screen and scroll to set 1–64 blocks (a new device starts at 64, the jukebox's range). - **Device names** — name a Playback Device from its screen or from the handy; the name is kept in the device and shown in the handy's list and mini HUD. - The schedule ON/OFF toggle moved into the schedule screen's button row; turning the schedule on hands the medium left in the single-play slot back to your inventory. - **Wiki** — a Sound Handy page (English and Japanese; six pages in all). ### Fixed - The single slot's ∞ playback stopped after 10 minutes (it reached the runaway safety timeout). - A redstone pulse into an empty slot silently disarmed a running schedule's ∞ entry. - Removing the medium during ∞ playback left the sound running. - The range board tooltip and the upload failure messages were English-only. - A late arrival heard the sound about 7 seconds behind the players present from the start. ### Internal - Network version 1.5. **Older clients are refused at login** — update the client and the server together. --- ## 日本語 ### 重要な変更 - **サウンドハンディ (新アイテム)** — 自分の再生装置のリモコンです。装置を右クリックで対象に、それ以外を右クリックでハンディ画面 (右下の小さなパネル: 装置の一覧と、行をクリックで開く装置ページ)。Shift + ホイールで対象を順に切替、中ボタンで対象を再生 / 停止、**Shift + R** でその場から対象の範囲指定ボードを表示・編集、**Shift + H** で対象の枠をブロック越しに表示。左下のミニ HUD が対象の名前・入っている記録媒体 (形式ごとの色のアイコンとファイル名)・状態・範囲・ハイライトの ON/OFF を出し、対象を切り替えると行がスライドします。ハンディからのテスト再生は自分にだけ、今いる場所で鳴ります。 - **レッドストーン出力** — 装置画面の赤いレッドストーンボタンから、再生に連動した出力を最大 16 本のルールで設定できます。「再生中」は再生している間だけ出力、「開始時 / 停止時 / 終了時」は事象からの遅延後にパルスを出します。強度・遅延・パルス長はホイールで設定、ルールはスケジュールの特定のエントリに絞れます。立ち上がり入力での再生開始は従来どおりです。 - **Manta 2.5.0 を内包 (jar-in-jar)** — 要求範囲 `[2.5.0,3)`。他の BelugaLab mod (TSU 1.1.0 / ASC 1.2.0) も同時に更新してください。Manta 1.x を内包するビルドは `[1.1.74,2)` を要求し、両方の必須範囲を 1 つの Manta で満たすことはできません。Manta 2.2.0 から UI の文字を Manta 自身のラスタライザで画面の実ピクセルサイズで描き、2.5.0 でツールチップ・HUD・wiki の文字も同じ描画になりました。Windows では OS のフォント (游ゴシック / Microsoft YaHei / Segoe UI など、再配布はしません) を使います。`/manta font off` で従来のフォントに戻せます。 ### 追加 - **途中参加でも、どの音も「途中から」聞こえるようになりました。** 1 回再生の音も、サーバー参加・別ディメンションからの移動・範囲内への進入のいずれでも、∞ の音と同じように配信されます。 - **通常再生の ∞ ボタン** (再生・停止の右)。単体スロットの媒体を止めるまで繰り返します。 - **スケジュールは 16 エントリまで** (旧 6)、スクロールする一覧。各行の × は**停止**ボタンになり、エントリの削除は記録媒体スロット右の**ゴミ箱**に移りました。 - **再生範囲プリセット** — 範囲指定ボードを入れないときの再生範囲を、装置画面の「再生範囲」行にホバーしてホイールで 1〜64 ブロックに設定できます (新しく置いた装置はジュークボックスと同じ 64)。 - **装置の名前** — 再生装置の画面またはハンディから名前を付けられます。装置に保存され、ハンディの一覧とミニ HUD に出ます。 - スケジュールの ON/OFF トグルはスケジュール画面のボタン行に移り、スケジュールを ON にすると通常スロットに残っていた記録媒体はインベントリへ戻ります。 - **wiki** — サウンドハンディのページを追加 (英 / 日、全 6 ページ)。 ### 修正 - 単体スロットの ∞ 再生が 10 分で止まっていた問題 (安全網タイムアウトに到達していた)。 - 空スロットへのレッドストーンパルスが、走行中のスケジュールの ∞ エントリを黙って解除していた問題。 - ∞ 再生中に媒体を抜いても鳴り続けていた問題。 - 範囲ボードのツールチップとアップロード失敗メッセージが英語固定だった問題。 - 途中参加者が、開始からいる人より 7 秒ほど遅れて聞こえていた問題。 ### 内部 - ネットワーク版 1.5。**旧 client は接続時に拒否されます** — client と server を同時に更新してください。

## English ### Major Changes - **Every screen rebuilt on Manta UI** — the Playback Device and Memory Device screens are now rendered through the BelugaExperience design workflow on the Manta UI runtime. - **Manta is bundled in the jar (jar-in-jar)** — Manta 1.1.12 ships embedded and is declared a required dependency. You do not need to install Manta separately. ### Added - **♪ Schedule (playlist)** — play several recording media in order from a Playback Device. Up to 6 entries, each repeating 1–10 times. Drag a medium onto a row, or shift-click to drop it into the first free row. Reorder with ▲ / ▼, preview a row with ▶, remove with ✕. **▶ Play All** runs the sequence, and the row currently sounding is outlined. - **In-game wiki** — the 📖 button opens the page for the screen you are on. With hints on, hover an element and press **F1** to jump to that feature's page. Five pages, in English and Japanese. - **Hint mode** — a toggle in the top-right of each screen; hovering an element shows its description in the lower left. - **Cover art** — artwork embedded in an audio file is shown on the device screens. JPEG jackets decode through Manta's image decoder. - **Access mode (public / private)** — the first player to open a device becomes its owner. The face icon switches between public (green) and private (red). - **Range Board HUD** — holding the board shows a HUD at the bottom of the screen. **Alt + wheel** cycles the mode; **Ctrl or Shift + wheel** adjusts the current mode's value. - **Recording error feedback** — write failures on the Memory Device are now surfaced on screen. ### Bug Fixes - **Fixed world assets from 1.0.3 or earlier not being recognized.** The 1.0.4 rename changed only the namespace, so blocks, items, block entities, menus, and the data components carrying the audio id all still named a mod that no longer existed. Registry aliases now map the legacy id onto the current one, and audio storage falls back to the old directory. **Recording media, playback devices, and range boards from 1.0.3 or earlier work as-is** — the 1.0.4 note about needing a fresh world no longer applies. ### Improvements - Added a playback session registry and scheduler, centralising playback start / stop / completion notification. - Added playback timeout handling. - Hardened input validation on playlist command packets. - General hardening across audio storage, networking, and audio processing. - Replaced control glyphs with Manta icons. - Added a unit test suite (52 tests). --- ## 日本語 ### 重要な変更 - **全画面を Manta UI へ移行** — 再生装置・記憶装置の画面を Manta UI ランタイム上の BelugaExperience デザインワークフローで再構築しました。 - **Manta を jar に内包 (jar-in-jar)** — Manta 1.1.12 を同梱し、必須依存として宣言。別途インストールは不要です。 ### 追加 - **♪ スケジュール (プレイリスト)** — 再生装置から複数の記録媒体を順番に再生。最大 6 エントリ、各 1〜10 回。行のスロットへドラッグ、または Shift クリックで最初の空き行へ割り当て。▲ / ▼ で並べ替え、行の ▶ で試聴、✕ で削除。**▶ Play All** で通し再生し、再生中の行は枠線で示されます。 - **ゲーム内 wiki** — **📖** ボタンでその画面の解説を開きます。ヒント ON のときは要素にホバーして **F1** でその機能のページへ。英/日 5 ページ。 - **ヒント表示** — 各画面右上のトグル。ホバーした要素の説明が左下に表示されます。 - **ジャケット表示** — 音声ファイルに埋め込まれたアートワークをデバイス画面に表示。JPEG も Manta の画像デコーダ経由で表示されます。 - **アクセスモード (公開 / 非公開)** — 最初に開いたプレイヤーが所有者になります。顔アイコンで公開 (緑) / 非公開 (赤) を切り替えます。 - **範囲指定ボードの HUD** — 手に持つと画面下部に HUD が出ます。**Alt + ホイール**でモード切替、**Ctrl または Shift + ホイール**で現在モードの値を調整。 - **書き込みエラーの通知** — 記憶装置での書き込み失敗が画面上に表示されるようになりました。 ### Bug Fixes - **1.0.3 以前のワールド資産が認識されない問題を修正。** 1.0.4 の改名では namespace だけが変わったため、ブロック・アイテム・ブロックエンティティ・メニュー・音声 ID を保持するデータコンポーネントが、いずれも存在しない Mod を指したままになっていました。旧 ID から現行 ID へのレジストリエイリアスを追加し、音声ストレージは旧ディレクトリもフォールバック参照します。**1.0.3 以前のワールドの記録媒体・再生装置・範囲指定ボードがそのまま使えます** (1.0.4 の「新規ワールドへ移行が必要」という注意は解消されました)。 ### 改善 - 再生セッションのレジストリとスケジューラを追加し、再生の開始 / 停止 / 完了通知を一元化。 - 再生のタイムアウト処理を追加。 - プレイリスト操作パケットの入力検証を強化。 - 音声ストレージ・ネットワーク・音声処理まわりを全体的に堅牢化。 - 操作系グリフを Manta のアイコンへ置き換え。 - ユニットテストを追加 (52 件)。

> Japanese version: [CHANGELOG.md](CHANGELOG.md) ## [1.0.4] - 2026-05-05 ### Major Change (Mod rename / ID change) - **Renamed from "Station Sound System" to "Spatial Audio System"** Repositioned as a general-purpose spatial audio playback mod rather than a railway-station-specific mod. - Mod ID: `stationsoundsystem` → `spatialaudiosystem` - Display name: `Station Sound System` → `Spatial Audio System` - Java root package: `com.example.stationsoundsystem` → `com.spatialaudiosystem` - Main class: `StationSoundSystem` → `SpatialAudioSystem` - Resource locations (`assets/`, `data/`) and the GitHub repository have been renamed accordingly. - **Recording media, playback devices, and range boards from 1.0.3 or earlier are not recognized in worlds upgraded to 1.0.4. Either start a new world or replace the affected items / blocks.** ### Public API for Integration (for addon mods) - **New package `belugalab.sas.api`** added as a stable API surface that will not be repackaged across versions. Internal package `com.spatialaudiosystem.*` is subject to repackaging, so addon mods must always reference the `belugalab.sas.api` package. - **`belugalab.sas.api.SasApi`** — facade class - `isInstalled` — whether SAS is loaded - `isRecordingMedium`, `isRangeBoard` — item type checks - `hasAudio`, `getAudioFileName`, `getAudioFormat`, `getAudioId` — recording medium metadata - `hasRange`, `getRangePos1`, `getRangePos2`, `getAttenuationRanges` — range board metadata - `loadAudio`, `loadAudioFromMedium` — server-side audio binary loading - `playAudio` — server-side broadcast playback - `stopAudio` — stop playback at a position - **`belugalab.sas.api.PlaybackEndedEvent`** (NeoForge event) - Fired when playback finishes. Mods implementing chained / sequential playback can hook this without polling. - The handler in `PlaybackControlPayload` also posts this event on stop notifications, so it covers `playAudio` calls that bypass `PlaybackDeviceBlockEntity` (e.g. addon-driven dynamic playback). ### Bug Fixes - **Fixed audio continuing to play on the title screen after leaving a world** Added a new `ClientLifecycleHandler` that subscribes to `ClientPlayerNetworkEvent.LoggingOut` and `LevelEvent.Unload`, calling `AudioManager.stopAll()` on either event. In-flight `ClientAudioChunkPayload` chunk sessions are also cleared, so leftover sessions do not bleed into a subsequent login. Changelog > English version: [CHANGELOG-EN.md](CHANGELOG-EN.md) ## [1.0.4] - 2026-05-05 ### 重要な変更 (Mod のリネーム / ID 変更) - **Mod 名を「Station Sound System」から「Spatial Audio System」に変更** 鉄道駅専用ではなく汎用的な空間音響再生 Mod として位置づけを明確化。 - Mod ID: `stationsoundsystem` → `spatialaudiosystem` - 表示名: `Station Sound System` → `Spatial Audio System` - Java パッケージ root: `com.example.stationsoundsystem` → `com.spatialaudiosystem` - メインクラス: `StationSoundSystem` → `SpatialAudioSystem` - リソース ID (`assets/`、`data/`)・GitHub リポジトリ名も同名に変更 - **既存ワールドから 1.0.3 以前の記録媒体・再生装置・範囲指定ボードを引き継ぐと認識されないので、新規ワールドへ移行するか、各アイテム / ブロックを置き直す必要があります** ### 公開 API の追加 (他 Mod 連携用) - **新パッケージ `belugalab.sas.api`** を追加。バージョン間で安定した API 表面として維持されます (内部パッケージ `com.spatialaudiosystem.*` はリパッケージされるため、addon mod は必ずこちらを参照してください)。 - **`belugalab.sas.api.SasApi`** — facade クラス - `isInstalled` — SAS が読み込まれているか - `isRecordingMedium`, `isRangeBoard` — アイテム種別判定 - `hasAudio`, `getAudioFileName`, `getAudioFormat`, `getAudioId` — 記録媒体メタデータ - `hasRange`, `getRangePos1`, `getRangePos2`, `getAttenuationRanges` — 範囲指定ボードのメタデータ - `loadAudio`, `loadAudioFromMedium` — サーバー側の音声バイナリ読み込み - `playAudio` — サーバー側からブロードキャスト再生 - `stopAudio` — 指定位置の再生停止 - **`belugalab.sas.api.PlaybackEndedEvent`** (NeoForge event) - 再生完了時に発火。連鎖再生 / シーケンシャル再生を実装する mod が polling 不要で連結できる - `PlaybackControlPayload` の停止通知ハンドラからも発火するため、`PlaybackDeviceBlockEntity` を介さない `playAudio` 呼び出し (= addon mod 側で動的に再生する場合) もカバー ### Bug Fixes - **ワールドを抜けた後にタイトル画面で音声が鳴り続ける問題を修正** 新規 `ClientLifecycleHandler` で `ClientPlayerNetworkEvent.LoggingOut` と `LevelEvent.Unload` を購読し、`AudioManager.stopAll()` を呼ぶように変更。送受信中の `ClientAudioChunkPayload` チャンクセッションも一括クリアするため、再ログイン後に旧セッションの残骸が混ざる問題も併せて解消。

# Station Sound System v1.0.3 [日本語](#japanese) | [English](#english) --- <a id="japanese"></a> ## 🇯🇵 日本語 ### 重要な変更 #### 音声データのチャンク分割送信を実装 アップロード（Client→Server）・再生配信（Server→Client）の両方で音声データを500KB単位に分割して送信するよう変更しました。 NeoForgeのパケットサイズ上限（約1MB）を超える音声ファイルでも**サーバーからキックされなくなりました**。 最大ファイルサイズを10MBに拡大。 ### 改善 - **チャンク転送セッションのタイムアウト追加** — アップロード・ダウンロードの未完了セッションは30秒で自動破棄。切断時のメモリリークを防止 - **バージョン不一致時の接続拒否を解消** — サーバーとクライアントのModバージョンが異なる場合でも接続が拒否されなくなりました - **lite inventory構築を自動化** — 新コンポーネント追加時のバグを防止 - **範囲指定ボードの通知メッセージをHUDに移動** — 座標設定・クリア時のメッセージがパネルと重ならなくなりました ### Bug Fixes - **大容量音声ファイルの書き込みでキックされる問題を修正** — 単一パケットのサイズ上限を超える音声ファイルの書き込みが可能に - **大容量音声ファイルの再生で全プレイヤーがキックされる問題を修正** — サーバーからの再生配信でも同様のパケットサイズ超過問題を解決 --- <a id="english"></a> ## 🇺🇸 English ### Important Changes #### Chunked Audio Transfer Both upload (Client→Server) and playback distribution (Server→Client) now split audio data into 500KB chunks. Audio files exceeding NeoForge's packet size limit (~1MB) **no longer cause server kicks**. Maximum file size expanded to 10MB. ### Improvements - **Transfer session timeout** — Incomplete upload/download sessions are automatically discarded after 30 seconds, preventing memory leaks on disconnect - **Version mismatch tolerance** — Clients and servers with different mod versions can now connect without being rejected - **Automatic lite inventory construction** — Prevents bugs when new data components are added - **Range Board notifications moved to HUD** — Coordinate set/clear messages no longer overlap with the HUD panel ### Bug Fixes - **Fixed server kick when writing large audio files** — Audio files exceeding the single packet size limit can now be written successfully - **Fixed all players being kicked when playing large audio files** — Server-to-client playback distribution also suffered from the same packet size issue

# Station Sound System v1.0.2 [日本語](#japanese) | [English](#english) --- <a id="japanese"></a> ## 🇯🇵 日本語 ### 重要な変更 #### 音声データの保存方式をファイルベースに変更 音声データをItemStackのDataComponentから分離し、ワールドデータとしてサーバー側のファイルに保存するよう変更しました。 `<world>/stationsoundsystem_audio/<uuid>.audio` に個別ファイルとして保存されます。 ItemStackにはUUID参照のみ保持し、**ネットワーク同期やクリエイティブモードによるデータ破損を根本的に解決**しました。 旧バージョン（1.0.0〜1.0.1）の記録媒体は初回再生時に自動でマイグレーションされます。 ### 改善 - **Modアイコンを追加** — Mod一覧に再生装置のアイコンが表示されるようになりました - **範囲指定ボードのパネル文字を日本語化** — モード名を「通常範囲指定」「減衰率設定」「下向き設定」に変更。方向名・説明文も日本語化 - **範囲指定ボードの遠距離選択** — 手の届かない位置のブロックも64ブロック先まで右クリックで選択可能に - **範囲指定ボードの追従アニメーション** — Pos1のみ設定時、Pos2が視線先になめらかに追従するプレビュー表示を追加 ### Bug Fixes - **バージョンアップ時に音声データが破損する問題を根本修正** — ファイルベースストレージへの移行により、ネットワーク同期経由の破損が発生しなくなりました - **ワールド参加時に範囲外で音が鳴る問題を修正** — レンダースレッドからフレームごとにゲイン更新を行うよう改善 --- <a id="english"></a> ## 🇺🇸 English ### Important Changes #### File-based Audio Storage Audio data is now stored as individual files on the server (`<world>/stationsoundsystem_audio/<uuid>.audio`) instead of inside ItemStack DataComponents. This **fundamentally eliminates audio data corruption** caused by network sync or creative mode operations. Recording media from older versions (1.0.0–1.0.1) are automatically migrated on first playback. ### Improvements - **Mod icon added** — The playback device icon now appears in the mod list - **Range Board UI localized to Japanese** — Mode names, directions, and descriptions are now in Japanese - **Long-range block selection** — Select blocks up to 64 blocks away with right-click - **Follow preview animation** — When only Pos1 is set, Pos2 smoothly follows the crosshair ### Bug Fixes - **Fixed audio data corruption on version upgrade** — Migration to file-based storage eliminates corruption from network sync - **Fixed audio playing outside range on world join** — Gain is now updated every render frame

# Changelog ## [1.0.1] - 2026-03-12 ### Bug Fixes - **Fixed an issue where the attenuation mode was not functioning properly.** Addressed a problem where a `ConcurrentModificationException` was being silently caught internally due to non-thread-safe access to the `ClientLevel` player list from the background audio thread, causing the gain to remain stuck at 1.0 (maximum volume). Changed the logic to cache player coordinates per frame from the main thread, allowing the audio thread to safely reference this cache. - **Improved the update timing of the attenuation gain (Fixed an issue where audio would briefly play at full volume when stepping out of the orange boundary).** Previously, the audio thread updated the gain approximately every 260ms, which caused the audio to be heard at full volume for a split second immediately after stepping out of bounds. Changed the gain update to occur on the render thread (approx. 60fps), significantly improving the response time. - **Fixed an issue where the attenuation mode did not work for audio played by other players.** Thanks to the aforementioned improvement in gain update timing, attenuation is now correctly applied even when playing audio media recorded by players other than yourself. - **Fixed a bug where audio would not play via redstone input.** Resolved an issue where the packet sending process for `startPlayback()` was omitted during the multiplayer compatibility refactoring. Restored the logic to send a playback packet to all clients on the rising edge of a redstone signal. - **Fixed an issue where audio data on recording media would become corrupted.** Fixed a problem where the creative mode item slot synchronization packet would overwrite the actual server-side data with client-side temporary data (placeholders). Added validation to skip playback if invalid data is detected. - **Fixed an issue where audio on other clients would not stop when the block was destroyed.** Updated the logic to send a `ClientStopAudioPayload` to all players when the playback device is destroyed.