模組製作

模組製作（Modding）允許改變遊戲的要素或者添加新特性。
Certain things are hardcoded, i.e. not available for modding, such as changing mapmodes and diplomatic actions or adding new hotkeys.

Important: the majority of mods will change the checksum, not allowing the player to get achievements. Loading an ironman game with such a mod will irreversably corrupt the save file, so be careful.
See "checksum_manifest.txt" in the game folder for the list of checksummed folders and files. The only safe mods are the ones that replace textures, fonts or music.

提示和指南

• Create a mod instead of directly modifying the game files, as they will be overwritten with any game update.
• Use a good text editor for syntax highlighting, autocompletion and search across multiple files. The following programs are free:

1. Visual Studio Code. There is a fan-made CWTools extension for VS, which recognizes Paradox code language, will warn you of missing brackets and show information about scopes and effects in a tooltip. To install it, go to Extensions on the left panel of VS and search for CWTools. (Note: if the extension isn't up to date with the patch, it may show many false errors)
2. Sublime Text. Imperator developers have released Sublime Tools with syntax highlighting and function search. In addition, to be able to toggle comments, you need to add this file to the same "User" folder.
3. Notepad++. Choose Perl as your language, as it will provide good highlighting and allow to fold blocks of code and comments. To set it as default, go to Settings, Styler Configurator, find Perl in the list on the left and add "gui txt" (without quotes) to the "User ext." field at the bottom.
4. Atom. Doesn't include UTF-8-BOM encoding needed for localization files. Choose Perl 6 as your language for better results. To set it as default, go to File, Config, find "core:" and add below it: "customFileTypes: "source.perl6": [ "txt" "gui"]", like in this example.

• Indent properly, so that opening and closing brackets are on the same level. Proper formatting will allow you to fold blocks of code, help spot any mistakes and make it easier to read.
• Add comments, starting with #, to remember later how things works, to navigate easier or to disable parts of code without deleting them.
• Use UTF-8 encoding for text files.
• Use UTF-8-BOM for localization files.
• Start the game with the "-debug_mode" and "-develop" options to use the console, dev tools and "reload" commands. See here how to add launch options.
• Use the error.log to catch any bugs. It's located next to the mod folder, in Documents/Paradox Interactive/Imperator/logs.
• Use "script_docs" and "DumpDataTypes" console commands in the game to generate other logs with event effects, triggers and scopes.
• Remove your local mod when you subscribe to the Steam version, otherwise it won't work.
• Clearly communicate to users whether your mod is ironman-friendly.
• Backup your work. Either manually or with a source control system like Git. Also consider using GitHub for team collaboration.
• Use a proper merge tool (like WinMerge) to merge between folders and update modified files for a new patch.

創建你的第一個 mod

1. Start the game launcher, go to All Installed Mods, Upload Mod, Create a Mod and fill in all the fields, including tags. Clicking Create will create a new folder and a .mod file in Documents/Paradox Interactive/Imperator/mod.

• "Version" refers to the game version this mod is made for.
• Folder name may include spaces, although it is common to use lower_spaces instead.

2. Copy the game files you wish to mod to your newly created mod folder or create your own files, while using the same folder structure.

• For example, if you want to mod the topbar, your should have the following: my_topbar_mod/gui/ingame_topbar.gui.
• If you want to add events to this mod, you would have my_topbar_mod/events/topbar_events.txt.

3. After modifying the files, enable the mod in the launcher and test it in the game.

• If modding UI, you can use "reload gui" command to see new changes without restarting the game. (This requires both -develop and -debug_mode launch options. See above how to enable them.)
• Remember to check the error.log for any errors.

4. To add a thumbnail for a mod, name your image "thumbnail.png" and put it inside your mod folder. Make it at least 200x200 pixels, so Steam doesn't add black borders around it.
5. To upload a mod, open the game launcher, go to All Installed Mods, Upload Mod. Select your mod from the dropdown menu, select the platform to upload it to and click Upload. The description isn't necessary.

• You will find your mod in your Steam profile, Workshop Items. New mods are uploaded in private mode, so change their visibility to Public to actually publish them.
• Remember, remove your local mod folder if you want to test the Steam version of it, otherwise they will conflict with each other. You may simply move it, along with the .mod file, to another folder and move it back whenever you want to update your mod.

6. To update a mod, simply open the launcher and upload it again.
(When you upload a mod for the first time, the launcher creates a descriptor.mod file in your mod folder which links to your Steam mod. This is what's used for updating, so don't remove this file.)

遊戲數據

• Effects - 用於動態地影響遊戲。
• Triggers - 用於執行命令/事件/決議/等等。只有當特定條件為真時。
• Scopes - 用於明確規定命令和條件的目標。
• Modifier list - 影響遊戲方方面面的腳本修正。
• Defines - 用於遊戲在幾乎所有方面的全局值。
• Country list - 原版遊戲中全部國家的基本信息，包括國家代碼。
• Console commands - 關於如何使用遊戲控制台命令的指南。

• 遊戲預置腳本

• 遊戲預置修正

• 總表

指南

• AI 修改
• 建築修改
• 人物修改
• 盾徽修改
• 國家修改
• 文化修改
• 決議修改
• 事件修改
• 基因修改
• GFX 修改
• 政府修改
• GUI 修改
• 理念修改
• 本地化
• 地圖修改
• Mod 文件
• 省份設置
• 宗教修改
• 研究修改
• 單位修改

排除故障

Mod 在上傳到 Steam 之後不工作

Check whether other mods work for you. If not and your Documents folder is not in the default place, the launcher can't find it.

You need to edit "launcher-settings.json":

1. open the game directory (Right-click on Steam, Properties, Local Files, Browse Local Files)
2. in the 'launcher' folder open launcher-settings.json with a notepad
3. change gameDataPath to "%USER_DOCUMENTS%/Paradox Interactive/Imperator"

If this still doesn't help, try using the whole path, like "F:/Documents/Paradox Interactive/Imperator". Make sure you use forward slashes / and double quotes ".

在 .mod 文件中的路徑變成絕對路徑

The new launcher overwrites the "mod/modname" path to the absolute one, like "C:/Users/User/Documents.../mod/modname".

While this is normal, for some modders it can prevent the game from loading the mod. To solve it:

1. Change the path to relative again.
2. Right-click the file -> Properties -> check Read-only.

This will prevent the launcher from editing it. Remember to disable read-only when uploading, since the launcher needs access to the file.

工具與實用程序

• Clausewitz Maya Exporter - 此工具允許更簡便地創建3D模型（單位）用於較新的克勞塞維茨引擎遊戲中的模組。
• VS Code - 強大的、可控制的、免費開源編輯器，來自微軟。（在VS Code擴展中心搜索安裝中文語言包）
• CWTools - 一個用於VS Code的擴展，提供拼寫驗證、代碼補全、語法高亮以及更多功能給Paradox腳本文件。（在VS Code擴展中心搜索安裝CWTools）
• Notepad++ Syntax Highlighter - Notepad++語法高亮規則定義。（已過時）
• province setup converter 1.3.x -> 1.4 - 一個用來轉換舊的省份數據信息，從 Imperator 1.3.x 或者使用 province_setup.csv 文件到文本格式給 Imperator 1.4

社區

• 官方論壇的模組製作指南：Imperator Modding Guide Index
• Imperator: Rome - User Mods - 在Paradox Plaza論壇上的子論壇，專門用於用戶為I:R製作模組。
• Imperator Modding Coop - 一個Discord伺服器，專門用於用戶為I:R製作模組。

雜項

• 校驗碼

參考資料

模組製作

音頻

音樂 • 音效