MOD作成ガイド

MODの作成に関する情報。

情報源

• 公式wiki (英語)：
  Moddingのページで、詳しく説明されています。
  
  
• Steamガイド：
  Steamのガイドに、MODの作成方法に関する記事が複数あります。

  タイトルとリンク	作者 (敬称略)	備考
  ワークショップのMODを自分仕様に改造しよう	M_Gamelin	MOD作成の基礎を解説
  [JP]イベントmod作成入門~基礎構文編	NaK1119
  [JP]イベントmod作成入門~イベント呼出編(WIP)	NaK1119
  [JP]艦船MODの基礎	COLA
  Stellarisに静止画ポートレートを追加しよう	M_Gamelin
  StellarisでポートレイトMODを作ろう！	Rio_Mizuhoshi	3.8対応

  
  
• ゲーム内マニュアル：
  コンソールコマンドのtrigger_docsを実行すると、マニュアルがファイルに出力されます。

MODツール

MODツールを使うと、MODの作成に関する操作を行えます。

• 起動方法：
  MODツールを起動するには、ランチャーの「インストール済みのすべてのMOD」画面右上にある「MODをアップロードする」ボタンを押します。
  紛らわしい名前をしていますが「MODをアップロードする」を押したからといってアップロードが始まるわけではなく、アップロードはMODツール内の一機能でしかありません。

• MODツールの機能：
  MODツール画面右上の「MODを作成する」ボタンを押すと、新規にMODを作成するのに必要なファイルを生成できます。
  「MODをアップロードする」ボタンを押すと、作成したMODをSteam WorkshopやParadox Modsにアップロードできます。

「MODを作成する」機能

名称：MODの名前。
バージョン：MODのバージョン (対応するゲーム本体のバージョンではなく、MODそのもののバージョン)。
ディレクトリ：MODのフォルダ名。
タグ：MODのカテゴリ。
必要な情報入力して右下の「MODを作成する」ボタンを押すと、指定したフォルダに基本的なファイルが作成されます。

フォルダ構成

「MODを作成する」機能を使ってMOD名とフォルダ名に「test1」と指定したMODを作成すると、下記のようにフォルダとファイルが作成されます。

C:\Users\<ユーザー名>\Documents\Paradox Interactive\Stellaris\mod\
├ test1.mod
└ test1\
　└descriptor.mod

.modファイルの中身

上記で作成した.modファイルの中身は下記のようになります。
picture行は存在しないので手動で追加します。thumbnail.png(名前は固定) は、steamワークショップ上やランチャー上でのサムネイルになります。
descriptor.modも同様に修正します。

version="1.0.0"
tags={
	"Economy"
}
name="test1"
picture="thumbnail.png"
supported_version="2.8.1"
path="<MODファイルの場所>"

目的別の作成方法

国旗を追加する

国旗の画像は Stellaris/flags 以下に格納されています。
flags以下にあるフォルダは国旗のカテゴリです。
mapフォルダにはギャラクシーマップで表示される白単色の国旗が格納されています。
smallフォルダには外交画面のアイコン等で使用される縮小版の国旗が格納されています。

※背景は透過させDDS形式で保存してください。


PhotoshopでDDS形式を扱うには、プラグインを導入する必要があります。(プラグインの検索)
GIMPは、プラグインなしでDDS形式を扱えます。

usage.txtの作成

国旗の画像と一緒に以下の内容を記述した.txtファイルを「usage」という名前で保存してください。

ポートレイトを追加する

ファイル構成:
Modフォルダ内

• common
  • species_classes
    • <任意の半角文字列>.txt(ポートレイトのカテゴリなどの設定)
• gfx
  • <任意の半角文字列>
    • dds形式の画像たち
      ※背景は透過させDDS形式で保存してください。
  • portraits
    • <任意の半角文字列>.txt(ポートレイトの設定)
• localisation
  • お決まりの.yml言語ファイル

全て文字コードはUTF-8で保存しlocalisationだけBOMありそれ以外はなしで保存してください

サンプルはstellarisアップローダーにあったきのたけMod。

ポートレイトのカテゴリ設定

サンプル:

KTW = {
	portraits = {
		"kinoko"
		"takenoko
        }
	non_randomized_portraits = {
		"kinoko"
		"takenoko"
	}

	graphical_culture = kinotake
	move_pop_sound_effect = "moving_pop_confirmation"
}

解説

<種族カテゴリ(哺乳類など)※1> = {
	portraits = {
		<そのカテゴリに属するポートレイトを"でくくって書く>
        }
	non_randomized_portraits = {
		<ランダム選択時に使用しないポートレイトを"でくくって書く>
	}

	graphical_culture = <都市外観や艦船外観など>
	move_pop_sound_effect = <popを動かしたときの音>
}

※1正確にはキーであり後から.ymlで名称をつけてやる必要がある

ポートレイトと画像のリンク

character = {
	size = { x = 600 y = 380 }

	entity = {
		orientation = center_down
		position = { x = 0 y = -20 }
		scale = 24
	}
	icon = {
		orientation = center_down
		position = { x = 0 y = 0 }
		scale = 1.0
	}
}

character = {
	size = { x = <X方向のサイズ> y = <Y方向のサイズ }

	entity = { #エントリー。つまり外交画面のどこに表示されるか。
		orientation = #表示位置
		position = { x = 0 y = -20 }#座標
		scale = 24
	}
	icon = {#アイコン。つまり帝国作成時のどこに表示されるか。
		orientation = #表示位置
		position = { x = 0 y = 0 }#座標
		scale = 1.0
	}
}

portraits = {
	kinoko_01 = {
		texturefile = "gfx/KinokoTakenoko/Kinoko_01.dds"
		greeting_sound = "plantoid_01_greetings"
	}
	kinoko_02 = {
		texturefile = "gfx/KinokoTakenoko/Kinoko_02.dds"
		greeting_sound = "plantoid_01_greetings"
	}
省略
                greeting_sound = "plantoid_01_greetings"
        }
}

portraits = {
	<任意の半角文字列> = {
		texturefile = <画像のディレクトリ>
		greeting_sound = <外交画面を開いた時のサウンド>
	}
	<任意の半角文字列> = {
		texturefile = <画像のディレクトリ>
		greeting_sound = <外交画面を開いた時のサウンド>
	}
省略
                greeting_sound = <外交画面を開いた時のサウンド>
        }
}

portrait_groups = {
	kinoko = {
		default = kinoko_01
		game_setup = {
			add = {
				trigger = {
					ruler = { gender = male }
				}
				portraits = {
				kinoko_01
				kinoko_02
				kinoko_04
				}
			}
			add = {
				trigger = {
					ruler = { gender = female }
				}
				portraits = {
					kinoko_03
				}
			}

		#species scope
		species = { #generic portrait for a species
			add = {
				portraits = {
					kinoko_01
				}
			}
		}

		#pop scope
		pop_group = { #for a specific pop
			add = {
				trigger = { owner = { is_primitive = no } }
				portraits = {
					kinoko_02
					kinoko_03
				}
			}
			add = {
				trigger = { owner = { is_primitive = yes } }
				portraits = {
					kinoko_04
				}
			}
		}

		#leader scope
		leader = { #scientists, generals, admirals, governor
			add = {
				trigger = {
					gender = female
				}
				portraits = {
					kinoko_03
				}
			}
			add = {
				trigger = {
					gender = male
				}
				portraits = {
				kinoko_01
				kinoko_02
				kinoko_04
				}
			}
		}

		#leader scope
		ruler = {
			add = {
				trigger = {
					gender = female
				}
				portraits = {
				kinoko_03
				}
			}
			add = {
				trigger = {
					gender = male
				}
				portraits = {
				kinoko_01
				kinoko_02
				kinoko_04
				}
			}
		}
	}
}
}

portrait_groups = {
	kinoko = {
		default = <デフォルトの2で設定したキー>
		game_setup = {
			add = {
				trigger = {
					ruler = { gender = <性別> }
				}
				portraits = {
                                <その性別のポートレイトの2で設定したキー>
				}
			}
			add = {
				trigger = {
					ruler = { gender = <性別> }
				}
				portraits = {
				<その性別のポートレイトの2で設定したキー>
				}
			}

		#species scope
		species = { #generic portrait for a species
			add = {
				portraits = {
				<アイコンのポートレイトの2で設定したキー>
				}
			}
		}

		#pop scope
		pop_group = { #for a specific pop ※3.14までは"pop = {"だった
			add = {
				trigger = { owner = { is_primitive = no } }
				portraits = {
					kinoko_02
					kinoko_03
				}
			}
			add = {
				trigger = { owner = { is_primitive = yes } }
				portraits = {
					kinoko_04
				}
			}
		}

		#leader scope
		leader = { #scientists, generals, admirals, governor
			add = {
				trigger = {
					gender = <性別>
				}
				portraits = {
			        <その性別のポートレイトの2で設定したキー>
				}
			}
			add = {
				trigger = {
					gender = <性別>
				}
				portraits = {
				<その性別のポートレイトの2で設定したキー>
				}
			}
		}

		#leader scope
		ruler = {
			add = {
				trigger = {
					gender = <性別>
				}
				portraits = {
				<その性別のポートレイトの2で設定したキー>
				}
			}
			add = {
				trigger = {
					gender = <性別>
				}
				portraits = {
			　    <その性別のポートレイトの2で設定したキー>
				}
			}
		}
	}
}
}

艦船を追加する

艦船のモデルは Stellaris/gfx/models/ships 以下に格納されています。
モデルファイルは.meshです。AutodeskのMayaにParadoxが提供している専用プラグインを追加する事で作成できます。
詳細：https://stellaris.paradoxwikis.com/Maya_exporter

ファイル構成一覧表

Stellaris/common/

Stellaris/events/

Stellaris/flags/

Stellaris/fonts/

Stellaris/gfx/

Stellaris/interface/

ウィンドウを定義する。

Stellaris/localisation/

ファイル名は必ず「○○_l_言語.yml」にする必要がある
英語ならば「○○_l_english.yml」となる
当然○○の部分は自分のmodにふさわしい名前に置き換えること

日本語化について

日本語(と韓国語)ロケールがver.3.4で追加された
それ以前のバージョン用に作成されたModは
各ファイルの先頭行及びファイルの「l_言語」部を「l_japanese」にしたり
フォルダがあれば「japanese」に変更しない場合日本語環境ではローカライズ用の識別キーが表示されるだけになる
最新バージョンに対応し更新が続いていてもローカライゼーションに無頓着な作者のModの場合も同様

Stellaris/map/

Stellaris/music/

Stellaris/prescripted_countries/

Stellaris/sound/

MODの作成に役立つツールとWebサービス

• Optimizer Textures (Ordenador)
  テクスチャ最適化ソフト。適切に使用すればわずかな画質の劣化と引き換えにパフォーマンスの向上が期待出来る。
  本来はSkyrim用に開発されたものだが、テクスチャを使用するあらゆるゲームで使用可能。
  高精細なテクスチャを使用しているMODに手を出したいがスペックに不安のある人などに役立つが、Stellarisではあまり効果を実感出来ないかもしれない。
  使用方法はSkyrim Mod データベース - Optimizer Textures (Ordenador)のコメント欄78や104辺りを参考に。
  
  
• PNG DDS 変換
  画像ファイルの形式をPNGからDDSに変換する、Webサービス。
  自作のロードスクリーンを作るのに役立つ。
  ロードスクリーンの作成方法

  フォーマットはDXT1で良いと思われる。画像の大きさはバニラのものは1920*1080。
  ロードスクリーンはStellaris本体フォルダ直下gfx>loadingscreensフォルダにバニラのファイルがあるので、変換したDDSファイルを同様の命名形式にして放り込むだけで良い。
  わかる人は直接放り込まずMOD形式にしても良く、その場合は該当箇所にloadingscreensフォルダを作成するだけで特にスクリプトを記述する必要はない。
  最大何枚まで認識してくれるかは不明だが少なくとも1500枚ほど(load_1500)放り込んでも問題なく表示してくれていると思われる。

  
  
• サクラエディタ
  多機能テキストエディタの一つ。
  各種ファイルはWindowsのメモ帳でも開けるが、改行コードや文字コードを扱ったり特定キーワードによるディレクトリ内の一括検索をできたりする。
  
  
• Visual Studio Code
  多機能テキストエディタの一つで、更に膨大な拡張機能を持つ。(参考：インストールと日本語化の手順)
  Stellaris用の「CWTools」という拡張機能もある（詳細は、英語だがこちらを参照）。
  拡張機能を使わないなら、逆にオーバースペックかもしれない。
  
  
• WinMerge 日本語版
  ファイルやディレクトリを比較して差分を表示する。他modに依存するmod（日本語パッチなど）の更新に便利（親modのどこがどう変わったか、一目瞭然）。
  
  
• Irony Mod Manager
  Stellarisを中心に扱う（パラドックスの他ゲームにも対応予定）modマネージャー。
  複数modの競合を具体的に表示したり自動や手動で解決したりできる。
  2020年10月末にはStellaris本体でmod数が多いと起動途中で止まってしまうランチャーの不具合が発生していた（11月上旬にはランチャー改修により解決した）ため、それへの対応（mod量は不問なので中身を統合すれば回避可能）に役立った。
  
  
• git for windows
  ファイルやディレクトリのバージョン管理を行う（行き詰ったときに、一部や全部を「以前の特定バージョン」に戻したりもできる）ソフト。
  ただしコマンドの扱いが難しいので、初心者向きではない。

名称リストの作成

• Stellaris name list maker
  Name listの編集を支援するために作成されたソフト。
  オリジナルのName listの作成に役立つ。
  
  
• それっぽい名前ジェネレータ
  ランダムにカタカナ名を20個生成出来る。
  英語男性風、フランス女性風などのパターンが複数用意されている。
  ただ仕様上五文字以上が多くなるようなのでバラエティには多少欠けるか。
  
  
• 名前メーカー　カタカナ
  ランダムにカタカナのフルネーム／名前／名字を男女別に最大50個までまとめて生成出来る。
  それとは別にオリジナル帝国を作る際には同サイトの以下も役立つ。
  架空国名メーカー
  
  
• カタカナ名前生成
  ランダムにカタカナ名を20個生成出来る。
  濁音半濁音の使用の有無などを設定出来るため、ある程度統一性を持たせた名前を生成しやすい。
  設定できる箇所以外は完全にランダムのようなので植物種など人類種から離れた種族に特に向いているかもしれない。
  
  
• すごい名前生成器
  ランダムに日本語の氏名を60個作成できる。
  日本風ネームリストの作成に役立つ。

コメント