BakoshApp ロゴBakosh.appBakosh.app ホーム

アプリのアーキテクチャ

BakoshAppの構造について。設定の保存場所、TikTokイベントがゲームへ流れる仕組み、アクティブMod切替時の挙動、自動アップデートの仕組みを解説します。

BakoshAppとは

BakoshAppはWindowsデスクトップアプリで、TikTokのLIVE配信中に発生したイベントをゲーム内のModと連動させます。視聴者がギフトを送ったり、いいねを押したり、チャットを書き込んだりすると、配信者のゲーム内でエフェクトが自動的に発火します。

現在、アプリには5つのModが同梱されています。

  • GTA V KOTH (King of the Hill) — 視聴者が車両や障害物をスポーンさせる「キング・オブ・ザ・ヒル」モード。インタラクティブ、PRO。
  • GTA V Chaos — 視聴者が350種類以上のカオスエフェクト(時刻、天候、NPCスポーン、画面エフェクト)を発動できます。インタラクティブ、PRO。
  • GTA V Train — 自動制御の列車シミュレーター(発進・停止、線路切替、速度・耐久度の管理)。オートマチック、MAX。
  • Rust Survival — フルローカルのRustサーバー。視聴者がストリーマーにアイテムを贈ったり、動物をスポーンさせたり、トラップを作動させたりできます。インタラクティブ、PRO。
  • RDR2 Chaos — Red Dead Redemption 2用、185種類以上のカオスエフェクト。インタラクティブ、PRO。

KOTH、Chaos、Trainは同じGTA V Modアーカイブ(gta.zip)の3つのバリエーションです。ダウンロードは共通ですが、各バリエーションは個別のインストールフォルダ(gta_koth_folderPath、gta_chaos_folderPath、gta_train_folderPath)を持ち、1つのGTA Vインストール先を指定することも、別々に指定することもできます。同時にアクティブにできるModは1つだけで、サイドバーの各Modカードにあるトグルで切り替えます。

TikTokイベントがアプリに届く仕組み

TikTok LIVEのイベントがBakoshAppに届くようにするには、2つの接続方法のうちいずれかが必要です。

方法利用可能プランインストールが必要なもの
TikFinityFreeとPROTikFinity + TikTok Live Studio
Native Connector (BakoshApp内蔵)PROのみ不要 — 接続は自動

TikFinityはTikTokイベントを受信してBakoshAppへ転送する別プログラムです。Native ConnectorはTikFinityを介さず直接TikTokへ接続する、PRO限定の機能です。TikTok Live Studioはどちらの構成でも必要で、PCからTikTok LIVEを配信するためのものです。コネクター同士の違いは、TikTokからBakoshAppへイベントを取り込む経路だけです。詳しい比較はTikFinity vs Nativeを参照してください。

視聴者がギフトを送ったときの流れ

  1. TikTokからイベントが届きます(TikFinityまたはNative Connector経由)。
  2. BakoshAppがEvents & Actionsページで設定したトリガーと照合します。
  3. 一致する場合、アプリがゲーム内でアクションを発火します。
  4. 同時に、そのアクションに割り当てた音声が再生されます。

この処理パイプラインはどのModでも共通で、アクションとトリガーのカタログだけが異なります。

設定の保存場所

BakoshAppの設定はWindowsの隠しフォルダ%LOCALAPPDATA%\BakoshAppに保存されます。開くには、Windowsエクスプローラーのアドレスバーにこのパスを貼り付けます。旧バージョンでは別フォルダに置かれていましたが、アップデート後の初回起動時にアプリが自動的に移行します。

ローカルに保存される設定: GTA Vのフォルダパス、Rustサーバーのフォルダパス、Rustサーバーの起動パラメーター、現在のアクティブMod、個人用ユーザー識別子。

アクションそのもの(各ギフトの動作、割り当てられたトリガー、再生される音)はサーバー上にアカウントと紐付けて保存されます。つまり、Windowsを再インストールしたりPCを乗り換えたりしても、ログインするだけで設定一式が復元されます。各ModのEvents & ActionsページにあるExportボタンから.bkaファイルにエクスポートすることもできます。詳しくはインポート / エクスポートを参照してください。

Info

アクションはサーバー上に保存されるため、Windowsの再インストール前に手動でバックアップする必要はありません。ログインし直すだけで戻ります。

アクティブModを切り替えたときの挙動

サイドバーの各Modカードにはトグルがあります。アクティブModを切り替えると、BakoshAppは以下を行います。

  • それまでアクティブだったゲームへの接続を閉じる
  • 累積したいいねとギフトのカウンターをリセットする
  • 新たにアクティブとなったゲームへの接続を開く

このため、切替直後の数秒間はインタラクティブ性が一時的に低下します。これは正常な動作で、再接続まで少し待ってください。

自動アップデート

BakoshAppは自動でアップデートされます。新しいバージョンが利用可能になった場合は、アプリを再起動して適用します。現在のバージョンはサイドバーの「Bakosh.app」ロゴのすぐ下に表示されます。

ウイルス対策ソフトがバックグラウンドファイルを削除した場合

インストール時、BakoshAppは小さなバックグラウンドサービスを同梱します。ウイルス対策ソフトがそのファイルを削除すると、アプリは動作しなくなります。症状: 起動時に「The system cannot find the file specified」、またはFailed to spawn sidecar (os error 2)が表示されます。

対処: bakosh.app/bakoshappからBakoshAppを再インストールし、その後インストールフォルダをウイルス対策ソフトの除外設定に追加してください。SmartScreenがインストーラーをブロックする場合は、「More info」→「Run anyway」をクリックします。

関連記事