Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
gdevelop5:interface:events-editor [2018/10/06 20:24]
valiant_curiosity [Events editor]
gdevelop5:interface:events-editor [2021/11/22 23:06] (current)
Line 1: Line 1:
 # Events editor # Events editor
  
-When you open a Scene or any External events, the Scene Events editor is presented on the tab above the opening window. +When you open a scene (or external events), the Events Editor is present as a tab:
  
-{{:gdevelop5:interface:sceneeventstab.png?600|}}+{{ :gdevelop5:interface:sceneeventstab.png?nolink |}}
  
-The Events Editor is where you add the events that create the actual gameplay. It allows the game players to play and interact with your game.  +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. You do not need to have any programming or coding experience//Anyone can make a game in GDevelop!//+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.
  
-To switch between the [[gdevelop5:interface:scene-editor|Scene editor]] and the Event editor you use the tabs at the top of the window.+When editing a scene, to switch between the [[gdevelop5:interface:scene-editor|Scene editor]] and the Event editoruse the tabs at the top of the window.
 {{ :gdevelop5:scene-events-tab.png?nolink |}} {{ :gdevelop5:scene-events-tab.png?nolink |}}
  
-When you switch to the Events editor, you will see that the toolbar has changed. Now there are a different set of tools available:+When you switch to the Events editor, you will see that the toolbar changes to display new tools:
 {{ :gdevelop5:events-editor-toolset.png?nolink |}} {{ :gdevelop5:events-editor-toolset.png?nolink |}}
  
-## Add event +## Add an event 
-We can add an event by clicking the add event button+ 
 +Add an event by clicking the "add eventbutton
 {{ :gdevelop5:add-event-button.png?nolink |}} {{ :gdevelop5:add-event-button.png?nolink |}}
  
-When you click this button a blank event will appear in the editor+When you click this button a blank event will appear on the screen below in the editor
 {{ :gdevelop5:blank-event.png?nolink |}} {{ :gdevelop5:blank-event.png?nolink |}}
  
-You can add any number of event blocks to the Event editor. Then you can add various conditions and actions to each event block in order to create the game's logic. You can learn more about events, on this page: [[gdevelop5:events|]].+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: [[gdevelop5:events|]].
  
-## Add sub event +## Add sub-event 
-By clicking the add sub-event button, we can add a child event block to the selected event. + 
 +By clicking the "Add a sub-eventbutton, you can add a "child eventblock to the selected event. 
 {{ :gdevelop5:sub-event-button.png?nolink |}} {{ :gdevelop5:sub-event-button.png?nolink |}}
  
-After clicking the button, a blank sub event appear below our selected event+After clicking the button, a blank sub-event appears below our selected event.
 {{ :gdevelop5:blank-sub-event.png?nolink |}} {{ :gdevelop5:blank-sub-event.png?nolink |}}
  
-Sub events are executed only if the parent event's condition(s) are true, this way we can avoid repeating the same conditions, making the logic much easier to read.+//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 ## Add a comment
-By clicking the add comment button, we can add comments to our events. Comments help us remember which events fit what purpose+ 
 +By clicking the "Add a commentbutton, you can add comments to the list of events. Comments are useful to add explanations to complex events. They can contain any arbitrary text.
 {{ :gdevelop5:add-comment-button.png?nolink |}} {{ :gdevelop5:add-comment-button.png?nolink |}}
  
-Comments are an important part of any game. They help you to organize and remember exactly what the event and action logic is doing.+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.
 {{ :gdevelop5:comment-in-editor.png?nolink |}} {{ :gdevelop5:comment-in-editor.png?nolink |}}
  
-## Add special events +## 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+ 
 +By clicking the "Add an eventbutton, along with the ones we already mentioned, we have access to some special events.
 {{ :gdevelop5:add-special-events.png?nolink |}} {{ :gdevelop5:add-special-events.png?nolink |}}
  
 Read [[gdevelop5:events|the help about events]] to learn more. Read [[gdevelop5:events|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.
 +
 +{{ :gdevelop5:interface:editingevent1.png?nolink&600 |}}
 +
 +###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.
 +
 +{{ :gdevelop5:interface:editingevent2.png?nolink& |}}
 +
 +###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 [[gdevelop5:events:functions:extract-events|]] 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 [[gdevelop5:events:group|]] 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.
 +
 +{{ :gdevelop5:interface:editingevents5.png?nolink&600 |}}
 +
 +###Changing the colour of comments and groups
 +
 +You can change the colour of **comments** and **group events** by right clicking and **Edit**.
 +
 +<note tip>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**.</note> 
 +
 +Editing a comment:
 +{{ :gdevelop5:interface:editingevents6.png?nolink&600 |}}
 +
 +{{ :gdevelop5:interface:editingevents7.png?nolink&600 |}}
 +
 +Editing a group:
 +{{ :gdevelop5:interface:editingevents8.png?nolink&600 |}}
 +
 +{{ :gdevelop5:interface:editingevents9.png?nolink&600 |}}
  
 ## Delete selected events ## Delete selected events
  
-By clicking the Delete selected events button, events selected will be removed from the sheet (you can also press Delete key):+By clicking the Delete selected events button, selected events  will be removed from the event sheet (you can also press Delete key):
 {{ :gdevelop5:delete-selected-events-button.png?nolink |}} {{ :gdevelop5:delete-selected-events-button.png?nolink |}}
  
Line 55: Line 122:
  
 ## Search in events ## Search in events
-The search in events button opens a panel on the bottom on the screen so you can search for a specific term in the parameters of the conditions and actions. You can also enter a replacement and replace all the occurence of the term in the events.+The "search in eventsbutton 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.
  
 {{ :gdevelop5:search-events-button.png?nolink |}} {{ :gdevelop5:search-events-button.png?nolink |}}
 +
 +