Changelog

The app shows the same content under Help → Version history. Full list:

Changelog

Format based on Keep a Changelog; versions follow Semantic Versioning.

[Unreleased]

[0.8.1] — 2026-09-18

Added

• The bundled MCP server can work with sketches: list and read them, create one, add layers, append elements, and look up the built-in symbol names. A shape or icon name outside the built-in list is refused before anything is written.

[0.8.0] — 2026-09-15

Added

• Sketches gained a Stamp tool: place a ready-made picture instead of drawing one, by clicking for the default size or dragging to size it.
• A hundred and twenty built-in sketch symbols, grouped into Plants, Terrain, Water, Settlements, Structures, Interiors, Gameplay, Modern, Sci-fi and Markers, usable straight away without creating an entity or uploading artwork. Most subjects come in several shapes — pine, round tree, dead tree and palm side by side — so a map can keep whichever style suits it. They are drawn by the app, so they take the current ink colour, stroke width and fill, and stay sharp at any zoom.
• The symbol palette has a search box that matches the names as they are shown in your language.
• An Interiors group covers what a level layout needs: doors (plain, double, locked and secret), a trapdoor, a portal, stairs up and down, a ladder, a pit, a window, a pillar, rubble, a brazier, a lever, a pressure plate, and furniture from barrels to a fountain. They are drawn as objects, not as architectural plan glyphs, so they sit on a sketch beside the outdoor symbols.
• A Gameplay group annotates a layout instead of furnishing it: a spawn point, an exit, a checkpoint, an objective, a waypoint, a trigger zone, an NPC, a quest giver, an enemy, a boss, a key and its lock, an interact and a timer mark, a trap, a hazard, no entry, one way, dialogue and a cutscene. In the colour set their colour carries meaning — green for where play begins, gold for what to aim at, red for what harms, blue for the machinery.
• Modern and Sci-fi groups cover the stories the medieval set could not: a skyscraper, an apartment block, a factory, a warehouse, a fuel station, a power pylon, an antenna mast, a satellite dish, a railway, a container, a bunker and a chain fence; a spaceship, a space station, a landing pad, a crash site, a dome, an airlock, a reactor, a terminal, a droid, a cryopod, a force field and a solar array. They read cooler than the rest, which is what concrete and steel look like, but they use the same palette.
• The same hundred and twenty subjects also come as colour icons, chosen with a Line / Colour switch at the top of the palette. A colour icon brings its own palette instead of taking the ink colour and stroke width, and keeps its proportions inside its box. They scatter, rotate and resize like the line symbols, and exported SVG and PNG files carry them embedded.
• Your own SVG can become a sketch symbol too: Import from SVG in the symbol palette reads the outlines of an SVG in Assets, and from then on it behaves like a built-in one.
• A stamp can also point at an entity, drawing its portrait; renaming the entity or changing its icon updates every sketch it appears on.
• A Scatter tool lays the same stamp down along a drag — a row of trees, rocks along a ridge — with spacing measured along the path and optional size and rotation jitter. One drag is one undo step.
• A Used by panel on a sketch lists the flow cards and story cards that link to it, and clicking one opens that card.
• A flow card carries a badge with the name of the sketch it links to, so a linked card is recognisable without selecting it.
• An entity lists the sketches it has been stamped on, with a count where it appears more than once.
• A selected line or arrow has a handle at each end, so either end can be moved on its own; Shift snaps the angle. The box handles are gone for these, since a level line's box is flat and they all landed on top of each other.
• A stamp can be rotated by hand: the inspector gained a rotation field, so a placed house or bridge need not sit axis-aligned.
• The stamp and scatter tools show the footprint under the cursor, so the size of what you are about to place is visible before you place it.
• Export lets you choose which layers the image contains. A reference image you want while drawing need not end up in the exported picture.

Changed

• A stamped image keeps its proportions inside its box instead of stretching to fill it.
• The chosen stamp on the toolbar is now a button that opens its own palette — it is the eye-catching part, so it is where people try to change it.
• An entity stamp without a portrait draws the entity's name inside the placeholder instead of an empty dashed box.

Fixed

• The global variables list scrolls when it outgrows the panel, instead of pushing the rest of the view out of reach.
• The scatter brush's rotation now applies to image stamps as well; it previously affected only symbols and entities.
• Entity stamps were missing from exported SVG and PNG files.
• A perfectly horizontal or vertical line can be resized. Its bounding box is flat on one axis, and the resize silently refused to run at all — with grid and angle snapping that is the common case, which made lines feel unmanageable.

[0.6.0] — 2026-09-13

Added

• New Sketches view for sketching level layouts and wireframes: pen, eraser, rectangle, ellipse, line, arrow, polygon with an adjustable side count, and text.
• Drawing tablets are supported: pressure-sensitive strokes, palm rejection while the pen is in use, and the pen's eraser tip on Windows.
• Layers with visibility, locking, opacity and ordering, and a reference image that sits on a locked background layer.
• Grid and 15 degree angle snapping, alignment guides while dragging and drawing, numeric X/Y/W/H fields, alignment and distribution, resize handles, z-order, copy, paste and duplicate, fill and opacity.
• Sketches export as SVG or PNG assets, and can be linked from both story cards and flow cards.
• Sketches are saved one file per sketch, one line per stroke, so two people drawing on separate branches merge without conflicts.

[0.5.8] — 2026-08-08

Added

• New Flow setting: scrolling the canvas can zoom (for a mouse) or pan (for a trackpad). Defaults to pan on macOS and zoom elsewhere. Pinch and the zoom modifier zoom in both modes.

Fixed

• Panning the canvas with Shift now works. Shift also being the selection key had disabled panning.
• On macOS, panning with Cmd no longer collides with multi-selection and scroll-to-zoom.

[0.5.7] — 2026-08-08

Changed

• Cloud Backup features now appear only when Git can actually run. They used to show on every desktop install, including ones where every operation was bound to fail.

[0.5.6] — 2026-08-08

Fixed

• The app no longer gets stuck in the Cloud Backup view when the Git status probe fails. Navigation and saving were both blocked, and the view offered no way out.
• Missing macOS command line developer tools are now recognised as a missing Git installation instead of an error from the /usr/bin/git stub.

[0.5.5] — 2026-08-08

Fixed

• Projects can be opened and created again on macOS: hidden project files (.gitignore, .yarndraft/) fell outside the file access scope and silently aborted the operation.
• An unreadable .gitignore is no longer overwritten with the default template.
• The bundled demo project now ships with the installer and is copied into the app data directory on first run, instead of pointing at a path that only existed on the build machine.

[0.5.4] — 2026-07-21

Fixed

• The MCP setup guide now accurately describes automatic setup for VS Code, Cursor, Codex, and Windsurf.
• Switching projects from Settings returns to the project launcher instead of leaving Settings over it.
• The MCP setup guide and Story Outline can scroll when their content exceeds the available height.

[0.5.3] — 2026-07-20

Added

• New global variables appear at the top of the Variables list and briefly highlight their full row.
• Opening a project configures the bundled YarnDraft MCP server for VS Code, Cursor, Codex, and Windsurf when available.

Changed

• Technical variable identifiers now convert accented Latin characters to their base ASCII letters, improving readability while remaining export-safe.
• Date inputs follow the selected application language, including US ordering in English.

Fixed

• Flow text fields keep their width while editing, auto-grow nodes only downward, and have easier-to-target resize handles.
• Story view tabs remain centered when switching views.

[0.5.1] — 2026-07-17

Added

• Optional automatic remote Git checks, configurable from 1 to 60 minutes, with a dismissible workspace banner when Cloud Backup has newer remote work.
• Optional Draft names with localized timestamp fallbacks and later display-name renaming.
• Project-local Git author setup before Cloud Backup operations create commits; existing effective Git identity can be used as a prefill.

Fixed

• First publish now checks that the remote repository is empty before creating local Git metadata or author configuration.
• Shared Git lock tests no longer depend on a two-second hook startup window under parallel test load.

[0.5.0] — 2026-07-15

Added

• Publish a standalone YarnDraft folder to a completely empty Git repository without using the command line.
• Draft-based collaboration with scoped cloud saves, updates from Main, GitHub/GitLab review links, an Under Review state, and safe Draft closing.
• Story-aware three-way merge that resolves content by stable IDs, explains meaningful conflicts in human language, and validates project integrity before committing.
• Linear Script View for reading a selected story branch as a continuous script, with quick card editing and a compact reading mode.
• Story Timeline with optional date and free-form time labels for Story Cards.
• Configurable idle-based autosave, a visible Saved/Unsaved/Saving status, an autosave switch, and a manual Save control.

Changed

• YarnDraft automatically detects projects inside an existing game repository and commits only the YarnDraft project folder.
• Cloud Backup technical details keep stable paths and IDs while also showing human-readable project, Flow, entity, template, variable-set, and asset names. Deleted items use their last committed name when available.

Fixed

• Interrupted, concurrent, and stale Git operations now fail safely and can be recovered without overwriting project or remote work.
• Draft updates support projects at the repository root and clean/no-change updates without reporting a false failure.
• Draft closing recognizes normal merges, squash merges, and rebased content while protecting newer cloud changes from deletion.

[0.4.4] — 2026-07-12

Added

• Story Board with hierarchical cards for acts, chapters, scenes, beats, and ideas.
• Corkboard view for freely arranging Story Cards, connecting them, resizing them, and choosing colors.

Changed

• Story outlines support drag-and-drop reordering and nesting.
• Story Card kind guidance is available in the active application language.

Fixed

• Corkboard middle-mouse panning now works while left drag remains available for marquee selection.

[0.4.3] — 2026-07-10

Added

• Unreal Live Sync now copies and imports referenced audio files into /Game/YarnDraft/assets.
• Unreal runtime support for dialogue widgets, flow selection, tasks, clues, inventory changes, game events, audio cues, and timer/delay cards.

Changed

• Flow edges now expose choice metadata only where the runtime can actually use it.
• The flow toolbar supports drag-to-drop node creation at the cursor position and multi-node movement.

[0.4.2] — 2026-07-07

Added

• Settings → Appearance tab with UI density plus base/editor text size presets for longer editing sessions.
• Settings → Templates & export tab with remembered default targets for Export to game engine and dialogue script export formats, plus placeholder import/export buttons for future template packs.
• Settings → Updates panel that checks GitHub releases and links straight to the latest download page when a newer version exists.
• Optional anonymous PostHog telemetry for first launch, daily app open, project create/open, and export events.

Changed

• General settings are now split more clearly: language/privacy stay under General, while visual tuning and export defaults moved into their own tabs.
• Dialogue script export defaults are documented and separated from game engine export defaults so CSV/JSON choices no longer read as engine settings.

[0.4.1] — 2026-07-06

Added

• Rich text entity fields with Unreal-style markup buttons, preview, and supported tags for colors, sizes, bold, italic, and important text.
• Unreal entity import now creates or refreshes /Game/YarnDraft/RichText/DT_YarnDraftRichTextStyles for Rich Text Block usage.

Changed

• The app status label is now Beta instead of MVP.
• User manual pages now document rich text entity fields and the generated Unreal Rich Text style Data Table.

Fixed

• Flow canvas now fits the rendered view after project/flow load and canvas resize.

[0.4.0] — 2026-07-06

Added

• Built-in YarnDraft Demo project pinned in Recent Projects, with a clean main canvas and nested demo flows for dialogue, tasks, clues, puzzle logic, inventory, timers, triggers, audio, notes, variables, and output pins.
• Recent Projects now shows project paths, supports copying them, and displays a copied confirmation.
• User manual guidance for keeping the Main canvas clean and moving detailed gameplay flow into nested canvases.

Changed

• Flow node creation rules now keep groups out of the normal node picker and restrict output pins to nested canvases.
• AI flow-generation prompts now prefer the same clean-main-canvas structure used by the demo project.
• The dev server ignores the bundled demo project to avoid reload loops from demo project file changes.

Fixed

• Private/public note changes no longer create group nodes by mistake.
• Note annotation edges no longer leave unusable pins on normal node cards.
• Puzzle cards no longer show generic gray handles on top of their explicit solved/failed/locked outputs.
• Opening broken recent projects now gives visible feedback instead of failing silently.

[0.3.4] — 2026-07-05

Changed

• Rebuilt installers with the 0.3.3 changelog and updated bundled manual included.

[0.3.3] — 2026-07-05

Added

• Unreal Engine Gameplay Tags export: entity templates and entities are now exported as Unreal Gameplay Tags into Config/Tags/YarnDraftTags.ini, so the engine recognises them natively without manual tag creation.
• Live Sync toolbar button: a toggle button in the Unreal Editor toolbar connects/disconnects to the YarnDraft Live Sync server (ws://127.0.0.1:38765) directly — no more digging through the Tools menu. A companion Sync Entities button imports entity data assets from the exported story.json.
• Comprehensive Node Types guide: the manual's flow documentation now describes every card type with its exact fields, outputs, and practical game-development examples.
• Unreal Engine integration page: new dedicated manual page covering the exported folder structure, installation steps, and both no-code Blueprint workflows (Actor and Actor Component).

Changed

• Entity importer warning now instructs users to copy Config/Tags/YarnDraftTags.ini into their project's Config/Tags folder and restart the editor when unregistered gameplay tags are encountered.
• Dev script (start-dev.bat) now always rebuilds the VitePress manual before launching, ensuring the bundled docs are never stale.

[0.3.2] — 2026-07-02

Added

• Native Unreal Engine export: rewrote the engine export pipeline in the Rust backend, generating a full plugin (C++ runtime module + Blueprint assets) from bundled templates instead of hand-assembled source strings. Includes an updated .uproject-aware import step in the manual.
• MCP flow-graph editing tools: the MCP server can now add dialogue/task/container nodes, connect and delete edges, and update existing nodes — previously it was read-only. Also adds a full project JSON export tool.
• AI Build ↔ Simulated Player rule unification: AI-generated flows and branches are now validated with the exact same structural and simulation checks Simulated Player uses, before being shown to you. If the plan introduces new problems, the AI automatically retries once with the concrete issue list as feedback; anything still unresolved is shown in the preview using the same issue list as Simulated Player.
• Prompt history: recent prompts for AI Build/Branch, the Dialogue Copilot, and the Entity Generator are now remembered per machine and easy to reuse.
• Top menu bar reorganized: moved to a full-width bar in the top-left, with export actions (Switch project, Export JSON, Export audio script, Export to game engine) consolidated into a new File menu, followed by Settings, Cloud Sync, and Help.

Fixed

• AI Branch build could anchor new content to the wrong existing card (or route it as a disconnected dead-end branch) when the AI's own plan disagreed with the two cards you actually selected; the branch endpoints are now enforced server-side regardless of what the AI returns.
• AI Build's retry prompt now includes the specific reason a variable/task/clue reference couldn't be resolved, instead of only the generic "not configured" symptom — the AI can correct the exact name instead of repeating the same mistake.
• Simulated Player / AI Build structure checks no longer flag a nested dialogue scene's intentionally empty top-level content as an "empty content" warning — the real lines live in the nested canvas.
• Closed several validation gaps: empty dialogue content, and invalid sourceHandle values on condition/puzzle card edges are now flagged consistently everywhere.

[0.3.1] — 2026-07-01

Fixed

• Launcher: Settings button had drifted to the top-left corner (a side effect of the hover-tooltip refactor); restored to the top-right corner.

[0.3.0] — 2026-07-01

Added

• Clone from Git: launcher action to clone a remote repository (GitHub, GitLab, etc.), validate it as a YarnDraft project, and pick a local folder.
• Dialogue node entity pre-creation: entering the nested canvas of a dialogue node now pre-creates a dialogue card for each attached speaker entity.
• New AI cloud providers: DeepSeek, Groq, OpenRouter, and Mistral, alongside the existing OpenAI/Anthropic/Gemini/local options.
• Game engine export: export the whole project as an engine-independent story graph plus a working runtime package for Godot 4 (GDScript addon) or Unreal Engine (C++ plugin + DataTables). See the new manual page under Export → Game engines.

Changed

• Card info popups (flow node help, launcher action cards, top menu bar) now open on hover instead of click, and no longer overlap or mis-position.

Fixed

• Desktop app's Content-Security-Policy now allows the new AI cloud providers' API endpoints (previously only OpenAI/Anthropic/Google were whitelisted, silently blocking the new providers).
• Unreal Engine export: generated plugin now compiles cleanly (a raw TMap parameter inside a dynamic delegate macro broke both the C++ preprocessor and UnrealHeaderTool); verified with an end-to-end build against UE 5.7.

[0.2.2] — 2026-07-01

Added

• User manual: full VitePress documentation bundled with the app. Open it from Help → User manual (inline viewer) or Open in browser (served locally by the app, works offline).
• Dialogue Export / Import dialog: exports include a Character ID column; import can create missing characters and matches speakers by ID; Print / PDF export for actor scripts.

Changed

• Refreshed application logo across app icons, favicon, and in-app branding.
• Export / Import Dialogue toolbar reorganized into a two-row header.

Fixed

• Flow editor: reliable left-click drag and hover-based resize of cards.
• Dialogue import now lays out lines as a single connected zig-zag chain on the current flow (no stray nested scenes or overlapping cards).

[0.2.1] — 2026-06-30

Added

• Help menu (after Settings): MCP setup guide, About, License, and in-app Changelog.
• Improved pin-drag connection snap for distant targets; container-output (FLOW) cards no longer produce ghost edges.

Changed

• Removed redundant AI Assistant toolbar item (AI settings remain under Settings → AI).
• Canvas toolbar layout aligned with React Flow controls; middle-mouse pan hint no longer covers buttons.
• Disk sync banner no longer triggers false positives when editing locally without MCP.

Fixed

• FLOW / enterable cards with SIKERES/SIKERTELEN output pins connect reliably when dragging edges to empty canvas or distant nodes.

[0.2.0] — 2026-06-25

Added

• Documentation for features beyond the original specification.
• MVP checklist and next priorities (development status).
• Phase status table.
• Updated folder structure (assets/, documents/, variables/ groups).

Changed

• Git integration description → Cloud sync user model.
• AI feature implementation status.
• MVP content table with status tracking.

[0.1.1] — 2026-06-25

Added

• Concrete JSON data schemas for every file type.
• Technical considerations table.
• Post-MVP roadmap.
• Mermaid architecture diagram.
• MVP scope and non-goals.
• Layered testing strategy.
• Glossary and table of contents.

Changed

• Restored Markdown formatting in chapters 3–5.

[0.1.0] — 2026-01-15

Added

• Initial specification: tech stack, Git-friendly data structure, MVP features, AI integration, and vibe-coding development guide.