Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>ParadoxCodeNew to Visual Studio Code? Get it now.
ParadoxCode

ParadoxCode

ParadoxCode

|
74 installs
| (0) | Free
Complete support for EU4 modding, including diagnostics, completions, hover, go-to-definition, previews, and transcoding.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

ParadoxCode for VS Code

Project overview · 简体中文入口

This guide owns installation, editor workflows, and troubleshooting. Settings, defaults, and commands come from the generated extension reference.

Setup

  1. Install ParadoxCode from Visual Studio Marketplace.
  2. Open and trust the Mod folder, then open an EU4 script or localisation file.
  3. The extension downloads the matching server release, verifies its checksum, and starts it.
  4. If discovery misses your game installation, use the installation picker in the ParadoxCode walkthrough. Select your EU4 installation, rather than a text-only corpus copy.

The extension's Get Started walkthrough supplies the current command labels and guided setup. For an offline install, download the VSIX and a matching native server archive from GitHub Releases, extract the server, and set paradoxcode.serverPath to its executable. Supported targets and archive names are defined in server-distribution.json.

Workspace and dependencies

Open the directory containing the Mod's common, events, or other game folders. Use the dependency commands from the Command Palette to add, remove, or reorder dependency roots. The ordered paradoxcode.dependencies array may select live source roots or persistent indexes. When an explicitly selected dependency index becomes stale, rebuild it or remove its index field to resume live scanning. Unsaved editor buffers participate in analysis.

Vanilla discovery and indexing are guided by the walkthrough. The paradoxcode.vanilla.* settings control whether local Vanilla data is discovered or an existing cache is required. Configured exclusions prune generated files before indexing. Use the reference for exact properties and defaults.

Diagnostics and language features

The diagnostic guide explains stable codes and remedies. Diagnostic ignore codes and severity overrides are extension settings; unknown codes are rejected. The workspace-wide diagnostics setting controls publication for closed files, while validation commands can still compute a complete workspace summary.

Localisation is indexed for lookup/navigation and receives transparent-encoding safety feedback; it does not publish server diagnostics or completion items. Script rename is restricted to writable Mod sources, and formatting refuses malformed input it cannot safely preserve.

Search

Use the editor-title search button or ParadoxCode: Search to open the retained search panel. Rules, definitions, localisation, and full text keep separate queries and filters. The first open uses selected editor text; focusing an existing panel preserves its query. Source checkboxes select the current Mod, individual dependencies, and Vanilla independently.

Localisation searches complete readable values, including text beyond hover previews. Multiple words must all occur; switch to key mode for key lookup. Languages come from entry headers and an explicit language never falls back to another language. Definition search ranks exact, prefix, substring, and subsequence matches. Version filters retain the workspace's coverage state when a higher-priority source is hidden. Copy and find-references are separate result actions; references open a returnable view and count semantic uses rather than ordinary text occurrences.

Full text includes readable files outside semantic definition categories, comments, and strings. Unsaved Markdown and other text buffers participate even when they are outside the language server’s document selectors. Source-control and ParadoxCode cache metadata are excluded. Path filters use source-relative globs, separated by commas; exclusions take precedence. Expand a match to inspect nearby lines. Searches use editor buffers, and navigation preserves existing decoded-document identities without saving or transcoding a source file. Results open in a text-editor group beside the panel. If an editor represents characters differently, navigation relocates a unique literal or explicitly opens the source line instead of using an unsafe column.

Loading another page requires the same workspace and query snapshot. Edits refresh results; cancelled requests cannot overwrite newer input. Coverage notices identify unavailable source files, text budgets, and output limits. Such results are partial, including when no available file matches. Cached semantic definitions do not imply that full localisation values or file contents are available. This implementation is undergoing the full search acceptance matrix.

Mission Preview

Open a mission file under common/missions or missions, then choose Open Mission Tree Preview to the Side. The preview supports live refresh, source navigation, texture-backed nodes, keyboard navigation, and zoom controls. The view keeps its pan and zoom across refreshes, fitting only when a different mission file is opened. The search box finds missions by localised title or id; opening a result jumps to its source definition and centers the canvas on the node. A Series panel mirrors the canvas layout column by column (Slot N blocks wrapping left to right) with a checkbox per mission series: hidden series keep their canvas position but drop out of the canvas, dependency arrows, search result highlighting, and the diagnostic summary, and each document remembers its hidden set for the session. Run Refresh Mission Tree Preview from the Command Palette for a manual refresh. Run Open Mission Icon Picker from the Command Palette or the mission editor's context menu.

Transparent Localisation (Chinese)

Mods running the EU4dll double-byte patch store localisation as escape-tripled bytes. ParadoxCode ships a Rust-server-backed transcoder. By default, files keep their ordinary file:// view:

  • Use the editor-title Decode Entire File (Readable Text) button (down arrow) to write readable text to disk, or Encode Entire File (EU4dll Escape Form) (up arrow) to write escaped bytes. Comments, identifiers and strings are all converted. The buttons apply to localisation/**/*.yml and workspace script files matching paradoxcode.localisation.transparentScriptGlobs (**/*.txt by default).
  • Encoding preserves existing valid triples and converts every readable run. Decoding resolves every triple and preserves readable UTF-8. Partially converted files converge without double encoding. No quote-only mode or protocol option remains.
  • Save or close unsaved editors before converting. Each changed conversion writes the original bytes to .pre-transcode.bak. No-op conversions write neither the file nor the backup. Edits made while conversion is running require a retry.
  • Invalid localisation UTF-8, damaged triples anywhere in the file, and unencodable characters anywhere in an encode input refuse the entire conversion and report input positions.
  • The connected server must advertise pdcWholeFileTranscode. Older servers are rejected before conversion; update the server together with the extension.

Automatic transparent encoding and editable pdcloc:// views are experimental and disabled by default. Search and navigation have known limitations. Enable paradoxcode.localisation.transparentEncoding and reload the window to opt in:

  • needsTranscode opens eligible files when escaped/damaged content or text that saving would convert occurs anywhere in the file. This includes comment-only CJK and bare identifiers. always opens every eligible file; off requires an explicit command. Diff editors remain raw.
  • The decoded view uses the same whole-file codec as the manual buttons. Saving encodes the entire file; valid existing triples are preserved. Damaged sequences and unencodable characters prevent writes. Legacy files containing both readable text and escaped strings can be decoded and saved into the complete file form.
  • The status bar and Peek at the Raw Transcoded Form command expose the original bytes. Turn transparent encoding off and reload to return to the manual buttons.

Configuration

Use VS Code Settings under paradoxcode, or workspace settings.json for shared project choices. REFERENCE.md is generated from the same manifest VS Code reads, including localized descriptions, defaults, enums, and array/object constraints. This reference describes extension defaults; editor-neutral initialization behavior belongs to the server integration guide.

Troubleshooting

  • Server missing or download failed: inspect the ParadoxCode output channel, installation policy, selected executable, and whether a matching release exists. A source checkout may be newer than the published release; point it at your locally built server.
  • No language features: trust the workspace, open a recognized game file, and check the active language mode and server output. The extension's language/activation registrations live in package.json.
  • Missing symbols or textures: check the selected Mod, dependency order, game installation, and Vanilla policy. A text-only corpus does not contain the game's image assets.
  • Settings changed: many server settings apply live; executable/installation changes require restarting the server. Reload it from the Command Palette when diagnosing configuration changes.
  • Transcoding refused: consult the diagnostic guide and repair the original content before retrying.

For a bug, use the issue template with a minimal repository-owned reproduction. Keep licensed game content and machine paths private. Extension development and validation are described in CONTRIBUTING.md.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft