Skip to content

Elements

Part of an Arcweave flowchart showing 3 elements connected to each other.

Elements are the most important flowchart items. They are the building blocks of your flowcharts, as each of them contains a small fragment of your story. By connecting elements together with connections, you create your story flow, allowing the player to make choices and progress through your game.

You can play-test the flow of your elements and connections on Play Mode.

Creating elements

There are 3 ways to create an element:

  • Double click on an empty area of the current board.
  • Right click on an empty area of the current board and select Create Element from the menu.
  • Drag and drop the New element icon (at the left of the bottom menu) on a empty area of the current board.

Selecting elements

To select an element, simply click on it. To select multiple elements, hold Shift or Ctrl/Cmd and δο either of the following:

  • Click each element consecutively.
  • Click and drag to create a selection rectangle.

✅ You can similarly select connections, notes, and jumpers.

Deleting elements

To delete an element, you can do either of the following:

  • Select the element and press Delete or Backspace.
  • Right-click on it and select Delete from the menu.

Editing elements

Each element has a title (the top, coloured part) and a content area (the main black part). To edit either, simply doubl e-click on it.

To cycle editing between title and content, press the tab key.

To exit editing mode press Esc or click on an empty area of the board.

Formatting menu

Elements support rich text format in both title and content. From the formatting menu, choose bold, italics, or underline.

Screenshot of an element in edit mode, showing the rich text formatting menu.

Format a paragraph as blockquote, to make its text stand out as a quote or a sign.

Similar screenshot with the previous one, where a paragraph has been turned into a blockquote.

You can also embed a link to a selected piece of text.

Similar screenshot with the previous ones, where some text has been selected and turned into a link.

Markdown formatting

Type *one asterisk* or _one underline_ and it will automatically transform to italic text while you type.

Type **two asterisks** or __two underlines__ and it will automatically transform to bold text while you type.

You may also use the usual shortcuts of Ctr/Cmd+B, Ctr/Cmd+I and Ctr/Cmd+U for bold, italic, and underlined text respectively.

Resizing elements

To resize an element manually, select it and drag any of its corners or edges.

To set it to auto-resize, so it continuously adjusts to fit its content, double-click any edge or corner handle.

Changing theme

To change the color theme of an element, right click on it and select one of the available colors from the menu.

Setting a cover

Elements can have an image or video asset as cover. On Play Mode, the image or video renders above the element's text content.

A split screen view of an Arcweave project and its Play Mode. The focus in both sides is the starting element, with orange rectangles and an arrow emphasizing how the element's cover renders as featured image in Play Mode

As covers, you can use your project's image assets, video assets, icons from Arcweave's icon library, or emebed a Youtube video. To assign a cover image from either sources:

  • Right-click on the element.
  • Select Set cover.
  • Select a tab: My Assets or Icon Library or Embed.
  • Choose an image or video asset, an icon, or paste a youtube video URL respectively.

The modal for setting an element cover, open at the My Assets tab, showing the project's available image assets.

ℹ️ To use your own images in a project, you must upload them as assets.

Another way to assign a cover is to drag an image or video asset from the Assets section of the sidebar straight into the desired element.

Animated GIF demonstrating how to create an element cover by dragging an image from the Assets

To change an element's cover, select Set cover again or drag a new asset into it.

To remove an element's cover, right-click on the element and select Remove cover.

Audio attachments

Elements can optionally have one or more attached audio assets. The audio assets play during Play Mode, upon the element's rendering, as loops or one-shots.

Attaching

To attach an audio file to an element, take the following steps:

  1. Upload the audio file to your project (see Assets).
  2. Locate the asset in your project's Assets section.
  3. Drag and drop the asset from your Assets section into the element.

Once attached, click on the asset to open its settings menu, where you can set its behavior.

Moving

To move audio assets between elements, drag them from one element and drop them into another.

Removing

To remove an attached audio asset, drag and drop it from the element to an empty area of the board.

ℹ️ Removing an audio asset from an element simply removes the reference and does not delete the asset.

Attaching components

You can attach components to an element to visually reference them in the story flow, both in the boards and in Play Mode. See components for all information.

Adding arcscript

Finally, you can add arcscript segments to your element content, assigning values to variables or manipulating the text output.

An Arcweave element containing rich text and arcscript code segments.

To insert an arcscript segment into an element's content:

  1. Double-click the element to enter content editing mode.
  2. Place the cursor on the line where you want to insert the arcscript segment.
  3. Click the Arcscript segment icon in the formatting toolbar.
  4. Press Enter to exit the arcscript segment and continue writing in the next line.

✅ You can also toggle an arcscript segment using the shortcut Ctrl/Cmd + Shift + C.

Element attributes

An element can hold the following 4 types of attributes:

  • Rich text
  • String
  • Component list
  • Asset list

The same types of attributes are also available to components.

See attributes for all information.