開始説明イベント(スタートデスクイベント)マニュアル

## はじめに

開始説明イベントは、SSWのロード後に表示されるイベントです。

新聞風の見た目をしたイベントで、プレイする国家やSSWの世界観、SSWの新機能の解説やリリースノートなどを閲覧できます。

原案
--

現在最新版は2022/04/20最終更新の物です。

* 第二次リワーク案(Project:Reo-Chan)

旧バージョン

* 第一次リワーク※Draw.ioなどは現存しません
* 原案※存在しません

新しい開始説明イベント(以下SDE)はこれまでのものと比較して汎用性と整備性に優れています。

この章では、要素ごとに追加方法を示していきます。

## 国家説明写真

国家説明写真は1ページ目の左側に表示される画像です。

画像サイズは420\*600ですが、ゲーム内ではこれを0.95倍の大きさで表示しています。

国家ごとに表示画像を変更できるほか、陣営別などの条件で追加できます。ここでは、国家別の画像を追加する場合について書きます。

追加方法

1. 画像を用意し、gfx/interface/start\_description\_event/start\_description\_pictures/に配置します。ファイル名は「start\_description\_pictures\_TAG」が望ましいです。
2. VSdcodeなどから、interface/\_ssw\_start\_description\_event.gfxを開きます。
3. 検索機能を用いて「国家説明写真最後尾」と検索します。
4. 検索した部分の上に、以下のコードを追加し、必要個所([]で囲まれた部分)を変更します。
```
	spriteType = {#[国家名]
		name = "GFX\_start\_description\_pictures\_[国家タグ]"
		texturefile = "gfx/interface/start\_description\_event/start\_description\_pictures/start\_description\_pictures\_[国家タグ].png"
	}

```
5. インデントを整えるなどして保存してください。
6. common/scripted\_locarization/\_ssw\_start\_description\_event.txtを開いてください。
7. 「国家説明画像」と検索し、ヒットしたブロックの中(できれば国家タグのトリガーで管理しているtextの一番下)に以下のコードを追加し、必要個所([]で囲まれた部分)を変更します。
```
	text = {#[国家名]
		trigger = { tag = [国家タグ] }
		localization\_key = "GFX\_start\_description\_pictures\_[国家タグ]"
	}

```
8. インデントを整えるなどしてから保存してください。
9. おわり

## 国家説明

国家説明は当該国家に関する説明が書かれている部分です。

国家ごとに変更できるほか、陣営別などの条件で追加できます。ここでは、国家別に追加する場合について書きます。

追加方法

1. VSdcodeなどから、localisation/english/generic/\_ssw\_start\_description\_event\_l\_english.ymlを開いてください。
2. 「COUNTRY\_DESCRIPTION\_国家タグ」の並びのローカライズキーが並んでいる部分の一番下に、以下のコードを追加し、 必要個所([]で囲まれた部分)を変更します。
```
  COUNTRY\_DESCRIPTION\_[国家タグ]:0 "[説明]"

```
3. 保存します。
4. common/scripted\_locarization/\_ssw\_start\_description\_event.txtを開いてください。
5. 「国家説明」と検索し、ヒットしたブロックの中(できれば国家タグのトリガーで管理しているtextの一番下)に以下のコードを追加し、必要個所([]で囲まれた部分)を変更します。(国家説明画像ではなく国家画像です。)
```
	text = {#[国家名]
		trigger = { tag = [国家タグ] }
		localization\_key = "COUNTRY\_DESCRIPTION\_[国家タグ]"
	}

```
6. インデントを整えるなどしてから保存してください。
7. おわり

## ヘッダー

ヘッダーは国家説明の上部にある画像です。主に新聞のロゴを使うことが多いです。国家ごとに変更できるほか、陣営別などの条件で追加できます。ここでは、国家別に追加する場合について書きます。画像サイズは400\*60です。

追加方法

1. 画像を用意し、gfx/interface/start\_description\_event/sde\_title\_logo/に配置します。ファイル名は「sde\_title\_logo\_TAG」が望ましいです。
2. VSdcodeなどから、interface/\_ssw\_start\_description\_event.gfxを開きます。
3. 検索機能を用いて「ヘッダー最後尾」と検索します。
4. 検索した部分の上に、以下のコードを追加し、必要個所([]で囲まれた部分)を変更します。
```
	spriteType = {#[国家名]
		name = "GFX\_sde\_title\_logo\_[国家タグ]"
		texturefile = "gfx/interface/start\_description\_event/sde\_title\_logo/sde\_title\_logo\_[国家タグ].png"
	}

```
5. インデントを整えるなどして保存してください。
6. common/scripted\_locarization/\_ssw\_start\_description\_event.txtを開いてください。
7. 「新聞社の部分」と検索し、ヒットしたブロックの中(できれば国家タグのトリガーで管理しているtextの一番下)に以下のコードを追加し、必要個所([]で囲まれた部分)を変更します。
```
	text = {#[国家名]
		trigger = { tag = [国家タグ] }
		localization\_key = "GFX\_sde\_title\_logo\_[国家タグ]"
	}

```
8. インデントを整えるなどしてから保存してください。
9. おわり

前史
--

ただのローカライズです。何も言うことはないよ。

localisation/english/generic/\_ssw\_start\_description\_event\_l\_english.ymlに「WORLD\_DESCRIPTION\_TEXT」というキーで登録されていますので、編集してください。改行に注意してください。

## 各種機能

各種機能はSSW独自の機能や仕様について記述している部分です。

☆注意☆

各種機能の追加にはguiに関する知識が必要です。スーパーイベント程度のカスタムGUIを作成できる知識を持った状態で編集することを強く推奨します。

基本的に各種機能はgridboxtypeを用いて追加されています。一度に表示される数は3つまでですが、数を増やせば自動的にページ切り替えボタンを使えるようになります。追加する際に編集すべきguiはこのgridboxtypeに入るwindowだけです。windowの大きさは350\*540です。これ以上大きなものを作るとはみ出した部分は表示されないようになります。

追加方法(guiに関する知識がそれなりにある前提で記述しています。)

1. 最初に、GUIの設定を行います。interface/\_ssw\_start\_description\_event.guiを開いてください。
2. guiTypesのブロックでまとめると、#custum gridbox windowという注釈が見えます。その下部分が各種機能のgui windowです。
3. この下にwindowを作成します。以下はそのテンプレートですが、これ以外の配置や設定でも大丈夫です。
```
	containerWindowType = {#各種機能(ここに何の機能説明か書くこと！gridbox window
		name = "sde\_fanction\_desc\_[数字]"
		position = { x=0 y=0 }
		size = { width = 350 height = 540 }
		clipping = yes
		instantTextboxType = { #
			name = "sde\_function\_name"
			position = { x = 70 y = 10 }

			font = "ssw\_soukou\_36\_black"
			borderSize = {x = 0 y = 0 }
			text = "[タイトルのローカライズキー]"
			maxWidth = 210
			maxHeight = 70
			fixedsize = yes
			format = centre
		}

		instantTextboxType = {#説明本文
			name = "sde\_fanction\_desc"
			position = { x = 15 y = 54 }
			font = "hoi4\_typewriter16"
			text = "[説明本文のローカライズキー]"
			maxWidth = 310
			maxHeight = 300

			scrollbarType = standardtext\_slider
		}
		iconType = { #画像
			name = "sde\_function\_picture"
			position = { x = 40 y = 355 }
			spriteType = "[使用する画像のＧＦＸキー]"
			scale = 0.52
		}
		iconType = { ###横線１
			name = "sde\_line\_1"
			position = { x = 25 y = 50 }
			spriteType = "GFX\_sde\_horizontal\_300"
		}
		iconType = { #横線２
			name = "sde\_line\_2"
			position = { x = 25 y = 350 }
			spriteType = "GFX\_sde\_horizontal\_300"
		}
		iconType = { #縦線１
			name = "sde\_line\_3"
			position = { x = 0 y = 0 }
			spriteType = "GFX\_sde\_vertical\_610"
		}
		iconType = { #縦線２
			name = "sde\_line\_4"
			position = { x = 347 y = 0 }
			spriteType = "GFX\_sde\_vertical\_610"
		}

	}

```
4. なお、[数字]の部分は他の各種機能のwindowのiDに同じように記述してある数字の中で最も大きな数字よりも1つ大きい数字にしてください。またこの数字は後々使うので覚えておいてください。
5. 保存します。あとから見た目を整えればいいのでとりあえず[数字]の部分だけ変えて保存してください。
6. common/on\_actions/\_ssw\_on\_startup\_actions.txtに#スタートデスクイベント用のコマンドという項目があるので、その中の#機能の数という項目の数値を編集します。
7. 簡単に説明するとこれは各種機能にいくつの項目があるかを示す変数です。この数字をもとにgridboxtype用の配列(降順)が自動で生成されます。
8. 4の項目で使った数字よりも1大きい数(おそらくあなたが記入する前には[数字]と同じ数になっているはずなので。)に置き換えてください。
9. ほぞんして、おわり。
10. 起動して確認したのち、細かな設定を行ってください。

## リリースノート及び詳細

リリースノートはSSWのアップデート履歴のリストです。一度に7つまで表示されます。7つ以上追加した場合は古いものから順に見えなくなります。

☆注意☆

この項目は最低限scripted\_locarizationの知識を持った状態で行って下さい。また、guiの最低限の知識もあるとなおよいです。

リリースノートのリストと詳細欄はリンクする関係にあるので、ここでは2つを一度に設定する方法を書いています。

追加方法(moddingに関する一定の知識がある前提で書いています。)

localisation/english/generic/\_ssw\_start\_description\_event\_l\_english.ymlに以下ローカライズキーを設定しましょう。[数字]の部分は他より1大きい数です。

* Update\_log\_[数字]　・・・アップデートの名前(龍飛御天やthe Frozen Motherlandなど)
* Update\_log\_[数字]\_desc　・・・アップデートの具体的な変更ログなどの詳細
* Update\_log\_[数字]\_date　・・・アップデートの日時(YYYY/MM/DDで記入してください)
* Update\_log\_[数字]\_version　・・・アップデートのversion番号

これらの項目を設定し終えたら、保存してください。

次に、common/scripted\_locarization/\_ssw\_start\_description\_event.txtを開いて、以下の注釈がある部分にそれぞれ新しい条件を追加してください。

* アプデのタイトル(キーはupdate\_log\_title)　　→Update\_log\_[数字]
* アプデのversion(キーはupdate\_log\_version)　　→Update\_log\_[数字]\_version
* アプデの詳細(キーはupdate\_log\_detail)　　→Update\_log\_[数字]\_desc

上記3つは条件の「update\_detail = [数字]」の数字の部分を変更して追加してください

* アプデのタイトル　リスト用のタイトル(キーはupdate\_log\_title\_list)
* アプデのversion　リスト用のタイトル(キーはupdate\_log\_version\_list)
* アプデのversion　リスト用の日付(キーはupdate\_log\_date\_list)

上記3つは条件の「v = [数字]」の数字の部分を変更して(1大きくして)追加してください

このvというのはgridboxtypeのindexに割り当てられる一時変数です。

全て記入したら保存して閉じてください。

次にcommon/on\_actions/\_ssw\_on\_startup\_actions.txtに#スタートデスクイベント用のコマンドという項目があるので、その中の#アップデートの履歴数という項目の数値を編集します。

簡単に説明するとこれはリリースノートにいくつの項目があるかを示す変数です。この数字をもとにgridboxtype用の配列(降順)が自動で生成されます。

先ほどの[数字]よりも1大きい数(おそらくあなたが記入する前には[数字]と同じ数になっているはずなので。)に置き換えてください。

ほぞんして,起動して確認しておわり

簡単だね。(実際GUIの知識無くてもできるので簡単です。)

## 提携MODリスト

提携MODリストは提携MODのアイコンのリストです。カーソルを合わせるとMOD名と詳細が見れます。一度に6つまで表示されますが、ページ切り替えが可能です。

☆注意☆

この項目は最低限scripted\_locarizationの知識を持った状態で行って下さい。また、guiの最低限の知識もあるとなおよいです。

追加方法

localisation/english/generic/\_ssw\_start\_description\_event\_l\_english.ymlに以下ローカライズキーを設定しましょう。[数字]の部分は他より1大きい数(表示しているMODと同じ数になるはず)です。(もしかすると、emptyという中身ですでにキーだけ登録してあるかもしれません。)

* partner\_mod\_[数字]　・・・追加したいMODの名前
* partner\_mod\_[数字]\_desc　・・・追加したいMODの説明(なければ名前でいいかも

以上を設定した後、保存してください。

次に、MODの画像を登録します。200\*200の大きさでgfx/interface/start\_description\_event/partner\_mods/に配置してください。

ファイル名は「sde\_[MOD名]」が望ましいです。

次に、common/scripted\_locarization/\_ssw\_start\_description\_event.txtを開いて、以下の注釈がある部分にそれぞれ新しい条件を追加してください。

* 提携MODアイコン(sde\_partner\_icon)
* 提携MOD(partner\_mod)
* 提携MODdesc(partner\_mod\_desc)

基本的にcheck\_variable = { v = [数字] }とpartner\_mod\_[数字]～の部分の[数字]部分を一番大きな数にすればいいです。条件の並び順は昇順なので下の方に書いてください。

提携MODアイコン(sde\_partner\_icon)　のところは登録したMODアイコンのGFXキーが出るようにしてください。

次にcommon/on\_actions/\_ssw\_on\_startup\_actions.txtに#スタートデスクイベント用のコマンドという項目があるので、その中の#提携MODの数という項目の数値を編集します。

簡単に説明するとこれは提携MODがいくつあるかを示す変数です。この数字をもとにgridboxtype用の配列(昇順)が自動で生成されます。

先ほどの[数字]よりも1大きい数(おそらくあなたが記入する前には[数字]と同じ数になっているはずなので。)に置き換えてください。

保存して、起動して確認したら完了です。

## メンバーリスト/協力メンバーリスト

ただのローカライズです。何も言うことはないよ。

localisation/english/generic/\_ssw\_start\_description\_event\_l\_english.ymlにメンバーリストは「MOD\_MENBER\_LIST」、協力メンバーリストは「contributor\_list」というキーで登録されていますので、編集してください。改行に注意してください。