Home

CK3 Modding Toolkit

Crusader Kings III mod development in VS Code, end to end. The extension bundles a language server with a real Paradox-script parser, so you get completion that knows what scope you are in, hover docs merged from your own script_docs logs and the wiki, instant diagnostics for the silent-failure class of bugs (unbalanced braces, missing BOM, folder-name traps), deep ck3-tiger integration, DDS texture tooling, and a set of activity-bar views (mod inventory, localization coverage, overrides and conflicts, an interactive event graph). Everything the extension "knows" is derived from the game itself: your script_docs dumps, the vanilla files, a small verified schema table. So it stays current across patches instead of rotting.

It also ships a Claude / agent skill for CK3 modding you can drop into any AI agent that reads SKILL.md files (see Claude Skill). That is a separate headline feature, not part of the extension runtime.

Alpha notice

This is version 0.1.0 ALPHA. It is genuinely early: features, commands, settings and defaults will change, and some rough edges are expected. That also means your feedback lands directly on the roadmap. Please report anything odd, missing or wrong:

• GitHub issues: https://github.com/JDeffner/ck3-modding-toolkit/issues
• The Paradox forum / Discord modding thread where the alpha is being discussed.

Concrete bug reports (what you did, what happened, what you expected) are the most useful thing you can send right now.

Where to go next

Getting the extension running

• Feature Overview - the visual tour: every major feature with a screenshot.
• Getting Started - install the extension, open your mod folder, run Setup, and (recommended) upgrade to version-exact data from your own game.
• Editor Features - the day-to-day guided tour: completion, hover, navigation, diagnostics, ck3-tiger, and the workflow commands.
• Sidebar Views - the CK3 activity-bar views (mod overview, problems, localization coverage, overrides, event graph, GUI widget tree, tools) and the mod report.
• DDS and Images - preview .dds textures inline, convert PNG/JPEG/WebP to DDS, and the measured image-size guidelines.

Reference

• Configuration - every setting, grouped, plus the full # ck3m:ignore inline-suppression documentation and the diagnostic-code list.
• Multi Mod and Translation - working on many mods at once, submods and compatibility patches, translating another mod, and the optional .ck3modding/ workspace files.

Project

• Claude Skill - the bundled AI-agent skill: what it teaches, how to install it, and how to use it.
• Credits - the upstream projects, data sets and communities this stands on.