⬜ Add to list

The Add to list block allows you to add a new element at the end of an existing list. It is essential for managing collections of objects, choice histories or any group of dynamic values.

This block is particularly useful for modifying previously created "List" type variables, such as a player inventory or an action register.

📥 Entries

• in (Signal): Triggers the addition of the element to the list. Must be connected to the story flow.
• variable (List): Selection of the list to modify. The type of this list (Text, Number, etc.) determines the expected format for the value to add.
• value (Dynamic type): Value to add to the list. Can be connected from another block or entered directly if the type allows it.

📤 Outings

• out (Signal): Activates once the element is added to the list, allowing the flow of the scenario to continue.

💡 Example of use

Scenario: Adding an item to the player's inventory

1. The player finds a “Steel Sword” item in a room.
2. The game displays a message: "You have found a Steel Sword!".
3. The Add to list block is placed in the flow.
4. The variable L: Inventory (of Text List type) is selected in the variable field.
5. The value "Steel Sword" is connected to the value input.
6. The out signal triggers an interface update to display the new inventory.

⚙️ Technical Details

• Type management: The block automatically adapts to the type of the selected list (Text, Number, Boolean, etc.). The added value must correspond to this type.
• Behavior: If the list does not exist or is null, the block does not generate an error but does not perform any action. The element is always added in the last position.

Updated on: 04/03/2026