Settings reference

Every Kard setting, grouped by area. Each table lists the setting, what it does, its default, and its scope (who it affects). Scan for the one you need.

Note

Some settings are only visible in the Developer settings Project Settings -> Plugins -> Kard

Open Settings

Open Kard, then open the Settings panel — press Ctrl+,, or click the Settings icon in the navigation rail. Settings is a panel inside the Kard tab, not a separate window; closing it returns you to the same view you left.

The panel is organized into sections — Workspace, Tasks, Appearance, Shortcuts, Identity, AI, and Advanced — and opens on the Vault folders page. A search box at the top filters settings by name across every section.

Note

The same settings also appear under the engine’s Edit → Project Settings / Editor Preferences → Plugins, in four sections: Kard, Kard User Settings, Kard MCP, and Kard AI. Kard’s own panel is the canonical place to edit them.

Scope badges

Every setting carries a scope badge that tells you who a change affects:

Badge	Meaning
Team	Shared with everyone on the project. Saved to a project config file checked into source control.
You	Only affects you on this machine. Never shared with the team.
This folder	Saved on one folder. Only affects Kards inside it; other folders keep their own settings.
View only	Status or preview information — nothing to edit.

Folders

Where Kard stores each kind of asset. Scope: Team.

Setting	What it does	Default	Scope
Tasks folder	Sub-folder for Task assets.	/Game/Kard/Tasks	Team
Notes folder	Sub-folder for Note assets.	/Game/Kard/Notes	Team
Pages folder	Sub-folder for Page assets.	/Game/Kard/Pages	Team
Attachments folder	Shared folder for image attachments. Every Kard-authored image (clipboard paste, viewport capture, drag-and-drop import) lands here.	/Game/Kard/Attachments	Team
Tombstones folder	Folder where deletion records are written when the deletion audit (below) is on.	/Game/Kard/Tombstones	Team
Tombstone retention days	Auto-remove deletion records older than this many days when you open the Activity view. 0 keeps them until you clear them manually.	0	Team
Enable local deletion audit	When on, each Kard or folder deletion writes a deletion record so the Activity feed can show who deleted what. Off → deletions leave no record (one fewer file in every delete commit).	Off	Team

Note

The Kard root folder (/Game/Kard) is fixed and not configurable. You can only change the sub-folders above.

Tasks and tags

Vocabulary and visuals for tasks. Scope: Team.

Setting	What it does	Default	Scope
Categories	The list of task categories you can pick from.	12 seeded categories (see below)	Team
Tag colors	Optional per-tag color overrides, shown as tinted pills. Tags without an entry get a color automatically.	Empty	Team

A fresh project seeds twelve categories: Character AI, Animation, Combat, Level Design, Lighting & VFX, Audio, UI & HUD, Collision, Performance, Bug Fix, Cinematics, Gameplay. Edit the list freely.

Identity

Team accounts. Kard signs you in with a local account (the first one created becomes the admin); accounts live in the shared user directory below. See Collaborate with your team for the sign-in and roster workflow. Scope: Team.

Setting	What it does	Default	Scope
Users directory path	Asset path of the shared team user directory holding every local account. Only an admin who can check the file out may change the roster.	/Game/Kard/KardUsers	Team

History

Edit-history behavior. Scope: Team.

Setting	What it does	Default	Scope
Save records history by default	When on, every save logs an edit-history entry; Shift-click Save makes a single save quiet. When off, saves are quiet by default and Shift-click logs.	On	Team

Markdown and video

Controls for inline video embeds and remote thumbnails. Scope: Team.

Setting	What it does	Default	Scope
Fetch remote video thumbnails	When on, !video[url] embeds fetch the provider’s preview image over the web. Off → embeds show a clickable placeholder instead. This is the only outbound network request Kard makes on its own.	On	Team
Enable inline video playback	Master switch for playing !video[...] direct streams and local files inside the editor. Needs the optional media integration module and the Electra Player plugin.	On	Team
Inline video host allowlist	Hosts allowed to serve inline video. Empty means any public host is permitted; private and loopback addresses are always blocked.	Empty	Team
Inline video base URL	Optional base URL used to resolve relative !video[...] references. Empty → relative refs resolve to local files in your project’s Content folder.	Empty	Team

Viewport and performance

How Kard badges look and draw in the level. Scope: Team.

Setting	What it does	Default	Scope
Show in game view	When on, Kard badges stay visible after you press G (Game View) and in PIE. Off → they hide so the level looks shipping-clean.	Off	Team
Default max draw distance	Default maximum draw distance for Kard badges in the level. 0 = unlimited. You can override this per-machine (see Workspace).	0	Team
Viewport profiles	Studio-defined viewport display profiles, looked up by name.	Empty	Team
Default level context class	The class used when you create a level-anchored Kard. Teams can subclass this for their own world model.	Built-in simple level context	Team

Source control

Scope: Team.

Setting	What it does	Default	Scope
Use a dedicated Kard changelist	When on, Kard gathers its own checked-out files into a separate [Kard] changelist with an auto-filled description. Perforce only; ignored for Git, Subversion, or no source control.	On	Team
Git web commit URL pattern	When your source control is Git, the “open commit externally” action substitutes the commit hash into this URL. Empty → clicking copies the hash to your clipboard instead.	Empty	Team

Workspace (your personal settings)

These affect only you on this machine and are never shared. Scope: You.

Layout and navigation

Setting	What it does	Default	Scope
Show rail section labels	Show a small caption (Home / Tasks / Pages / Notes) under each navigation-rail icon.	On	You
Restore session on startup	When on, reopen the workspace tabs you had open when you last closed Kard. Off → opens clean.	On	You

Notes drawer

Setting	What it does	Default	Scope
Animation duration	Drawer slide-in time, in seconds.	0.18	You
Width fraction	Fraction of the available width the drawer aims for.	0.7	You
Minimum width	Smallest the drawer can be, in pixels.	480	You
Maximum width	Largest the drawer can be, in pixels.	1100	You

Pages reading time

Used to estimate read time on Pages.

Setting	What it does	Default	Scope
Reading words per minute	Reading speed used for the estimate.	220	You
Seconds per code block	Time added per code block.	30	You
Seconds per heading	Time added per heading.	3	You
Seconds per image	Time added per inline image.	15	You

Appearance and drawing

Setting	What it does	Default	Scope
Max draw distance override	Your per-machine override of the project default. -1 = follow project, 0 = unlimited.	-1	You
Hover scale	How much a badge grows when you hover it.	1.10	You
Outline color	Outline color on hovered Kards.	Gold	You
Active viewport profile	Name of your active viewport profile. Empty = the default profile.	Empty	You

MCP server (optional)

The MCP server lets local AI tools talk to Kard. It ships off and, when on, listens on your own machine only (loopback, 127.0.0.1) — never on the network. It’s an opt-in power feature you don’t need for normal use; see Connect AI tools (MCP). Scope: Team.

Setting	What it does	Default	Scope
Enable MCP server	Master switch. When on, the server starts when the editor boots and listens on 127.0.0.1 only.	Off	Team
Port	Local port the server listens on (loopback only). Changing it while running restarts the server.	30050	Team
Log verbose request diagnostics	Logs each request to a small in-panel buffer for troubleshooting. Off keeps the editor lean.	Off	Team
Allow source-file reads	Lets AI tools read source files. Even when on, reads stay inside your project’s and plugins’ Source/ folders.	On	Team
Max Blueprint graph nodes per call	Caps how many Blueprint graph nodes a single request can read.	200	Team
Resource × verb toggle matrix	Per-action trust gate. By default read actions are on and write actions are off, so a connected tool can look but not change anything until you opt in.	Reads on, writes off	Team

Note

The server’s bind address is fixed to loopback (127.0.0.1) by design and is not an editable setting. It cannot be exposed to the network.

AI assistant (optional)

Kard’s optional in-editor AI chat. It ships off, and your API key is stored in your per-user config so it never lands in source control. See AI assistant. Scope: You.

Setting	What it does	Default	Scope
Enable AI	Master switch. When on, the chat panel and one-shot AI actions become available. Needs the active provider’s API key.	Off	You
Provider	Which AI provider is active. Empty falls back to the built-in default.	None	You
Max output tokens	Cap on how long each AI response can be (the provider’s own caps still apply).	4096	You
Grant MCP tool access to AI	When on, the AI can read and change the project through the same tools external clients use. Its edits are stamped as “KardAI”.	On	You
Allow the AI to delete Kards and comments	When on, the AI may delete Kards and comments. Off → delete tools are hidden from the AI (a safety guard). Move and update are always allowed.	Off	You
Show token usage in chat	Show a running token count in the chat header — a guard against runaway loops.	On	You
System prompt	Text prepended to every conversation. Editable so studios can adjust tone.	Built-in Kard prompt	You

For the active provider, you also set:

Setting	What it does	Default	Scope
API key	Your provider key. Shown masked. Leave empty for providers that need no key.	Empty	You
Model	The model to use. Can be refreshed from the provider’s model list.	Empty	You
Base URL	Optional endpoint override (for gateways or self-hosted setups). Empty = the provider’s standard URL.	Empty	You

Note

All AI controls are hidden until Enable AI is on. Once enabled, tool access is on by default but deletion stays off.

Keyboard shortcuts

Keyboard shortcuts are not edited on these tables. The Shortcuts section in the Settings panel lists every Kard chord (read-only) and offers an Open Keyboard Shortcuts button that takes you to Editor Preferences → General → Keyboard Shortcuts, where you can rebind them. For the full list, see Keyboard shortcuts.

A note on remembered preferences

Some personal preferences are remembered automatically and never appear in any panel — for example, your last export options, per-folder group/layout choices, unread markers, and Activity-feed filters. They persist between sessions but aren’t meant to be edited by hand.

Next steps

• Installation — install and verify Kard.
• Keyboard shortcuts — every Kard chord, by scope.
• FAQ — storage, source control, and troubleshooting.