Mod

CK3 Mod#1 -Modの簡単な紹介。 Roll1D2 Gamesによる便利なツールの案内とハウツーModビギナーズガイド

Mod、またはModを作成することは、個人的な使用のために、またはParadox ModsまたはSteam Workshopを介して他のプレーヤーに公開するために、ゲームのアセットまたは動作を変更する行為のことです。

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

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

重要なこと：ほとんどのMODではチェックサムが変更され、プレイヤーは実績を獲得できなくなります。チェックサムに影響するフォルダとファイルのリストについては、ゲームフォルダのchecksum_manifest.txtを参照してください。安全なModは、テクスチャ、シェーダー、フォント、音楽を置き換えるものだけです。

助言とガイドライン

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

ローカライズファイル

• localizationフォルダにある*.ymlファイルはゲームで正しく読み込まれるようにするためにBOM付きUTF-8でエンコードされて保存されている必要があります。
• ゲームでファイルを正しく読み込むには、ファイル名を*l_<language>.ymlの形式で保存する必要があります。例：council_l_english.yml。
  • "localization"とアメリカ英語のスペルを使用する必要があります。イギリス英語の"localisation"というスペルにすると動作しません。
  • 既存のローカライズ値を上書きするには、変更を加えたファイルをlocalization フォルダ内の「replace」という名前のフォルダに置きます。

Modの作成

メイン記事へ: Mod structure#Creating initial files

Modの初期ファイル郡を作成するには、ゲームランチャーを使用することをお勧めします。

Modのアップロード/アップデート

Upload your mod again to update it

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

1. ランチャーを開きます
2. 「MOD」セクションを開きます。
3. 「MODツール」を押して、自分のmodをドロップダウンメニューから選びます。
4. それをどのプラットフォームにアップロードするかを選びます。
5. 説明を書きます
6. 説明を確定します。 (更新する場合は、ランチャーがサイトから最新のものをコピーしたことを確認してください。)
7. サムネイルを追加します。
8. *Steam Workshopの場合、modフォルダにthumbnail.pngを入れます。1:1の比率で最大1MBを使用します。Workshopで表示される最大のサムネイルは、約600x600ピクセルです。
9. Paradox Modsの場合は、説明の下のフィールドにサムネイルをドラッグします。推奨最小サイズは900x500、pngまたはjpg、最大1MBです。
10. 「アップロード」ボタンを押します。
    • Steamの場合、プライベートモードでアップロードされ、 自分のSteamプロファイル→ワークショップアイテムに表示されます。これを開いて、サイドバーの表示を「公開」に変更すると、実際に公開されます。
    • Paradox Modsでは、検証プロセスの後にModが公開されます。サイトでは通常、改行とBBCodeのフォーマットが削除されるため、説明を編集する必要があります。

Save game editing

Save files are located in:

• Windows: Documents\Paradox Interactive\Crusader Kings III\save games
• Linux: ~/.local/share/Paradox Interactive/Crusader Kings III/save games

It is not possible to edit an ironman save!

First start the game in the debug mode and save.

• On Steam: right-click the game on Steam -> Properties -> Set Launch Options -> add -debug_mode

• Windows: Create a shortcut for the .exe file -> right-click it -> Properties -> add -debug_mode at the end of the Target field

PC:

1. Find the save file in the save games folder.
2. Right-click the save file and extract it like an archive with 7-Zip or WinRar.
3. Rename the extracted 'gamestate' file to something with a .ck3 extension.
4. Right-click it and open with your text editor (Windows Notepad is not recommended as the save files are very big).
5. Edit the file and save it.
6. Load it in the game.

Autosaves can be edited directly without extracting the gamestate.

Mac:

1. Open Terminal
2. Ensure that the directory is set to the correct folder
3. Type in "unzip FileName.ck3"
4. Rename the extracted 'gamestate' file to something with a .ck3 extension
5. Edit this plain-text save
6. Load it directly in the game (no need to re-compress)

OS	Save type	Location
Windows	Local	C:\Users\%USERPROFILE%\Documents\Paradox Interactive\Crusader Kings III\save games
Windows	Steam Cloud	C:\Program Files (x86)\Steam\userdata\####\1158310\remote\save games
Mac	Local	$HOME/Documents/Paradox Interactive/Crusader Kings III/save games
Linux	Local	$HOME/.local/share/Paradox Interactive/Crusader Kings III/save games

Contents of the gamestate file

The table below contains the possible first-level blocks in the gamestate file. Entries are provided in order of appearance.

Block	Description
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. 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	Contains the following sub-blocks: Sub-block Description dynamic_templates landed_titles (repetition) Contains an entry for each landed title in the game, in the format: # 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 } In vanilla CK3, this block ends at entry ~12369. index=(value) (variable)
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: 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 } }
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.

Extracting files From Microsoft Store version

If you want to read the files using the Microsoft Store version, you can use a program called UWPDumper to extract the files.

1. Download the latest x64 binary of UWPDumper
2. Enable Developer Mode (Windows Settings -> Update and Security -> For Developers -> Developer Mode).
3. Run CK3.
4. Run UWPInjector.exe from the program you just downloaded.
5. Enter the number next to ck3.exe : ParadoxInteractive.ProjectTitus_zfnrdv2de78ny as the processID.
6. Check where it is going to store the files (probably somewhere like C:\Users\%USERPROFILE%\AppData\Local\Packages\ParadoxInteractive.ProjectTitus_zfnrdv2de78ny\TempState\DUMP
7. Wait for the program to finish.

The files should then be present in the directory specified earlier. If you want to edit the files, create a mod and copy the desired files there.

Tools & utilities

• Exporters (Maya and Photoshop)
• Clausewitz Maya Exporter: a tool to create and export 3D models to use in CK3 and other Clausewitz games.
• UWPDumper: a tool to extract files from Microsoft Store games.

日本語化Mod

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

• https://github.com/matanki-saito/Ck3JpMod
• Releaseページへ移動
• JSONファイルを開くとZIPファイルのリンク先がわかるのでそれをDLしModフォルダに展開
• ゲームランチャーでModを有効化

外部リンク

• CK3 User Mods パラドックスフォーラム
• Crusader Kings 公式Discord Modチャンネル。server-rolesチャネルに移動し、Channel Access postでCK3 Moddingを選択します。
• CK3 Mod Coop CK3のMod専用のコミュニティDiscordサーバー。

Modding

Map	Map • Terrain

Audio

Music • Sound

メカニクス