100おれ MODマニュアル

Overview

100％おれんじじゅ～すっ！用 MOD について解説した公式マニュアルです。

はじめに

100％おれんじじゅ～すっ！用 MOD の制作とインストールについて解説します。

制作については「MOD 制作」セクションをお読みください。

公開されている MOD はこちらでご覧いただけます。
[link]

質問や疑問点などは、このガイドのコメント欄へお書きください。

法的通知

このガイドで言及されたゲームリソースをファイル解凍ソフト等で解凍し利用することは、ゲーム「100％おれんじじゅ～すっ！」用の MOD を制作するという目的においてのみ認められます。それ以外の目的での利用は一切認められません。また、ゲームやキャラクターの品位、それらの著作権保持者の権利を傷つける意図での MOD 制作も認められません。法を遵守し、商標を尊重することは、全ての MOD 制作者が負う責任です。

Fruitbat Factory, Ltd. は、MOD 制作を目的としたゲームリソースの利用に関する制限を、今後さらに追加、または取り消す場合があります。その際は、Twitter、Discord、Steam などで通知する、または該当ゲームリソースが含まれるアーカイブファイルを暗号化します。

全ての MOD 制作者は、自身の MOD を公開する前に、必ずこのガイドの最新版を読み、その MOD が制限事項に沿ったものであることを確認する責任を負います。

制限事項

MOD に対応している要素は以下の通りです。

• ユニット
• カードイラスト
• BGM
• ボイス
• 効果音

重要事項
MOD化に対応するファイルは、MOD化という目的のために暗号化されていないファイルのみです。
一部のボイスファイルは、カスタムボイスファイルと置き換えることができますが、そのボイスファイル自体に変更を加えたり、いかなる理由においても二次使用したりすることは禁止です。

ゲームにインストールされた MOD は、コンフィグ画面の「MOD」タブで確認できます。

現在のシステムバージョン

更新履歴

===============================

MOD 制作

MOD ファイルの保存場所

ゲームを開始すると、ゲームの EXE ファイルがあるフォルダに、mods フォルダが作成されます。
以下の手順で、EXE ファイルがあるフォルダを開くことができます。

① Steam ライブラリを開く
②「100% Orange Juice」を右クリック
③「プロパティ」
④「ローカルファイル」タブ
⑤「ローカルファイルを閲覧」

MOD ファイルは全て、この mods フォルダに保存してください。

—

MOD ファイルの準備

まず mods フォルダ内に新規フォルダを作成します。
このフォルダの中に必要なファイルを保存します。
フォルダ名はなるべくシンプルなものが望ましいです。

Steam ワークショップ対応に伴い、MOD 定義ファイルのフォーマットが変わりました。
今後は、新しい MOD 制作方法のみがサポートされます。
また、MOD を Steam ワークショップに投稿する際は、必ずこのガイドにある手順で行ってください。

以下は定義ファイルに記載するコードのサンプルです。

サンプルコード

上記をメモ帳などのエディタに記載し、「mod.json」という名前で保存してください。
保存場所は、自身で作成した MOD フォルダの直下です。

以前の方法で定義ファイルを作成する場合は、後述の該当セクションをご覧ください。
ただし、以前の方法は非推奨ですので、その点はご留意ください。

MOD 定義

MOD ファイルとの置き換え

定義ファイルの中には、MOD に対応した各要素専用のセクションがあり、各要素ごとに置きかえる MOD ファイルが必要となります。
1つの定義ファイルの中に複数のセクションを含めることもできます。

置き換えについては、このガイドの次のセクション以降で詳細に説明します。

テクスチャ

テクスチャを置き換えるには、対象ファイルのパスを定義ファイル内で指定します。
画像ファイルは、拡張子が「.pak」のアーカイブファイルとして、「data」フォルダに保存されています。
アーカイブファイルは、7-Zip、WinRAR、WinZIP などのソフトで解凍できます。
該当するアーカイブファイルは以下の通りです。

• units
• alphamasks
• hats
• hairs
• cards
• field

—

テスクチャはPNG形式で元画像と同じサイズにしてください。

ユニット関連のテクスチャサイズ：256×256
カードのテクスチャサイズ：256×256 ＆128×128 (２種類のサイズ必須)
ホームマスのテクスチャサイズ： 256×256
その他のマスのテクスチャサイズ：128×128

—

まず、ユニット関連画像のパス指定についてです。
ユニット関連画像は１つのパスで全てのポーズを指定できます。
例えば、「ソラ＆シャム（アイドル）」のデフォルトカラーを対象にする場合、下のサンプルコードのように「units/cuties_00_00」と指定することで、全てのポーズが対象となります。
「ソラ＆シャム（アイドル）」のカラー１も対象にしたい場合は、「units/cuties_00_01」と指定します。
一部のポーズのみを置き換えたい場合は、後述の「高度な置き換え」をお読みください。

サンプルコード

次にカード画像のパス指定についてです。
上のサンプルコードでは「cards/cuties」が指定されており、この１つのパス指定で２種類のサイズの両方が対象になります。
カード名とフレイバーテキストも変更したい場合は、後述の「高度な置き換え」をお読みください。
(※ユニット関連画像とは異なり、カード画像は一度定義するだけです。高度な置き換えでも同様です。)

高度な置き換えでは、ユニットの顔座標や、カードの名前とフレーバーテキストといったパラメータの設定ができます。

高度な置き換えで利用できるパラメータは以下の通りです。

顔座標はユニット画像の中央を定義します。一番分かりやすい例はゲーム内HUDです。
顔座標は、ユニットの顔の中央の座標値を指定してください。
下のサンプル画像のキャラの場合、顔の中央の座標値は X116 Y129 となります。

JSON ファイルには以下のように記載します。

各衣装には個別の座標値が設定されています。
衣装の定義には、対象の衣装の ID 番号を指定します。
衣装の ID 番号は「衣装 ID」セクションで確認できます。

以下のサンプルコードでは、水着スグリの通常ポーズに座標値が追加されています。

高度な置き換えは通常の置き換えと組み合わせることができるため、別途 JSON ファイルを作成する必要はありません。

高度な置き換えが利用できるのはユニットとカードの画像のみです。
髪やアクセサリーなどのパス指定は、通常の置き換えと同様に「hairs/sora_b00」などすることで全てのポーズを一括で指定します。

以下のサンプルコードでは、最初と最後の塊で「units/sora_00」に高度な置き換えが設定されており、それ以外では通常の置き換えが設定されています。

BGM

BGM の置き換えには以下のパラメータを使います。
BGM ファイルは必ず OGG 形式にしてください。

ボイス

ボイスの置き換えには、ボイスの種類によって以下の２つのパラメータのいずれか使用します。

• character：置き換え後のキャラクターボイスファイルが保存されたフォルダのパス一覧です。
• system：置き換え後のシステムボイスファイルが保存されたフォルダパス一覧です。

ボイスのパス指定は、以下のサンプルコードのようになります。
正しくパスが指定されると、pak ファイル内にある本来のボイスファイルは再生されず、自身でパスを指定したファイルが再生されるようになります。

サンプルコード

例えば、カイのシステムボイスのみを置き換えたい場合は、以下のコードになります。

サンプルコード

正常に置き換えを行うには、置き換え後のファイルの名前や保存場所を正しく設定する必要があります。
例えば、キャラクターボイス「ダイスロール１」の元ファイルは「0_0.wav」という名前ですので、置き換え後のボイスファイルの名前も同様にします。
ファイルを保存するフォルダには、ボイスを置き換えたいキャラクターの名前を付けます。
システムボイスについても同様です。
ボイスファイルの推奨サンプリングレートは 44,100Hz です。

以下はディレクトリ構造の例です。
この例では、きゅーぴーのキャラクターボイス「ダイスロール１と４」と、システムボイス「100％おれんじじゅ～すっ！」と「ワープ」を置き換え対象に指定しています。

ディレクトリ構造サンプル

ボイスファイルの名前一覧は、後述の「キャラクターボイス ファイル名」セクションにあります。

髪色

髪色の置き換えには３つの方法があります。

• texture：自身で用意した画像ファイルを使っての置き換え。
• singlecolor：ベース、影、追加色を定義しての置き換え。
• gradient：ベース、セカンダリ、影、追加色を定義しての置き換え。

モジュールが扱えるパラメータは以下のとおりです。

アルファ(透明度)も定義できます。
You can also specify an alpha value for your color:
#ff000000 : ARGB (255, 0, 0, 0)
#000000 : RGB (0, 0, 0) (未定義の場合、アルファは常に255。)

自身で用意した画像ファイルに置き換える場合は、必須パラメータ以外の定義は不要です。
「ユニット画像・カード画像 」セクションで説明したように、元の画像ファイルと置き換える画像ファイルの名前を同一にし、所定のフォルダに保存してください。

例
hairs/sora_00_00：「ソラ」待機ポーズの髪色１を置き換え
hairs/sora_02_00_00 : 「ソラ」水着衣装待機ポーズの髪色１を置き換え

※公式には存在しない髪色も、ゲームが読み込める形式であれば定義することができます。

JSON サンプルコード

この方法は、ベースに指定した色を元に髪色を置き換えます。

JSON サンプルコード

この方法は、黒と白を元に髪色を置き換えます。
ベースの色が黒、セカンダリの色が白です。

JSON サンプルコード

方法２と３で使われる画像ファイルは、「アリシアンローネ」の場合は以下のようになります。

• hairs/alicianrone_b00_00 (ベースの色)
• hairs/alicianrone_h00_00 (髪のハイライト)
• hairs/alicianrone_m00_00 (グラデーション)
• hairs/alicianrone_s00_00 (影)

効果音

効果音を置き換える際は、定義ファイル内に「ModReplacements」という項目を追記し、その中に「sound_effects」と置き換える曲のファイル名を記載します。
置き換え後の効果音のファイルは全て「sound」という名前のフォルダに保存します。
このフォルダは、自身で作った MOD フォルダ直下に置きます。
効果音ファイルの推奨サンプリングレートは 44,100Hz です。

サンプルコード

上記のコードの場合、フォルダ構造は以下のようになります。

ディレクトリ構造サンプル

上記の例では、「選択をキャンセル」、「カードをゲット」、「何かを選択」した時に再生される効果音が置き換えられています。
どの効果音がどの場面で再生されるかは、「効果音ファイル名」セクションを参照してください。

カスタム言語

カスタム言語の配列では、「directories」という属性のみを使います。

必要なフォルダとファイルは、以下のような構造になるよう「mods」フォルダ内に配置してください。

複数の言語の翻訳を含めることができ、テクスチャやBGMの置き換えと組み合わせることができます。

上記の設定では、「french」フォルダ内にあるdefineファイルとフォントファイルの内容でゲーム内の言語が変更されます。
「languages」フォルダに既にカスタム言語ファイルがある場合は、それらのファイルを「mods」フォルダの所定の場所に移動させ、上記のJSONコードファイルをコピペし定義ファイルとして保存してください。
新規でカスタム言語を作成する場合は、以下のフォルダにテキストファイルの内容を確認してください。
100 Orange JuicelanguageCustomLanguages.txt

===============================

MOD プレビュー画像

MOD にはプレビュー画像を含めることができます。
MOD をワークショップへ投稿する場合は必須です。

プレビュー画像は、縦横比16:9の PNG 形式で作成し、自身で作成した MOD フォルダの直下に「preview.png」という名前で保存してください。
ゲームがプレビュー画像を検知すると自動的に読み込みます。

ワークショップへアップロードする場合は、サイズを 1 MB 未満にしてください。

MOD のワークショップへの投稿

MOD を Steam ワークショップへ投稿には以下の２つが必須です。

• JSON フォーマットで作成された MOD 定義ファイル。
• MOD の有効なプレビュー画像 (詳細は「MOD プレビュー画像」セクション)

上記を用意し、ゲーム内から「公開」ボタンを押すと MOD がワークショップへ投稿されます。

MOD の投稿(アップロード)中に問題があった場合は、エラーメッセージが表示されます。

投稿が正常に完了すると、投稿した MOD のワークショップアイテムページに接続され、他のユーザーも使用できるようになります。
なお、投稿した MOD の公開状態はデフォルトで「公開」となっています。

コンテストへの参加

自身で制作した MOD を公式コンテストへ出すには、定義ファイル内に他の必須のパラメータと併せて、以下のコードを記載してください。

応募にあたり、自身で作成した MOD フォルダに保存されたファイルを Steam へ送信する必要があります。
ファイルの送信は、「MOD のワークショップへの投稿」セクションで説明した手順で MOD を投稿すれば完了します。

なお、応募用ファイルが入ったフォルダには、フル解像度の画像も含めるようにしてください。
MOD としては読み込まれませんが、コンテストに必要です。

※開催中のコンテストがない場合や、応募締め切りが過ぎている場合は、コンテスト用ファイルの送信や更新はできません。
※コンテスト応募用の MOD も通常の MOD と同じように、ゲーム内プレビューを設定したり、他のユーザーがサブスクライブしたりできます。なお、コンテスト開催中は、ゲーム内バインダーにはプレイスホルダーカードが追加されます。

===============================

旧式 MOD 定義ファイル

MOD をゲームに読み込ませるには、まず mods フォルダ内に MOD を保存するフォルダを作成します。このフォルダの名前が、その MOD の名前となります。

次に、そのフォルダの中に mod.txt という定義ファイルを作成します。この定義ファイルの中身は以下のようにしてください。

書き方はローカライズの定義(define)ファイルと同様です。
文字コードは必ず UTF-8 にしてください。

各項目の詳細は以下の通りです。

以上全てを必ず記載してください。誤表記や抜けがある場合、MOD が正常に読み込まれない場合があります。

===============================

JSON エラー回避

定義ファイルである JSON ファイルに書かれたコードに誤りがあると、MOD が正常に読み込まれません。
下記のサイトでは、エラーになり得るコードがハイライトで表示されます。

アルファマスク

MOD 制作の効率化のため、どのファイルが何なのかが分かる一覧を用意しました。

ユニット ID

ユニット ID の一覧です。

キャラクターボイス ファイル名

キャラクターボイスのファイル名一覧です。
ファイル名は、「接頭番号＋アンダースコア＋バリエーション番号」で構成されています。
バリエーション番号は０から始まるのでご注意ください。

例として、「ワープ３」のファイル名は、ワープの接頭番号「10」＋アンダースコア＋バリエーション番号「2」を組み合わせた「10_2.wav」です。
別の例として、「ドロップマス４」のファイル名は、ドロップマスの接頭番号「21」＋アンダースコア＋バリエーション番号「3」を組み合わせた「21_3.wav」です。

「*」が付いた接頭番号は、バリエーションが１つしかないことを示しています。
そういったボイスを複数置き換える際は、接頭番号のみ変更し、バリエーション番号は全て「0」のままです。
例として、「特殊ボイス３」と「特殊ボイス４」のファイル名は、前者が「52_0.wav」、後者が「53_0.wav」です。

システムボイス ファイル名

システムボイスのファイル名一覧です。

衣装 ID

衣装 ID の一覧です。

効果音ファイル名

効果音ファイル名の一覧です。
MOD フォルダ内のサウンドフォルダに、置き換えたい効果音と同じファイル名にした効果音ファイルを入れてください。

===============================