Project Settings

Project Settings

Every MPX project setting lives in .vscode/settings.json, created alongside your project. Open it from the Project section of the panel, or edit it directly.

Content language

mpx.contentLanguage — en (default) or fr. Controls the language of every label MPX generates itself: school names, skill names, unit words, section titles, and so on. Run MPX: Select Content Language for a quick picker instead of editing the file by hand.

Only generated labels are translated — your own free text (descr, name, and similar) always renders exactly as you wrote it, in whichever language that is.

Measurement units

mpx.defaultMeasurement — auto (default), imperial, or metric. On auto, the unit system follows the content language: French → metric, anything else → imperial. Run MPX: Select Default Measurement for a picker.

This prefills attributes.measurement on every new Compendium entry at the moment it's created — after that, it's a fixed value on that entry. Decide this before creating Compendium entries, since changing the setting only affects entries created afterward, not the ones you already have (see Managing the Compendium).

Translation overrides

Rename how a specific generated label displays — in either language — without forking the whole theme. Useful for a homebrew term, e.g. showing "Vigilance" instead of "Perception".

Create translation-overrides.json via the icon button in the Project section's title bar, or MPX: Create Translation Overrides File:

{
  "fr": {
    "Skill.Perception": "Vigilance"
  }
}

This renames that label everywhere it's used in the project, in that language — not just on one specific entry. Once the file exists, the Project section shows a Translation Overrides line with the current count; right-click it and choose Delete to reset (removes the file entirely).

Everything else

A few more settings live closer to the feature they affect, rather than here:

• Project theme — see Themes.
• Version auto-increment on build — see Building and Importing.
• Roll table auto-detection — see Roll Tables.
• Per-card display toggles (show/hide image, sources, tags, ...) — see Advanced Settings.

Next step

Advanced settings.