「Mod」を編集中

{{Version|timeless}}
{{#evt:
| service= youtube
| id= uu_Zxf4ul2g
| description= CK3 Mod#1 -Modの簡単な紹介。 ''Roll1D2 Games''による便利なツールの案内とハウツーModビギナーズガイド
| alignment= right
| container=frame
}}
Mod、またはModを作成することは、個人的な使用のために、または[https://mods.paradoxplaza.com/games/ck3 Paradox Mods]または[https://steamcommunity.com/app/1158310/workshop/ Steam Workshop]を介して他のプレーヤーに公開するために、ゲームのアセットまたは動作を変更する行為のことです。

Paradoxの他のゲームと同様、Crusader Kings IIIもかなり改造可能です。Modderの動機は大きく異なることでしょう。母国語へのより良い翻訳、より多くのイベントやディシジョン、より良い地図、大規模な見直し、チートの追加などなど。

このガイドは、Crusader Kings IIIのModの世界への参入障壁を低くすることを目的としています。しかし、まだ習得には時間がかかり、バニラのコードを読んで試行錯誤を繰り返す必要があります。

'''重要なこと'''：ほとんどのMODではチェックサムが変更され、プレイヤーは実績を獲得できなくなります。チェックサムに影響するフォルダとファイルのリストについては、ゲームフォルダのchecksum_manifest.txtを参照してください。安全なModは、テクスチャ、シェーダー、フォント、音楽を置き換えるものだけです。<ref>訳者注：日本語化Modはlocalizationフォルダを置き換えているために実績達成が不可能になっています。</ref>

== 助言とガイドライン==
* '''変更のためのModを作成する'''。小さな変更にも個人用Modを使用し、CK3ゲームフォルダ内のゲームファイルは警告なしに上書きされる可能性があるため、直接変更しないでください。<ref>訳者注：Steamの場合、ゲームがアップデートされてもCK3ゲームフォルダ内の変更したファイルはそのまま残ります。ただし整合性の確認を実施すると全てのファイルがもとに戻ります。</ref>
* '''適切なテキストエディタ'''を使用して、ファイルを編集し、フォルダを検索します。以下は無料です。
** [https://code.visualstudio.com/ Visual Studio Code]. Paradox構文のハイライト、バリデーション、およびトリガと効果のツールチップを備えた有志のCWTools拡張を使うことができます。インストールするには、VSの左パネルにあるExtensionsに行き、CWToolsを検索してください。(注意:検証ルールは不完全であり、GUIおよびローカライズ・ファイルに多くの誤ったエラーが表示されます。)
** [https://notepad-plus-plus.org/downloads/ Notepad++]。Perlを言語として選択すると、強調表示が適切に行われ、コードやコメントのブロックを折り畳めるようになります。デフォルトに設定するには、「Settings」、「Styler Configurator」の左側のリストでPerlを探し、下部の"User ext."フィールドに"gui txt" (ダブルクオーテーションは不要です) を追加します。
** [https://atom.io/ Atom]。 ローカライズファイルの編集に必要なUTF-8-BOMエンコーディングの機能は含まれません。それが必要ない場合は、非常にカスタマイズ可能です。よりよい結果を得るには、言語設定で「Perl6」を使用します。デフォルトに設定するには、File、Configに移動し、「core:」を探し、その下に次のように追加します。 "customFileTypes: "source.perl6": [ "txt" "gui"]"。[https://discuss.atom.io/t/how-do-i-make-atom-recognize-a-file-with-extension-x-as-language-y/26539 ここに例があります]。
** [https://www.sublimetext.com/ Sublime Text]。Imperatorの開発者がリリースしたCK3: [https://forum.paradoxplaza.com/forum/index.php?threads/sublime-tools-for-imperator.1274246/ Sublime Tools]拡張機能が使えます。エフェクトとトリガーのカラーハイライトが追加されます。Sublimeでコメントを切り替える場合は、[https://cdn.discordapp.com/attachments/563655919892692996/649656191173263370/PDXComments.tmPreference このファイル]を同じ「User」フォルダに追加する必要があります。
* '''error.logファイルで実行エラーを常に確認してください。'''<nowiki>...\Documents\Paradox Interactive\Crusader Kings III\logs</nowiki>にあります。
* '''ログフォルダには、エフェクト、トリガ、およびスコープの一覧も含まれます。'''ゲーム内で「script_docs」および「DumpDataTypes」コンソールコマンドを使用して生成します。
* 「reload gui」、「reload gfx」コマンドを使用するには、'''「-debug_mode -develop」起動オプションを指定して'''ゲームを開始します。
** Steamの場合:Steamでゲームを右クリック→プロパティ→起動オプション→<code>-debug_mode -develop</code>を追加する
** Windowsの場合、.exeファイルのショートカットを作成し、右クリックして 「プロパティ」 を選択し、「 -debug_mode」 を 「リンク先」の欄の最後に追加する
* '''LinuxのCK3フォルダのディレクトリは'''<nowiki>~/.local/share/Paradox Interactive/Crusader Kings III</nowiki>です。
* '''Modに関する重要な事実を明確かつ簡潔に伝える'''
**あなたのModの説明は、あなたのModがゲームに何を追加したり変更したりするかについての短いが明確な説明で'''始まる'''必要があります。変更履歴や、注意事項や前提条件、インストール手順などの長いリストから始めないでください。
*説明を読んでいる人がこのModについて以前に聞いたことがあると思ってはいけません(もしそうであれば、一般的には説明を読みません)。
**あなたのModが鉄人モード(Ironman)互換であるかどうかを明確かつひと目で分かるように述べます。(あなたには明白に思えたとしても！)
* Steamバージョンをサブスクライブする場合は、ローカルModを削除してください。削除しないと、ゲームで動作しない場合があります。
* 作業内容をバックアップします。手動で、あるいはGitのようなソース管理システムを使って！GitHubをチームコラボレーションに使うことも検討してください。
* ([https://winmerge.org/?lang=en WinMerge]のような)適切なマージツールを使用してフォルダ間をマージし、修正されたファイルを新しいパッチ用に更新します。
* 数十行または数百行のコードでテキストを置換する場合は、正規表現を使用できます。これらは、上記のすべてのテキストエディタで使用できます。教材:[https://regexone.com/ RegexOne]、[https://regexr.com/ RegExr]。

=== ローカライズファイル ===
* localizationフォルダにある*.yml<ref>訳者注：アスタリスク（*）は任意の長さの文字列を意味します</ref>ファイルはゲームで正しく読み込まれるようにするために'''BOM付きUTF-8'''<ref>訳者注：ほとんどのテキストエディタはUTF-8と書いてある場合はBOM'''なし'''を意味します。BOM付きを保存できるエディタを用意してください。</ref>でエンコードされて保存されている必要があります。
* ゲームでファイルを正しく読み込むには、ファイル名を'''*l_<language>.yml'''の形式で保存する必要があります。例：'''council_l_english.yml'''。
** "localization"とアメリカ英語のスペルを使用する必要があります。イギリス英語の"localisation"というスペルにすると動作しません。
** 既存のローカライズ値を上書きするには、変更を加えたファイルをlocalization フォルダ内の「replace」という名前のフォルダに置きます。<ref>訳者注：実例が日本語化MODのgithub repositoryにあるので参考にしてみてください。: https://github.com/matanki-saito/Ck3JpMod</ref>

== Modの作成 ==
{{main|Mod structure#Creating initial files}}
Modの初期ファイル郡を作成するには、ゲームランチャーを使用することをお勧めします。

==Modのアップロード/アップデート==
Modをアップロードしたりアップデートしましょう。

#ランチャーを開きます
#「MOD」セクションを開きます。
#「MODツール」を押して、自分のmodをドロップダウンメニューから選びます。
# それをどのプラットフォームにアップロードするかを選びます。
# 説明を書きます<ref>訳者注：Steam上であとから追加できるのと日本語用の説明は書けないため、ここでは丁寧に書かないほうがおすすめです。</ref>
# 説明を確定します。 (更新する場合は、ランチャーがサイトから最新のものをコピーしたことを確認してください。)
# サムネイルを追加します。
## Steam Workshopの場合、modフォルダにthumbnail.pngを入れます。1:1の比率で最大1MBを使用します。Workshopで表示される最大のサムネイルは、約600x600ピクセルです。
##Paradox Modsの場合は、説明の下のフィールドにサムネイルをドラッグします。推奨最小サイズは900x500、pngまたはjpg、最大1MBです。
# 「アップロード」ボタンを押します。
## Steamの場合、プライベートモードでアップロードされ、 自分のSteamプロファイル→ワークショップアイテムに表示されます。これを開いて、サイドバーの表示を「公開」に変更すると、実際に公開されます。<ref>訳者注：SteamのModにアップロードするには場合によってはSteam Workshopへの規約同意が必要です。またゲームをシェアしているなどで、所有していない場合はアップロードできません。さらにそのアカウントに一度も入金がなかったり、スチームガードを無効化している場合などはSteam上で利用制限アカウントとなり、アップロードできません。詳細な条件についてはこちらを参照ください。 https://support.steampowered.com/kb_article.php?ref=1047-edfm-2932&l=japanese</ref>
## Paradox Modsでは、検証プロセスの後にModが公開されます。サイトでは通常、改行とBBCodeのフォーマット<ref>訳者注：BBCode(掲示板のコード)のことです</ref>が削除されるため、説明を編集する必要があります。

== セーブデータの編集 ==
セーブファイルはここにあります。
* Windows： Documents\Paradox Interactive\Crusader Kings III\save games
* Linux： ~/.local/share/Paradox Interactive/Crusader Kings III/save games

'''鉄人モードのセーブは編集できません'''

まずゲームをデバッグモードで起動し、保存します。

* スチームの場合: Steam上でゲームを右クリック → プロパティ→ 起動オプション → -debug_mode 追加
* Windows：.exeのショートカットを作成-> それを右クリック → プロパティ→ リンク先に<code> -debug_mode</code>を最後に追加する

PC:
# セーブファイルをゲームフォルダから見つける。
# セーブファイルを右クリックして7-ZipやWinRarなどのアーカイバーで展開する
# 抽出された'gamestate'ファイルの拡張子を.ck3になんとかして変更する
# 右クリックして、テキストエディタ(セーブファイルが非常に大きいため、Windowsのメモ帳はお勧めしません。)で開く
# そのファイルを編集して保存
# そのファイルをゲームで読み込む

オートセーブは、gamestateを抽出せずに直接編集できます。

Mac:
# 端末を開く
# ディレクトリが正しいフォルダに設定されていることを確認
# "unzip FileName.ck3"と打ち込む
# 抽出された'gamestate'の拡張子をなんとかして.ck3 extensionに変える
# プレーンテキストをのセーブを編集
# そのディレクトリをゲームで読み込む（再圧縮は不要）

{| class="wikitable"
! OS !! セーブタイプ !! 保存場所                       
|-
| Windows || Local || <code>C:\Users\%USERPROFILE%\Documents\Paradox Interactive\Crusader Kings III\save games</code>
|-
| Windows || Steam Cloud || <code>C:\Program Files (x86)\Steam\userdata\####\1158310\remote\save games</code>
|-
| Mac || Local || <code>$HOME/Documents/Paradox Interactive/Crusader Kings III/save games</code>
|-
| Linux || Local || <code>$HOME/.local/share/Paradox Interactive/Crusader Kings III/save games</code>
|}

=== gamestateファイルの内容 ===
次の表に、gamestateファイルで使用可能な第1レベルのブロックを示します。エントリは、表示順に表示されます。

{| class="wikitable"
! ブロック
! 説明
|-
| meta_data
| Contains metadata about the game, such as the game version. Used by the main menu screen.
|-
| ironman_manager
| Related to ironman saving.
|-
| (various variables)
| These variables do not belong in a block.
{| class="wikitable"
! Variable
|-
| date
|-
| bookmark_date
|-
| first_start
|-
| speed
|-
| random_seed
|-
| random_count
|}
|-
| variables
| Contains script flags.
|-
| game_rules
| Contains the save's current game rules.
|-
| provinces
| Contains province data, including buildings.
|-
| landed_titles
| 以下のサブブロックを含みます
{| class="wikitable"
! サブブロック
! 説明
|-
| dynamic_templates
|
|-
| landed_titles<br>''(repetition)''
| Contains an entry for each landed title in the game, in the format:
<pre>
# Exact formatting in file is different in terms of spaces and lines
# It is usually more compact.
# It has been edited here for clarity and demonstration.


# Index for titles starts at 0
index={
	key="(title id)" # The one used in 00_landed_titles.txt, e.g. k_england

	de_facto_liege=(title index) # Optional
	de_jure_liege=(title index) # Optional. The number at the start of a similar block, NOT the title id
	de_jure_vassals={ (title index...) } # Optional, list of title indices.
	holder="(character id)" # Optional

	name="..."
	adj="..." # Optional
	pre="..." # Optional
	article="..." # Optional

	date=2020.10.27 # yyyy.mm.dd
	heir={ (character id...) } # Optional. List of character ids.
	claim={ (character id...) } # Optional
	history = { (...) } # Optional 
	capital=(province id)
	capital_barony=yes # Optional
	theocratic_lease=yes # Optional
	history_government="(government id)" # Optional
	laws={ "(law id)"... } # Optional. List of law ids.

	# Optional (succession_election).
	succession_election={
		electors = {  (character id...) }
		candidates={ (character id...) }
		nominations={
			{
				elector=(character id)
				candidate=(character id)
				strength=(value)
			}
		
		}
	} # end of succession_election block

	coat_of_arms_id=(coat of arms id)
	localization_key="(localization key)" # Optional

	# All below is used for mercenary bands
	special={
		type=mc
		identity=(id)
	}
	color=rgb { (r) (g) (b) }
	landless=yes
	destroy_if_invalid_heir=yes
	no_automatic_claims=yes
	definite_form=yes
}
</pre>
In vanilla CK3, this block ends at entry ~12369.
|-
| index=(value)<br>「(変数)」
|
|}
|-
| dynasties
| Contains the following sub-blocks:
* dynasty_house (ends at entry ~6401)
* dynasties (ends at entry ~6239)
* static_dynasties (list of numbers)
* static_dynasty_houses (list of numbers)
|-
| deleted_characters
|
|-
| living
| Contains entries of living characters. The following format is used for each character:
<pre>
index={
	first_name="..."
	birth=(date)
	female=yes # Optional
	culture=(culture index)
	faith=(faith index)
	dynasty_house=(dynasty house index) # Optional
	skill={ (diplomacy) (stewardship) (martial) (intrigue) (learning) (prowess) } # One value for each skill
	sexuality=(sexuality id) # Optional
	dna="(dna string)" # Optional
	mass=(value) # Optional
	traits={ (trait index...) } # List of trait indices
	inactive_traits = { (trait index...) } # Optional. List of trait indices
	
	# Optional (family_data)
	family_data={
		primary_spouse=(character id)
		spouse=(character id)
		child = { (character id...) } # List of character ids
	}

	alive_data={

		# Optional (variables), contains flags
		variables={
			data={
				# (...)
			}
		}

		gold=(value) # Optional
		income=(value) # Optional
		location=(landed title index) # Optional
		fertility=(value)
		health=(value)
		piety={
			currency=(value)
			accumulated=(value) # Optional
		}
		prestige={
			currency=(value)
			accumulated=(value) # Optional
		}
		weight_update=(value)
	} # End of alive_data block

	court_data={
		# All keys within this block are optional
		employer=(character id)
		council_task=(council task index)
		regiment=(regiment index)
		knight=yes
	}

	# Optional (landed_data)
	landed_data={
		domain={ (landed title index...) } # List of landed title indices
		vassal_contracts={ (values) } # List of values
		became_ruler_date=(date)
		laws={ "(law id)"... } # List of law ids
		strength=(value)
		balance=(value)
		succession={ (character id...) } # List of character ids
		domain_limit=(value)
		vassal_limit=(value)
		vassals_towards_limit=(value)
		government="(government id)"
		realm_capital=(value
		ai_allowed_to_marry=yes
		council={ (value...) } # List of values
		at_peace_penalty=(value)
		diplo_centers={ (value...) } # List of values
		election_titles={ (landed title index...) } # List of landed title indices
	} # End of landed_data block

	# Optional (playable_data)
	playable_data={
		knights={ (character id...) } # List of character ids
		was_player=yes
	}

}

</pre>
|-
| dead_unprunable
| Contains character entries.
|-
| characters
| Contains the following sub-blocks:
* dead_prunable (contains character entries)
* prune_queue
* dummy_female (contains a character entry)
* dummy_male (contains a character entry)
* unborn (contains unborn data entries)
* natural_deaths
* current_natural_death
* sexuality_chances
|-
| character_lookup
|
|-
| units
|
|-
| activities
|
|-
| opinions
| Contains the following sub-blocks:
* active_opinions (contains opinion entries)
|-
| relations
| Encompasses hooks, alliances, Contains the following sub-blocks:
* active_relations
|-
| schemes
| Contains the following sub-blocks:
* active (contains scheme entries)
|-
| stories
| Contains the following sub-blocks:
* active (contains story entries)
* next=(date) ''(variable)''
|-
| pending_character_interactions
| Contains the following sub-blocks:
* data
* player
|-
| secrets
| Contains the following sub-blocks:
* secrets (contains entries of secrets) ''(repetition)''
* known_secrets
|-
| armies
| Contains the following sub-blocks:
* regiments
* army_regiments
* armies
|-
| religion
| Contains the following sub-blocks:
* religions
* faiths
* great_holy_wars
* holy_sites
|-
| wars
| Contains the following sub-blocks:
* active_wars
* names
|-
| sieges
| Contains the following sub-blocks:
* sieges ''(repetition)''
|-
| raid
| Contains the following sub-blocks:
* raid ''(repetition)''
|-
| succession
|
|-
| holdings
|
|-
| ai
| Contains the following sub-blocks:
* war_coordinator_db
* war_plan_db
* ai_stategies
|-
| county_manager
| Contains the following sub-blocks:
* counties
* monthly_increase (list of values)
|-
| fleet_manager
| Contains the following sub-blocks:
* fleets
|-
| council_task_manager
| Contains the following sub-blocks:
* active
|-
| important_action_manager
| Contains the following sub-blocks:
* active
|-
| faction_manager
| Contains the following sub-blocks:
* factions
|-
| culture_manager
| Contains the following sub-blocks:
* cultures
* template_cultures (list of numbers)
* era_discovery
|-
| mercenary_company_manager
| Contains the following sub-blocks:
* mercenary_companies
|-
| holy_orders
| Contains the following sub-blocks:
* holy_orders
* religion_name
* faith_name
|-
| coat_of_arms
| Contains the following sub-blocks:
* coat_of_arms_manager_name_map
* coat_of_arms_manager_database (ends at entry ~17278)
* next_id=(id) ''(variable)''
|-
| (triggered events)
| Each triggered event has its own block, started using triggered_event={
|-
| next_player_event_id=(value) ''(variable)''
|
|-
| played_character
| Contains the following sub-blocks:
* name="..." ''(variable)''
* character=(character id) ''(variable)''
* player=(value) ''(variable)''
* important_decisions
* legacy
* rally_points
|-
| currently_played_characters={ (character id...) }
| List of character ids.


|}

== Microsoft Storeバージョンからのファイルの展開 ==
Microsoft Storeバージョンを使用してファイルを読み取る場合は、UWPDumperというプログラムを使用してファイルを抽出できます。<ref>訳者注：Windowsを開発者モードにするため、自己責任でお願いします</ref>

# [[Mod#ツールとユーティリティ|UWPDumper]]の最新のx64バイナリをダウンロードします。 
# 開発者モードを有効にします(Windowsの設定→アップデートとセキュリティ→開発者用→開発者モード)。
# CK3を立ち上げます
# ダウンロードしたプログラムからUWPInjector.exeを実行します。
# ck3.exeの横に数値を入力します。ParadoxInteractive.ProjectTitus_zfnrdv2de78nyのprocessIDとして。
# ファイルがどこに保存されるかを確認します (おそらくC:\Users\%USERPROFILE%\AppData\Local\Packages\ParadoxInteractive.ProjectTitus_zfnrdv2de78ny\TempState\DUMPのどこか）
# プログラムが終了するのを待つ.
ファイルは、以前に指定したディレクトリに存在する必要があります。ファイルを編集する場合は、Modを作成し、目的のファイルをそこにコピーします。

== ツールとユーティリティ ==
* [[Exporters]] (MayaとPhotoshop)
* [https://forum.paradoxplaza.com/forum/threads/information-and-faq.924764/ Clausewitz Maya Exporter]: 3Dモデルを作成してエクスポートし、CK3や他のClausewitzゲームで使用するためのツール
* [https://github.com/Wunkolo/UWPDumper UWPDumper]: Microsoft Storeのゲームからファイルを抽出するツール

== 日本語化Mod ==
*pc GamepassなどSteam以外でプレイしている人はSteamWorkshopオンリーでの配布なのでModファイルを自身で抽出する作業が必要

*https://github.com/matanki-saito/Ck3JpMod
*Ck3JpModのreleaseから最新のzipを貰ってきて
*中のSourceフォルダをドキュメントの\Paradox Interactive\Crusader Kings III\modにそのままコピー
*コピーしたSoruceフォルダの中のdescriptor.modを一つ上のModフォルダにjapaneselang.modとしてコピー
*japaneselang.modをメモ帳で開いて以下を最後の行に追加して保存
*path="mod/source"
*pathの区切り文字をは\ではなく/、上記でダメな場合はsourceフォルダのフルパスを指定するといいかも。
*これでインストール済みのすべてのModに表示されるはず、後はプレイセットからModの追加をするだけ。

== 外部リンク ==
* [https://forum.paradoxplaza.com/forum/forums/crusader-kings-iii-user-mods.1080/ CK3 User Mods] パラドックスフォーラム
* [https://discord.gg/ck3 Crusader Kings] 公式Discord Modチャンネル。server-rolesチャネルに移動し、[https://discordapp.com/channels/616881873506795550/710484698924711976/710490306788982804 Channel Access post]でCK3 Moddingを選択します。
* [https://discord.gg/apEvxDZ CK3 Mod Coop] CK3のMod専用のコミュニティDiscordサーバー。

<br>

{{Modding navbox}}
[[Category:Modding]]
{{Mechanics navbox}}