Skip to content

Patterpad 0.40.0

Choose a tag to compare

@github-actions github-actions released this 29 Oct 07:44
· 153 commits to main since this release

Added

  • Resolve clashes in the app. When a merge (a returned Patterpack, or a git merge through Patter's
    merge driver) leaves clashes, a banner across the top of the window says how many, and its Resolve…
    button, or File ▸ Resolve Clashes…, opens the resolver. Each clash says where it is in words ("Line L12
    in The Tavern", "Property @gold") and shows both sides as text. Keep mine keeps your side, Take theirs
    writes theirs, and Edit takes you to the place to change it yourself, after which the clash offers Mark
    resolved. A clash that isn't one value, such as two different reorderings, offers Keep mine and Edit.
    Each choice is one step Edit ▸ Undo takes back, and a shard's .patterconflict file goes with its last
    clash. The resolver is the family's: Storyletter uses the same one.

  • Storylet cards keep their scenes. Where a Storylets project nearby is paired with this one, Patterpad
    reads its cards when the project opens and whenever you come back to the window. Deleting a scene that cards
    play, or changing its Game ID, now asks first and names them ("2 storylet cards play this scene: Tavern
    Brawl, Last Orders."). Renaming such a scene while its Game ID follows its name pins the Game ID it had, so
    the cards still find it, and a toast says so with Undo.

  • A warning for lines that never play. Anything after a snippet that always jumps, to END or anywhere
    else, now shows a warning on it in the page and the problems bar, so lines left after an END don't go
    unnoticed. A jump with a condition, a call, or a jump inside a choice's option doesn't count.

  • What's new, after an update. The first time Patterpad opens after an update, it shows what's new in that
    version, or in every version since you last ran it. Help ▸ What's New shows the latest at any time, and a
    tickbox turns the after-update window off.

  • A command palette. Press Cmd+K (Ctrl+K on Windows and Linux) to run any menu command by typing its
    name, or to open a scene, a block, or the Properties page. It lists exactly what the menus hold, greyed where
    a command can't run just now.

  • Change by, for a number. Setting a number property in an effect now offers "Change by" first: add or
    take away an amount, and Patterpad writes it as the property plus or minus that amount. Adding 1 to a
    counter is one step instead of building the sum by hand.

  • Effects show on the page. A snippet's On begin and On end effects sit beside it as a quiet line
    ("On begin: set @gold to @gold + 1"), and a scene's own effects sit under its title, so you can see what
    the story changes without opening the inspector. The Word, PDF, and editable scripts show them the same way.

  • Effects in the exported script. The Word, PDF, and editable scripts show each snippet's effects as a
    quiet line, such as "On end: sets knows_secret to true". Re-importing an edited script leaves them alone.

  • Jump to somewhere new. Type a name no scene or block has into the jump picker and it offers "+ New
    scene" and "+ New block in this scene": the jump then points at what it made. A new scene goes straight
    after the one you're in, and you stay where you are.

  • Make a property from an effect. Type a name no property has into an effect's "+ set property" picker
    and choose "+ New property": Patterpad asks whether it holds a number (the default), true or false, or
    text, adds it to the Properties page, and carries on to its value. One undo takes it back.

  • Move things from the keyboard. Ctrl+Cmd+Up and Ctrl+Cmd+Down (Ctrl+Alt on Windows and Linux) move
    the selected snippet, group, or block, or the snippet you're writing in, one place up or down, stopping
    with a quiet hint at the first or last place. Edit ▸ Move Up and Move Down do the same, and so does the
    command palette.

  • Move a scene up or down. Right-click a scene for Move up and Move down, or use the same keys, or
    Edit ▸ Move Up and Move Down, with its row focused. One undo puts it back. A new scene now goes after the
    one you're in, and stays there when you reopen the project, rather than at the bottom of the list.

  • Writing status for a scene or a block. The scene and block inspectors have a Writing dropdown showing
    the lowest status among their lines, with "Mixed" when they differ. Choosing a status raises every line
    below it and leaves the lines already further along; choosing the first rung clears them all. The ⋯ menu's
    Status follows the same rule, and either is one undo.

  • Direction in the voice script. The exported voice script has a Direction column, so an actor reads each
    line's performance direction beside it.

  • Re-record, flagged for you. Editing what a recorded or final line says now ticks its "Needs re-record"
    box, and undoing the edit unticks it. Changing only spaces or formatting, or the line's direction, doesn't.

Changed

  • New Scene makes the scene at once. File ▸ New Scene (still Shift+Cmd+N) and the "+ New scene" row
    add an "Untitled scene" straight after the one you're in and open it with its title selected, so you just
    type its name. A second one is "Untitled scene 2", and so on. To start from a scene kit, choose New Scene
    from Kit… in the same menu.

  • Show Navigator. View ▸ Show Scenes is now Show Navigator, as in Storyletter.

  • Undo names in sentence case. Edit ▸ Undo and Redo name the change the way Storyletter does: "Undo
    Move scene up", "Undo Writing status", "Undo New scene". Names such as Patterpack stay capitalised.

  • The merge's message points at the resolver. After a Merge Returned Patterpack with clashes, the
    message says how many and where to settle them, instead of pointing at the .patterconflict files.

  • Game scopes, as in Storyletter. Project Settings ▸ World properties is now Game scopes. @world comes
    first, and + Add scope adds another, such as @player, with its own name and a Remove button. Each scope
    can be read-only to the story, or take any name unchecked. A name that can't be used says why where you
    typed it. Renaming a scope renames every reference to it, in conditions, effects, and {@player.hp} in
    text, and one undo puts it all back. Removing a scope the game shares with its other tools removes it
    from game.scopes.json too. Coverage drivers can feed any scope.

  • Cmd+1 and Cmd+2 go into the pane. With the scenes list or the inspector open, the shortcut moves the
    keyboard into it (the open scene's row, in the scenes list), and closes it only when you're already there,
    taking you back to where you were. A pane you can't see is no longer in the Tab order.

  • Focus comes back after a dialog. Closing a dialog opened from the inspector, such as Scene properties
    or a note, puts the keyboard back on the button that opened it, or in the script, rather than nowhere.

  • @gold everywhere. A property of the story's own reads @gold in conditions, effects, the inspector,
    and Find Property Usage, as you'd write it; a property of any other scope keeps its name in full
    (@world.day).

  • A renamed character keeps their colour. Rename someone in Project Settings ▸ Cast and their name
    keeps the colour it had, on the page, in the play window, and in the Word and PDF scripts.

  • The speaker picker keeps up with the cast. It offers "+ Add" only for a name (up to three words, with
    no full stop or question mark), and undoing an add, or renaming someone, takes the old name out of it.

  • Spell-check in your project's language. A project whose source language is plain English ("en")
    checks spelling in your system's English, British or American, unless you pick a dictionary yourself.

  • No question with only one scene. Play from Start and Coverage no longer ask where the story starts
    when the project has only one scene: it starts there.

  • Game scopes, everywhere. The play window's advice, the merge messages, the coverage window's
    button, and the Properties page's link now say Game scopes, matching the settings tab.

  • Undo instead of "Are you sure?" Deleting a scene, Replace All, and accepting every clean suggestion
    happen straight away and say what they did, with an Undo button on the message. Edit ▸ Undo works as
    before. Merging a returned pack still asks first when the pack seems to come from another project, or when
    it changes the game's shared World file.

  • Switching scenes is instant, and undo comes with you. The next scene shows as soon as it's read,
    without waiting for the one you left to finish saving. The last eight scenes you visited keep their undo
    history, so you can go back to a scene and undo there, and Undo after a switch works back into the scene you
    came from, showing it first. A scene whose files changed while you were away opens fresh.

  • Updates don't interrupt. When an update has downloaded, a "Restart to update" button appears in the
    top bar instead of a dialog over your work. It installs when you next quit if you'd rather not restart now.

  • A scene somebody else holds is easier to read. Its locked fields and buttons keep their text at full
    strength, so you can read every value; they show they're locked with a dashed edge and a no-entry cursor,
    and the notice above the document still says who holds it. The inspector is no longer dimmed as a whole.

  • A cleaner, crisper look, shared with Storyletter. The two apps now have the same colour themes: Light and
    Dark, which follow your system until you pick one, and Parchment, a warm option for long writing sessions. Blue
    is the one accent colour, and every text colour meets the usual contrast guideline in every theme. If you'd
    picked Paper or Mist you're now on Light, and Slate or Night are now Dark. The interface uses your system's own
    typeface, with quieter corners and shadows, white fields, and menus that open
    straight away.

  • A calmer inspector. It shows what you've set, not every property a node could have: the rest wait in
    one Add menu under each section. The line and its snippet stay open, while the option, group, block, and
    scene above them fold to one line saying what they set, and Patterpad remembers which you keep open. An
    option's Sticky, Fallback, and Secret are one row of buttons.

  • The script is a page. Each block is one white page with its title on it, and its snippets run down it
    as a script instead of sitting in separate cards. A thin rule beside each snippet shows where it starts
    and ends, at any depth inside a choice, and the snippet you're writing in has its rule in blue. Point at a
    snippet and its drag handle appears in its rule, with its menu at the end of its first line; only the
    thing you're pointing at shows a menu, never every group around it. A problem colours that snippet's
    rule, or that option's line, rather than adding a bar beside it.

  • Hover is calmer. A snippet's drag handle and menu, the "+" controls, and the inspector's buttons fade in
    after a moment and fade out gently, instead of blinking, and a highlight eases rather than snapping. A jump
    no longer lights up a block of colour when you point at it; its target underlines instead. Reduce Motion
    turns all of it off.

  • Names hang in the margin. A character's name sits right-aligned in a column to the left of their line,
    so speech, narration, game events, and jumps all start at one edge, as in a prompt book. A long name runs
    out into the margin rather than pushing the line along.

  • More room for the script. The editor's margins are narrower, and a jump sits at the text's left edge,
    drawn as an arrow and its target (a call has its own loop icon). A choice's options are marked by a small
    diamond on their line instead of a tinted box and an "Option" label.

  • Renaming a scene looks like editing. While you're in the scene's title, a blue line runs under it,
    instead of the system's focus box in your Mac's accent colour.

  • Change several snippets at once. When you select more than one snippet, the inspector shows what
    they share: their condition, jump, default pause, and tags, with "Mixed" where they differ. A change there
    applies to all of them, and one Undo takes it back. A tag only some of them carry shows how many, and you
    can add it to the rest or remove it from all of them.

  • Dialogue fits a narrow window. When the script column is narrow, a line's character name sits on its
    own line above the speech, with any direction under it, as in a screenplay, instead of squeezing the speech
    into a column one word wide.

  • A quieter navigator. Scenes are listed at an even weight, the open one marked by a soft fill, and Find
    looks like the search field it opens.

  • The font theme changes only the script. View ▸ Font Theme no longer changes the typeface of the menus,
    panes, and dialogs.

  • Translation import checks the file. A file for one language won't import as another: pick the language
    the file is for, or leave Template picked and Patterpad uses the file's. Lines the project no longer has are
    skipped rather than written, and the import lists them, along with any translation whose placeholders or
    formatting don't match the source. Excel exports now say which language they're for; an older spreadsheet
    still imports as the language you pick, with a warning to check it.

Fixed

  • The inspector's Jump row fits a narrow inspector. A long target name used to run over the Jump and
    Call toggle beside it. The toggle now moves under the name when there isn't room for both.
  • A jump isn't called missing while a project is still opening. Opening a project on a scene you'd left
    it in, a jump to another scene could read "Missing scene" or "Missing block" for a moment, until the rest
    of the project had loaded. It now reads "…" until then, and only a target that really has gone is missing.
  • Status badges keep up with the inspector's divider. Dragging the divider left the badges beside the
    lines where they'd been until something else moved them. They now follow the lines as the page resizes.
  • The ⋯ button doesn't hide the end of a line. At some window widths the end of a snippet's first line
    ran under its ⋯ button. That line now leaves the button room.
  • Production Information's scroll button doesn't cover the report. The button that pages the report
    sat over it and could hide a table's headings, such as Written. It now has its own space under the report.
  • A jump into a scene you haven't opened yet lands on its line. Edit in the clash resolver, a search result,
    or a problem in a scene opened for the first time that session could stop part-way down the page, because
    the blocks above hadn't been drawn yet. It now settles on the line.
  • Status badges and Settings' buttons aren't cut off in a small window. With Review ▸ Line Status on, the
    pills beside the lines were cut off at the editor's left edge in a narrow window; the margin now makes room
    for the widest one showing. A long status name in the inspector ends in an ellipsis instead of running past
    a narrow inspector's edge, and Project Settings keeps Save and Cancel in view at the smallest window height.
  • Your name is offered before a project is open. The box asking for your name for comments and edits
    now fills in git's global user.name when no project is open, as Storyletter does. It used to come up
    empty in the installed app until a project was open.
  • The game's scopes file keeps up with the project. Where the game shares its scopes, patter.scopes.json
    is now brought up to date with every change to the project file (a pack merge, a new or deleted scene, the
    cast, a quick fix, and an undo or redo of any of them), not only when Project Settings are saved, as
    Storyletter does with its own.
  • A deleted jump target says so. A jump or condition whose scene or block has been deleted reads
    "Missing scene" or "Missing block" in red, on the page and in the inspector, with the old id in its
    tooltip, instead of showing the raw id.
  • A scene changed outside Patterpad is no longer overwritten. If a scene's files changed on disk after
    Patterpad read them (a pull in a terminal, a synced folder, another app), the next save used to write the
    editor's copy over them. Now the save is refused, the scene is read again so you see the change, and a
    message asks you to check your last edit is still there. Reopening a scene also reads it from disk if it has
    changed, rather than showing the copy Patterpad had in memory.
  • A comment appears as soon as you post it. A reply posted with the Reply button didn't show until the comment
    popover was closed and opened again, and a second post on a new comment started a second thread. The popover
    now shows each thread as it stands after every change.
  • Restart plays what the editor shows. Restarting the play window straight after an edit could play the
    script from before it until the edit was saved: an edit in a scene the run had jumped into showed live, then
    went back to the saved copy on Restart, and an edit made just before Restart could be missed. The editor's
    text is now written before every run starts, and Restart plays the latest edit in whichever scene it's in.
  • A coverage run includes the edit you've just made. Running coverage straight after fixing what a row
    reported could sweep the script from before the fix, so the row stayed in the table. The editor's text is
    now written before the sweep starts.