TJAPlayer3-f

最終更新日:2025/04/25(Mr-Ojii)

このReadmeはTJAPlayer3のReadmeを基に作成いたしました。

はじめに

このソフトウェアは、アーケード/家庭用ゲーム「太鼓の達人」シリーズ用、譜面ビューアーです。
このソフトウェアは、Mr-OjiiがTJAPlayer3というシミュレーターを改造したものです。

• 太鼓さん次郎・TJAPlayer等で使われている.tjaファイル
• Koioto等に使われている.tcc .tcm .tciファイル

を読み込み、再生することができます。
(すべての対応ファイルが読み込めるわけではありません。)

もともとはシミュレーターとして開発していましたが、現在は、譜面ビューアーとして開発を続行しています。

使用上の注意

• TJAPlayer3-fはオープンソースソフトウェアです。このソフトウェア・スキンはすべてMITライセンスに準拠します。
• プログラムの制作者(Mr-Ojii)は、TJAPlayer3-f本体(GitHubからのダウンロード)とデフォルトのスキンのサポートのみ行います。
• すべての環境で動作確認はできないので、動いたら運がいい、程度でお願いします。
• 常時60fpsを保てないPCでの動作は期待できません。
• このプログラムを使用し発生した、いかなる不具合・損失に対しても、一切の責任を負いません。
  このソフトウェアを使用する場合は、全て自己責任でお願いします。

動画、配信等でのご利用について

TJAPlayer3-fを動画共有サイトやライブ配信サービス、ウェブサイトやブログ等でご利用になられる場合、
バンダイナムコエンターテインメント公式のものでないこと、他のソフトウェアと混同しないよう配慮をお願いいたします。
また、タグ機能のあるサイトの場合、「TJAPlayer3-f」「TJAP3-f」といったタグを付けることで、
他のソフトウェアとの誤解を防ぐとともに、関連動画として出やすくなるメリットがあるため、推奨します。

TJAPlayer3-fの改造・再配布(二次配布)を行う場合について

TJAPlayer3-f、デフォルトスキンはMITライセンスで制作されています。
MITライセンスのルールのもと、改造・再配布を行うことは自由ですが、全て自己責任でお願いします。
また、使用しているライブラリのライセンス上、必ず「ThirdPartyLicenses」フォルダを同梱の上、改造・再配布をお願いします。
外部スキンや、譜面パッケージを同梱する場合は、それぞれの制作者のルールや規約を守ってください。
これらにTJAPlayer3-fのライセンスは適用されません。

質問をする前に

質問をする前に、

1. 調べる前に考える
2. 人に聞く前に調べる
3. 過去に同じような質問がなかったか調べる
4. 使用しているパソコンの環境、どういう動作をしたら不具合を起こしたかの過程等を添えて連絡する

この4つのルールを守ってくださいますよう、よろしくお願いいたします。

バグ報告のお願い

開発者:@Mr_OjiiはC#を2020年3月16日に初めて触りました。
この改造をしながら、C#を勉強しているため、相当な量の不具合が含まれていると思われます。
不具合を発見した場合はGitHub Issuesにてご報告いただくようお願い申し上げます。 また、プログラムが落ちるようなエラーである場合、情報を開発者に送信するような仕様になっております。ご了承ください。

実装要望について

実装してほしいものがあればGitHubのIssuesまで。
趣味程度の改造なので時間はかかりますが、実装要望があったものは、なるべく実装したいと考えています。
趣味ですから、気分次第で実装をするので、不具合報告がなされても後回しにする可能性があります。すみません。

追加機能について

「AdditionalFeatures.md」で説明いたします。

推奨動作環境

OS

• Windows 10以降のWindows (x86, x64)
• macOS 10.15 "Catalina"以降のmacOS (x64, arm64)
• デスクトップ環境構築済みの Linux ディストリビューション 最新安定版 (x64, arm64)

CPU

• マルチスレッド対応
• x86,x64の場合、SSE対応(BASS)

実行方法

Windows環境

ダウンロード後、zipファイルを解凍し、フォルダ内に入っているTJAPlayer3-f.exeを実行してください。

macOS環境

ダウンロード後、zipファイルを解凍し、フォルダ内に入っているTJAPlayer3-fを実行してください。

Linux環境

TJAPlayer3-fのダウンロードごとに、zipファイルを解凍し、
TJAPlayer3-fが存在するディレクトリをカレントディレクトリとしたターミナルで

chmod +x TJAPlayer3-f.AppImage

をしてから、TJAPlayer3-f.AppImageを実行してください。

開発環境(動作確認環境)

OS

• Windows 11(Ver.23H2) (x64)
• macOS 15.4.1 (arm64)

Editor

• Visual Studio Community 2022
• Visual Studio Code

開発体制について

masterブランチでほぼすべての開発を行います。
(基本的なものはです。大規模なテスト実装などは、別のブランチに移行するかもしれません。)

開発状況

バージョン	日付(JST)	実装内容
Ver.2.0.0.0	??????????	未定

デフォルトスキンについて

一部画像は、TJAPlayer3のデフォルトスキンから流用しています。

スキンのサウンドについては徐々に自作にすり替えていきます。
耳コピできないので、Domino & Softalk等で適当に作った音声類になると思います。

スキン作成ツール

• AviUtl
• Blender
• FFmpeg
• GIMP
• Domino
• Audacity
• SofTalk
• UTAU

&それぞれのソフトのプラグイン/スクリプトなど

Discord Server

作っていいものかと思いながら、公開鯖を作ってみたかったので作ってしまいました。
過疎鯖と化しているため、それでも良いという方のみお入りください。
主に情報交換や「これ不具合？」のような質問を気軽に投稿していただくのためのサーバーであるため、不具合報告や実装要望などはGitHub Issuesにお願いいたします。
情報を一箇所にまとめ一括管理をするためです。ご了承ください。 また、参加した際、#readmeをご一読ください。よろしくお願いいたします。
https://discord.gg/Wg9bD5jTHZ

ライセンス関係

Fork元より使用しているライブラリ

• bass
• FDK21(改造しているので、FDKとは呼べないライブラリと化しています)

以下のライブラリを追加いたしました。

• ReadJEnc
• FFmpeg.AutoGen
• SDL3
• ppy/SDL3-CS
• discord-rpc-csharp
• M+ FONTS
• managed-midi
• ManagedBass
• SkiaSharp
• Tomlyn

また、フレームワークに.NETを使用しています。

ライセンスは「ThirdPartyLicenses」に追加いたしました。

FFmpegについて

TJAPlayer3-fと同じフォルダにFFmpegフォルダを作成し、
その中にOSとTJAPlayer3-fのアーキテクチャに対応したフォルダを作成し、 TJAPlayer3-fのアーキテクチャに対応したFFmpeg 7.0バイナリ(Shared)を置くことにより、

• FFmpegが対応している動画ファイルの再生
• FFmpegが対応している音声ファイルの再生

ができるようになります。

OSとTJAPlayer3-fのアーキテクチャ数に対応したフォルダ名

• Windows
  • x86 : win-x86
  • x64 : win-x64
• macOS
  • x64 : osx-x64
  • arm64 : osx-arm64
• Linux
  • x64 : linux-x64
  • arm64 : linux-arm64

BASSについて

このリポジトリにはあらかじめBASSライブラリが同梱されています。

謝辞

このTJAPlayer3-fのもととなるソフトウェアを作成・メンテナンスしてきた中でも
主要な方々に感謝の意を表し、お名前を上げさせていただきたいと思います。

• ＦＲＯＭ様
• yyagi様
• kairera0467様
• AioiLight様

また、他のTJAPlayer関係のソースコードを参考にさせていただいている箇所がございます。
ありがとうございます。