OutFox(5.3) LTS-0.4.18.1

5.0.12

過去の不具合

• 諦めましょう。
• 嫌味でもなんでもなく、知識がないのは危険だからです。
• StepManiaは海外の熱狂的DDRファンたちが集まって作成したファンゲームです。個人開発ゆえ絶対に安全なソフトだという保証はどこにもありません。
• 公式サイトから必要ファイルをDLするということは（簡単な）英語を読まなくてはなりません。
• 楽曲ファイルやテーマファイルはアップローダー経由で配布されているものも多く、アップローダーには悪質なソフトをDLさせようとする広告が表示されているものもあります。
• 楽曲ファイルによってはダウンロードするだけで違法になるものもあります。
• ソフトのインストールの仕方はわかりますか？PCにはインストールするべきではない場所もあります。
• StepMania内の設定ではテクスチャのメモリ保持等、必須条件を満たしていない場合変更してはいけない項目もあります。
• ネットワーク対戦のためにファイアーウォールの登録やポート開放が必要になることもあります。
• そういったことから、もし何かあった場合自分で対処できないのであれば導入するべきではありません。
• PCに触れていくと自然にわかるようになります。自分で対処できる自信がついたならぜひ。
• そうじゃなくて入れ方書けという指摘があったので公式ドキュメントのリンクはっときます

• 大元となったStepMania 4 Alpha から格段に進化して、かなり安定しています。
• 普通に遊ぶ分にはクラッシュするバグには遭遇しないです。
• 以前のバージョンでは背景動画の再生時にクラッシュすることがありましたが、Alpha2で修正されています。
• 3.9と動画の再生位置が若干ずれていましたが、Beta3で修正されています。
• 5.0では読み込める動画の種類が増え、 mp4 形式も再生できます。

• というわけで比較画像を用意してみました。
• NoteSkinはロングノートのボディ部分が半透明なYA_Solo 6+を使用しています。

検証1：ロングノートの終端（BottomCap）の接続

5.0.7RC	5.0.12	5.1+NB	OutFox(旧5.3A4.9.8)
非常にきれい	1ピクセル重なっている	非常にきれい	非常にきれい

検証2：矢印の重なり方

5.0.7RC	5.0.12	5.1+NB	OutFox(旧5.3A4.9.8)
後の矢印が上	後の矢印が上	先の矢印が上 ロングノートが連続で来る場合、 先の終端が上に重なる	先の矢印が上 （Noteskin側で列ごとに設定可能） ロングノートが連続で来る場合、 後の先端が上に重なる

2021年2月現在描画がきれいで見やすいのはOutFox(旧5.3)か、5.1beta2にNightlyBuildをあてたものになります。
OutFox(旧5.3)の方が本家に近い重なり方を再現できます。

• Alpha 1a→Alpha 2 / Alpha 2→Alpha 3
• 変更に伴った修正がされていないテーマではエラーが発生します。
• Beta 3→Beta 4^{※非常に大きな変更です}
• エラーチェックがとても厳しくなりました。
• 対応していないテーマではエラーメッセージが大量に表示されたりクラッシュします。
• 当時のBeta 3用に作られていたほぼすべてのテーマでエラーが発生していました。
• 5.0.6→5.0.7rc
• フォントのiniの間違った書式が許されなくなりました。
• 間違った書式のままだったテーマでは文字間隔が異常になったり表示されなくなったりします。
• 5.0.7rc→5.0.7
• ノートの描画周りやグルーヴレーダーの計算に修正が加えられました。
• 5.0.7以降バージョンが上がるたびに修正されつつありますが、以前より重くなったり表示が崩れたりと劣化してしまった箇所があります。

• インストーラーのデフォルト値 C:\Program Files にインストールしてはいけません。^{※Beta3からデフォルト値が変更されています}
• C:\Programs とかデスクトップならOK
• C:\Program Filesなどのフォルダは、システムに影響を与える場所なので管理者の許可なくファイルの書き出しができないようになっています。 （これにより、悪意あるソフトが勝手にPCの設定を変えることを防げます）
• その結果、StepMania側でファイルを書き出す時に書き出し権限がなくてエラーを起こし、最悪の場合クラッシュします。
• 今では知ってて当たり前の知識なので、知らなかった人はこれを機に憶えておきましょう。

• 「dx...」がどうこうというメッセージが表示される場合は、DirectX エンド ユーザー ランタイムをインストールしてください。
• ⇒32b/64it版 Windows
• Microsoft公式での配布が終了したため、安全に正規の方法で入手することができません。現状どうすることもできません。
• 2021年2月追記：署名アルゴリズムが変更されて再配布されました。

• Visual Studio 2015 の Visual C++ 再頒布可能パッケージをインストールしてください。
• ⇒32b/64it版 Windows
• 結構頻繁に更新されてアドレスが変わるみたいなので、上記リンクで見つからなかった場合は探してください。

• Visual Studio 2013 の Visual C++ 再頒布可能パッケージをインストールしてください。
• ⇒32b/64it版 Windows
• 結構頻繁に更新されてアドレスが変わるみたいなので、上記リンクで見つからなかった場合は探してください。

• Visual Studio 2012 更新プログラム の Visual C++ 再頒布可能パッケージをインストールしてください。
• ⇒32b/64it版 Windows
• 結構頻繁に更新されてアドレスが変わるみたいなので、上記リンクで見つからなかった場合は探してください。

• StepManiaは現在32bitアプリなので自分でコンパイルするか、できなければ諦めましょう。
• OutFox(旧5.3)は64bitアプリらしいです。

• StepMania5.0 Beta4a以降である必要があります。
• Beta4ではなく4aです。

• Windows : AppDataのRoaming内にStepMania 5フォルダが存在し、そこにファイルが保存されています。
• キーボードのWindowsキーを押しながらRキーを押すと「ファイル名を指定して実行」が起動します。
• 「%AppData%」と入力し、OKを押すとフォルダが開くので、その中からStepManiaのフォルダを探してください。
• macOS : ~/ライブラリ/Application Support/StepMania 5/
• Linux : ~/.stepmania-5.0/
• 設定等のファイルは[StepManiaのフォルダ内]→[%AppData%/Stepmania 5]の順に認識されるのでStepManiaのフォルダ内にSaveフォルダ等を作ればそこに設定が保存されます。
• 曲や譜面を更新したのに反映されない場合は、[%AppData%/Stepmania 5]に曲等のデータが複製されている可能性があります。
• StepMania5を複数インストールした場合、設定やスコアが共有されるというメリットがありますが、キャッシュも共有されるため片方で曲を更新するともう片方でキャッシュと整合しなくなり不具合を起こす可能性があります。

• 使えます。
• 3.9/3.95/3.9 Plus/4a/4bで作成した譜面データとBMS/DWI/MSD/KSFが読み込めます。
• 逆に5.0で出力した譜面（ssc）は3.9で使えません。

• 使えません。
• 互換性があるのは曲データ、キャラクターファイル、アナウンサー、ランダムムービーです。
• 3.9用の2Dキャラクターは修正する必要がありますが、筆者は修正の仕方がわかりません。
• 設定やスコアの引継ぎもできません。^{※誰かが移行用ソフト作ればOK}
• 公式のQ&A見る限り3.9のセーブデータ持ってきたら認識されるみたい。

• FIXED Project（フィクスト プロジェクト）なんてどうでしょう。

• オプションのAPPEARANCE OPTIONSの一番上に変更項目があります。
• オプション項目程度の英語くらいは読めるようにしましょう。

• StepMania 5.0はそれなりにハイスペックマシンでないと動きません。
• そもそも3.9が正式版になった当時もハイスペックPCじゃないとまともにプレイできなかったので、StepMania＝要スペックだと思ったほうがいいです。
• テクスチャ色数を減らす、ウインドウサイズを小さくする、フルスクリーンにするなどで多少はマシになります。
• あとはテーマ次第で軽くなるかもしれません。

• デフォルトテーマであることを前提で説明します。
• GRAPHICS/SOUND OPTIONS（画像・音声設定）の下記項目を設定してみてください。
• あくまで低スペック環境の人向けの設定です。十分動く環境であれば画質劣化を起こすだけです。
• DISPLAY MODE（推奨：Full Screen）
• 一般的にはFull Screenのほうが軽いといわれています。
• DISPLAY RESOLUTION（推奨：854x480）
• ウインドウのサイズです。横幅はその下のアスペクト比設定で決まるので、縦幅のみを見てください。
• サイズが小さいほど軽くなります。縦幅480以上であればゲームに支障のないレベルで遊べます。
• DISPLAY COLOR（推奨：16bit）
• 16bitのほうが軽いですが、画面の発色レベルが落ちるのでゲーム画面が汚くなります。
• 特にグラデーションのかかっているところの影響が大きいです。
• HIGH-RES TEXTURES（推奨：Force Off）
• 高解像度テクスチャを使用するかの設定です。
• Force Offにすることで軽くなりますが、縦幅が480pxより大きいウィンドウサイズでプレイするとぼやけます。
• TEXTURE RESOLUTION（推奨：1024）
• テクスチャ1枚当たりの最大縦・横幅サイズです。
• 小さいほど軽くなりますが、この値を超えるサイズの画像や動画を読み込むとぼやけます。
• 1024でぎりぎり耐えられる程度だと思ってください。
• TEXTURE COLOR（推奨：32bit）
• テクスチャ1枚当たりの最大色数です。
• DISPLAY COLORと違いテクスチャ単位なので、それほど劣化は目立ちません。
• つまり、それほど効果はないと思います。
• MOVIE COLOR（推奨：32bit）
• 動画の最大色数です。
• そもそもTEXTURE COLORとMOVIE COLORは内部的に減色処理が入るので、場合によっては重くなるかもしれません。
• おそらく、古い環境で32bit表示にするとメモリが足りなくなる環境向けかな？
• SMOOTHLINES（推奨：On）
• グルーヴレーダーの表示にアンチエイリアシングを使用するかどうかの設定です。
• Offにすると軽くなるはずですが、まずわからないレベルだと思います。
• そもそも、これで差が出るような環境でSM5をプレイすること自体（略）
• CEL-SHADED MODELS（推奨：Off）
• 背景キャラクターの描画処理にセルシェーディング（トゥーンレンダリング）を使用するかどうかの設定です。
• 本家で例えると、Offが1st～5th、OnがEXTREME～STR!KEの表示に近いです。
• 3.9とは異なる方法でセルシェーディングを行います。キャラクターファイルに問題がある場合は正しくセルシェーディングになりません。
• 動作させるにはレンダーモードをOpenGLにする必要があります。
• そもそも、少しでも軽くしたいような環境でキャラクターを表示させること自体（略）
• KEEP TEXTURES IN MEMORY（推奨：Off/メモリ容量があるならOn）
• テクスチャ画像をメモリに残しておくことで、次に必要になった時に高速に読み出すことできるようになります。
• ですが、もちろんその分メモリが必要になるので低スペックPCではOffにするしかないです。
• そもそもシステムメモリなのかビデオメモリなのかよくわかりません。（多分システム？）
• また、説明文ではOnにするには128MB以上のメモリが必要とありますが、 3.9の時の説明文を使いまわしているだけだと思うので、実際には512MB以上ほしいところです。
• REFRESH RATE（推奨：Default）
• フルスクリーン時、1秒間に何回画面書き換えの処理をするかの設定です。
• 基本的にはモニターのリフレッシュレートを超えないはずなのでDefaultか60でいいと思います。
• モニターが120に対応しているからと言って120にしたら重くなるかと。
• WAIT FOR VSYNC（推奨：No）
• モニターのリフレッシュレートに合わせて画面を更新するかどうかの設定です。
• Yesにすると負荷は下がりますが、画面の更新間隔がモニターに合わせられます。
• Aeroが有効な場合、環境によってはすごくカクカクになります。この場合グラフィックボードのドライバーを正しく入れると改善されることがあります。
• Noにすると高フレームレートになりますが、その分CPU負荷が大きいです。

• StepMania 5.0のテーマは、高解像度でプレイすること前提に作っているものが多いです。^{※ハイスペックPCじゃないと厳しい要因のひとつ}
• デフォルト設定では 854x480 ですが、最低でも 800x600 以上ほしいところです。
• 最近のバージョンだと縦幅720が最低値になっているようです。

• StepMania本体と同じ場所か、AppDataのRoamingにあります。
• 前者の場合はインストールフォルダ内にCache、Save、Screenshotsフォルダがあります。
• 後者の場合は、以下の手順で移動できます。^{※Windowsの場合}
• Windowsキーを押しながらRボタンを押して「ファイル名を指定して実行」を起動。
• 「%AppData%\Stepmania 5」と入力してOKを押します。
• フォルダが開くのでその中にCache、Save、Screenshotsフォルダがあります。

• グローバルオフセットを調整することで対応できます。
• オプションの「CALIBRATE AUDIO SYNC」（音の同期）を選択し、流れてくる矢印を音に合わせて入力することで、自動的に調整されます。
• 手動で行う場合、セーブフォルダ内の「Preferences.ini」をテキストエディタで開き、GlobalOffsetSecondsにオフセットを設定します。

• デフォルトテーマでは表示するようなつくりになっていません。対応しているテーマを利用してください。
• WAIEI2
• WAIEI CitMin（選曲画面はバナー）
• 曲データにもジャケットが必要です。
• ファイル名に「jacket」が含まれていればOK、サイズは256x256が妥当。
• ちなみにジャケット表示はバナーのように画像キャッシュを使用しないため重いです。

• フォルダ構造が間違っています
• 例：WAIEI2を入れた時のフォルダ構造

□ StepMania
├□ Announcers
├□ Characters
├□ NoteSkins
├□ Songs
├□ （略）
└□ Themes
　├□ _fallback
　├□ default
　└□ WAIEI2
　　├□ BGAnimations
　　├□ Graphics
　　├□ Scripts
　　├□ （略）
　　└□ metrics.ini

• イベントモードを有効にしてください。
• Options→ARCADE OPTIONS→EVENT MODE　^{※Beta4以降}
• オプション→クレジットオプション→イベントモード　^{※Beta3以前}
• ただし、エキストラステージは出なくなります。

• Options→UI OPTIONS→CENTER 1 PLAYER　^{※Beta4以降}
• オプション→プレイ画面オプション→判定ゾーンの中央寄せ　^{※Beta3以前}

• SM形式とSSC形式のみ出力されます。
• そもそもDWI形式は対応していないパラメータが多いので今の時代あまり使えません。

• キャッシュを削除することで直る可能性があります。
• 選曲画面で対象曲を選択中、Ctrl+Shit+Rを押すと特定曲だけリロードされます　^{※5.0.8以降}
• StepManiaのフォルダ、あるいはAppDataのStepmania 5フォルダにキャッシュファイルがあります。

• ( ◠‿◠ ) その質問は非常識だということを理解してね。
• StepManiaでサポートしているゲームシステムの大半に元となるゲーム（以降、本家）が存在し、本来であれば存在自体がアウトになります。
  現在でもStepManiaが配布できているのは、いろいろな理由があって結果的に黙認状態を保ってもらえているからだと思います。
  なので本家から見て不快になるような行為はしないようにしましょうね。
  公式サイトでも書かれている通り、本家の曲・譜面をプレイしたいのであれば、きちんと本家でプレイしてください。

• 矢印の重なり方が3.9と逆です。
• OutFox(旧5.3)は重ね方を任意に指定できます。
• 本家はかなり特殊な重ね方です。







• 難易度の表記が異なります。
• ちなみに3.9は本家の古い表記と同じです。^{※3.9のテーマではBEGINNERの漢字が反転した楽という字になっていたりします。本来は習}

	本家	5.0	3.9
↑やさしい	BEGINNER ＜水色＞	NOVICE ＜紫＞	BEGINNER（習）＜水色＞
↑	BASIC ＜黄色＞	EASY ＜緑＞	LIGHT（楽）＜黄色＞
↓	DIFFICULT ＜赤＞	MEDIUM ＜黄色＞	STANDARD（踊）＜赤＞
↓むずかしい	EXPERT ＜緑＞	HARD ＜赤＞	HEAVY（激）＜緑＞
特殊	CHALLENGE ＜紫＞	EXPERT ＜水色＞	CHALLENGE（鬼）＜紫＞



• 矢印の色分けが本家と異なります。（Vivid/Rainbow）
• 本家風の色分けにするには本体の改造が必要です。
• Beta 4aから本家風色分けが可能になりました。
• YA_Solo_HDはこのカラー分けに対応しています。



• たとえば以下のような配置の場合、それぞれ次のように色分けされます。




本家色分け参考動画（#0:53～）

• エンドレスゲームオーバー時にクラッシュします。
• 1週以上したら落ちるとのこと。
• Beta4で修正されました。


• ウインドウサイズ・解像度を変更したとき1ドットずれることがあります。
• 例えば、1280x720の16:9を選択したのち、アスペクト比を4:3に変更、もう一度16:9に戻すと1281x720になる。（スクリーンショットのサイズなど）
• 大した問題ではないが、1ドットずれた状態で右Alt+Enterを使いフルスクリーン化すると、OpenGLモードの時に失敗することがある。（D3Dモードは自動で近い値に修正してくれる）
• 設定ファイルのDisplayAspectRatio=1.777777 にすると1280x720になる。

※Preferences.iniの中身より
DisplayAspectRatio=1.777778

• Stepmania.cpp内でウインドウサイズを指定するとき、横幅＝縦幅xDisplayAspectRatioと計算して、その後にceilf関数を使って丸めている。［参考］
• ceilfとは、引数より小さくならない範囲で一番近い整数を返す関数。
• そのため、720x1.777778=1280.00016 の ceilf により、1281が返るようです。（@803832さん情報）
• StepMania5.0.6で修正されました


• キー音ありSM/SSCをプレイすると、キー音とバック音がズレることがあります。^※要確認
• バック音のほうにグローバルオフセットが働いている模様。
• 各曲ごとにオフセット調整すれば回避可能。


• #ATTACKSが定義されている譜面をコースモード（またはジュークボックス）でプレイすると、次のステージ以降も#ATTACKSが反映されます。
• コースモードでは#ATTACKSの初期化がされていないと思われます。
• 一度でも該当曲をプレイしてしまうと、それ以降のステージは該当曲の＃ATTACKSが反映されてしまいます。


• CEL-SHADED MODELSが正しく動作していません。
• OpenGLモードでCEL-SHADED MODELSをONに設定しても正しく表示されません。
• キャラクターファイル側の問題でした。バグではありません。
• なお、D3Dモードは設定に関係なくトゥーンレンダリングになりません。


• D3Dモードで高画質スクリーンショットの作成に失敗します。
• Shiftを押しながらPrint Screenキーを押すことで、高画質なスクリーンショットの出力ができますが、D3Dモードではファイルが壊れた状態で出力されます。
• 開発チームの扱いを見ると、どうやらD3Dモードは非推奨？
• 5.0.9で修正されました。


• キャラクター（背景ダンサー）にSplitBPMが反映されていません。
• 楽曲のメインBPMが反映されています。
• 通常プレイではあまり影響ないですが、BEGINNER HELPERの動きがずれます。


• BEGINNER HELPERにCharacter.iniのコマンドが反映されていません。
• 3.9では身長の小さなキャラクターでもボーンファイルが共通なため、大きく作成することで無理やり対応されていました。
• 5.0ではCharacter.iniにInitCommandを定義することができ、大きさなどの問題が解消されました。
• しかし、この設定はBEGINNER HELPERには反映されていないため、大きいままだったり、キャラクターが浮いたりします。

• 上にも書きましたが C:\Program Files 等にインストールしていると予期せぬクラッシュを起こすことがあります。
• どこにインストールしたらいいのかわからなければ、とりあえずデスクトップにインストールしてください。

• エラー詳細は「View Crash Info」ボタンを押すと確認できます。

• Main threadがMovieTexture云々と書かれている場合、ほぼ確実に背景動画が原因です。
• Alpha2以降にバージョンアップするか、動画ファイルをDivXかXvidでエンコードしなおすと直ることがあります。
• 基本的にBeta2までは背景動画の動作が不安定です。Beta3以降にすることをおすすめします。

• テーマファイルに該当するスクリーン（上記画像の場合はScreenFIXEDProject5）が正しく定義されていません。

• default.lua 内で default.lua を呼び出す等、無限ループに陥ってる可能性あり。

• 上記画像下線部のファイルが複数存在しているときにこのエラーが発生します。
• たとえば LoadActor("hoge") とした場合、エラーが発生するパターンは次の通りです。
• 同じフォルダ内に「hoge.png」と「hoge.jpg」が存在している
• 同じフォルダ内に「hoge.png」と「hoge」フォルダが存在している
• 同じフォルダ内に「hoge.png」と「hoge2.png」が存在している
• 3つ目の例に挙げたように、別名でもファイル名の先頭から指定した文字を含んでいる場合は同じファイルとして扱われます。
• つまり「hoge」と定義した場合、「hoge.png」「hoge hoge.png」「hoge2.png」「hogeperoperopero.png」はすべて同じファイルとして扱われます。

• そのままです。

• 譜面ファイルにファイル名を指定しているにもかかわらず、画像が存在しない場合はこのエラーが発生します。

• 対応画像形式はpng/jpg/gif/bmpです。

• 上記画像の場合、テーマファイルのMetrics.iniに以下の定義がされていません。

[ScreenSelectMusic]
ShowHOGEHOGE=false;
# ※trueでもOKだが、OnCommand等の定義が必要になる

• 上記画像の場合、テーマファイルのLanguage/en.iniに以下の定義がされていません。

[OptionTitles]
waiei DesignOptions=Design Options

• もちろん日本語で書きたい場合は、Language/ja.iniに定義すればOK。

• 画像下線部のファイルの縦または横のサイズが4（場合によっては2）の倍数になっていない時にこのエラーが発生します。
• 画像の場合、1708x959になっているので1708x960にするようにという内容です。

• 画像下線部のファイルのある行にエラーがあるとき発生します。
• ファイル名の横の「:数字」となっている部分が問題のある行です。
• だいたいは以下のミスです。
• スペルミス（CommandをCOmmandとしている等）
• 「;」忘れ（Text="XXX"; 等セミコロンが必須の行がある）
• LoadActor等の「..」忘れ
• endや{}の数があっていない
• nil変数に数値加算など不可能な計算をした

• *.smあるいは*.ssc、*.dwiにバナーや背景の指定がされている場合はそれを優先する。
• 指定がない場合は以下の条件で探す。（ ###は任意の文字（0文字～）、xxxは対応した拡張子 ）
• バナーファイルが指定されていない場合
• ファイル名が ###banner.xxx か ### BN.xxx
• 背景ファイルが指定されていない場合
• ファイル名が ###background.xxx か ###bg.xxx
• ジャケット（アルバムアート）が指定されていない場合
• ファイル名が jk_###.xxx か ###jacket###.xxx か ###albumart###
• CD画像が指定されていない場合（CD画像とは初期の本家の選曲で利用されていたCDのこと）
• ファイル名が ###-cd.xxx
• ディスクイメージが指定されていない場合（ディスクイメージとは最近のPIUで利用されている選曲用の1枚絵のこと）
• ファイル名が ### disc.xxx か ### title.xxx
• それでも画像が見つからない場合はフォルダ内の対応画像ファイルをひとつずつチェックしていく
• ※ここでは画像と言っているが、正しくはSMがサポートしてる形式全て