Pular para o conteúdo

Mais recursos da ferramenta

Importador de texto

Importe seu texto em massa e preencha previamente os nós com personagens, escolhas e conexões.

Por enquanto, esta aula está disponível em inglês.

IN THIS LESSON

Bring Your Story to Life: Import Your Content with Ease!

You can bulk-import your text and pre-populate nodes with characters, choices, and connections! Here's how. Download the template to get started.

Title slide for the Text Importer lesson

Why Import Your Text?

Importing your script directly into our platform can speed up your creation process by 10x. No more copy-pasting line by line, just import, tweak, and you're ready to roll!

Spreadsheet template laid out with columns for characters, choices, and connections

Building Your Script

You don't have to have your script finished to import it! After importing nodes, you can import additional ones anytime you want!

  • You must use a sheet. You cannot use a simple word doc. This is because the importer reads the different columns as different data.
  • You must add your locations and characters to the engine before importing if you want these to connect appropriately.
Engine panel for adding locations and characters before importing a script

To create a choice, start a new node:

Spreadsheet rows showing how a choice node is laid out across the columns
  1. Add a character in column A. This character will appear on the choice screen.
  2. In column B add #CHOICE: with the text for the prompt. This can be no longer than 40 characters.
  3. Add at least 1 option and no more than 3 in column B under this.
  4. In column C next to the options, write #-> node_name for where you want this choice to lead.
  5. Then, create new nodes for what happens after these choices.
  6. At the end of each branch, set up a #-> that tells it where to go next!
Spreadsheet showing a #-> line at the end of a branch pointing to the next node

To make a choice cost money, simply change the line to say #premium with a number (how many hearts). You can add #bonus if you want it to include a highlight.

Spreadsheet showing a choice line marked #premium with a heart amount and an optional #bonus tag
Example of a #premium choice line with a heart cost in the import sheet

Using Choice Memory

Remember, you will need access to choice memory for this to work. If you don't have it already, apply for access.

Spreadsheet rows demonstrating choice-memory lines in an imported script

To remember that a memory is being changed, simply write a #remember line that changes an existing memory from your Memory Bank.

A #remember line in the sheet updating an existing Memory Bank value

You can also check your character score and branch based off of it using the language:

#check: if [MEMORY] > number, if yes goto [nodename1], if no [nodename2]

You can check the memory is greater (>), lesser (<), or exactly (=).

#check: max [MEMORY1] [MEMORY2] [MEMORY3], if [MEMORY1] goto [nodename1], if [MEMORY2] goto [nodename2], if [MEMORY3] goto [nodename3]
Spreadsheet showing a #check: max line branching to a different node per memory

Importing Your Script

When you click "import as text," a new window will appear. Copy and paste the contents of your spreadsheet there.

Click validate. If you have made any errors in your importer, your script will tell you by highlighting the cell in red. Hover over the i icon to understand what you did wrong.

Importer validation result with an error cell highlighted in red and an info icon