「Mod」を編集中

* '''Create a mod for your modifications''': use a personal mod even for minor changes, and never directly modify the game files in the CK3 game folder as they may be overwritten without warning.

* '''Use a good text editor''' to edit files and search through folders. The following are free:

** [https://code.visualstudio.com/ Visual Studio Code]. Has a fan-made CWTools extension with Paradox syntax highlighting, validation and tooltips for triggers and effects. To install it, go to Extensions on the left panel of VS and search for CWTools. (Note: validation rules are incomplete and will show many false errors in gui and localization files)

** [https://notepad-plus-plus.org/downloads/ 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.

** [https://atom.io/ Atom]. Doesn't include UTF-8-BOM encoding needed for localization files. Otherwise is very customizable. 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 [https://discuss.atom.io/t/how-do-i-make-atom-recognize-a-file-with-extension-x-as-language-y/26539 this example].

** [https://www.sublimetext.com/ Sublime Text]. There is an extension for it released by the developers of Imperator which could be used with CK3: [https://forum.paradoxplaza.com/forum/index.php?threads/sublime-tools-for-imperator.1274246/ Sublime Tools]. It adds colored highlighting for effects and triggers. If you want to toggle comments in Sublime, you also need to add [https://cdn.discordapp.com/attachments/563655919892692996/649656191173263370/PDXComments.tmPreference this file] to the same "User" folder.

* '''Always check the error.log file for execution errors'''. <nowiki>...\Documents\Paradox Interactive\Crusader Kings III\logs</nowiki>

* '''The log folder also contains lists of effects, triggers and scopes.''' Use "script_docs" and "DumpDataTypes" console commands in the game to generate them.

* '''Start the game with -debug_mode -develop''' launch options to use the console and "reload gui", "reload gfx" commands.

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

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

* '''The directory for the CK3 folder on Linux is''' <nowiki>~/.local/share/Paradox Interactive/Crusader Kings III</nowiki>

* '''Communicate key facts about your mod clearly and succinctly.'''

**Your mod description should ''begin'' with a short but clear description of what your mod adds to or changes about the game. Don't begin with a changelog, or a long list of notices or pre-requisites, or installation instructions, etc.

**Don't assume the person reading the description has ever heard of the mod before (if they had, they wouldn't generally be reading the description).

**Clearly and visibly state whether your mod is Ironman-compatible. (Even if it seems obvious to you.)

* Remove your local mod when you subscribe to the Steam version, otherwise it may not work in the game.

* 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 [https://winmerge.org/?lang=en WinMerge]) to merge between folders and update modified files for a new patch.

* If you're replacing text across dozens or hundreds lines of code, you may want to use regular expressions. They are available in all of the text editors above. Learning resources: [https://regexone.com/ RegexOne], [https://regexr.com/ RegExr].