Events editor

When you open a scene (or external events), the Events Editor is present as a tab.

The Events Editor is where you add the events that create the actual gameplay. All the “rules” of your game can be created using events. The Events editor is a tool that gives you the power to visually program your game. Events are readable by anyone and can be authored without advanced programming knowledge.

When editing a scene, to switch between the Scene editor and the Event editor, use the tabs at the top of the window.

When you switch to the Events editor, you will see that the toolbar changes to display new tools:

Add an event

Add an event by clicking the “add event” button

When you click this button a blank event will appear on the screen below in the editor

You can add any number of event blocks to the Event editor. Each event can have various conditions and actions. Once you add an event, you can use the conditions and actions to create the game's logic. Learn more about events, on this page: Events.

Add a sub-event

By clicking the “Add a sub-event” button, you can add a “child event” block to the selected event.

After clicking the button, a blank sub-event appears below our selected event.

Sub-events are executed only if the parent event's condition(s) are true. Sub-events provide a way to avoid repeating the same conditions. They make the logic much easier to read.

Add a comment

By clicking the “Add a comment” button, you can add comments to the list of events. Comments are useful to add explanations to complex events. They can contain any arbitrary text.

Comments are an important part of any game or application. They help you to organize your events and give an opportunity to add notes or explanations about what the events are doing.

Add other events (for each, repeat, while...)

By clicking the “Add an event” button, along with the ones we already mentioned, we have access to some special events.

Read the help about events to learn more.

Editing events

You can edit events on an event sheet by right clicking on the event you want to edit. A will list appear that shows some things you can do.

There are some common actions like copying, pasting, cutting, deleting, undo, redo, etc.. But, there are also other actions you can do like Toggle disabled, Analyse Objects Used in this Events, Move events into group, etc.. Some are discussed below.

Toggle disabled

Disables the selected event and it's sub-events. It won't be executed when the project is running. The disabled events will have a strike-through text on the actions and conditions.

Add a Event Below

Add a New Event Below

Adds an empty event under the selected event.

Add a Sub Event Below

Adds an empty sub event under the selected event.

Add Other

Allows you to add other events like comments, group, while, repeat for each, etc..

Extract Events to a Function

Extracts the selected event and it's sub events into a function.

Read Extract Events to a Function to learn more.

Move events into a group

Makes a group that includes the selected event and it's sub-events into a group.

Read Group of events to learn about groups.

Analyse Objects Used in this Events

Analyses and shows a list of all the objects, object groups and behaviours used in the selected events and it's sub-events.

Changing the colour of comments and groups

You can change the colour of comments and group events by right clicking and Edit.

You can only change the background colour of group events .You can change both the background and text colour of comments. The text colour is automatically set according to the contrast for group events.

Editing a comment:

Editing a group:

Delete selected events

By clicking the Delete selected events button, selected events will be removed from the event sheet (you can also press Delete key):

Undo/Redo changes

Any change can be undone or applied again with these buttons (or the usual shortcuts):

Search in events

The “search in events” button opens a panel on the bottom of the screen. You can search for a specific term in the parameters of the conditions and actions. You can also enter a replacement parameter and replace all the occurrences of the text in the events.