diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/add-behavior.png b/docs/gdevelop5/behaviors/events-based-behaviors/add-behavior.png new file mode 100644 index 00000000000..1002642e5d4 Binary files /dev/null and b/docs/gdevelop5/behaviors/events-based-behaviors/add-behavior.png differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/behavior-description.png b/docs/gdevelop5/behaviors/events-based-behaviors/behavior-description.png new file mode 100644 index 00000000000..31883211cb9 Binary files /dev/null and b/docs/gdevelop5/behaviors/events-based-behaviors/behavior-description.png differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/behavior-function.png b/docs/gdevelop5/behaviors/events-based-behaviors/behavior-function.png new file mode 100644 index 00000000000..160e66ae369 Binary files /dev/null and b/docs/gdevelop5/behaviors/events-based-behaviors/behavior-function.png differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/custom-behavior-action-events-sheet.png b/docs/gdevelop5/behaviors/events-based-behaviors/custom-behavior-action-events-sheet.png deleted file mode 100644 index 5455e6bb3fe..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/custom-behavior-action-events-sheet.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/do-step-pre-events.png b/docs/gdevelop5/behaviors/events-based-behaviors/do-step-pre-events.png new file mode 100644 index 00000000000..d4bc67feb76 Binary files /dev/null and b/docs/gdevelop5/behaviors/events-based-behaviors/do-step-pre-events.png differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/index.md b/docs/gdevelop5/behaviors/events-based-behaviors/index.md index 1c167c1a1bf..7e92082a7c9 100644 --- a/docs/gdevelop5/behaviors/events-based-behaviors/index.md +++ b/docs/gdevelop5/behaviors/events-based-behaviors/index.md @@ -33,11 +33,11 @@ Click on the **+** button at the top-right of the **Extensions** section. Then, By default, extensions don't have any behavior. Add one by clicking on the "+" button on the left next to **Behaviors**. -![](/gdevelop5/events/functions/empty-extension.png) +![](add-behavior.png){ width="555" } You can choose the description and the name to display to users when they will add your behavior to an object. You can also set a custom icon and a help page link for the behavior — this is especially useful when an extension provides multiple behaviors, so each one can be visually distinguished. If you need to use a specific object (sprites, texts...), you can choose it with the drop-down list at the bottom. -![](pasted/20210906-234834.png) +![](behavior-description.png) Behaviors can also embed properties, which are number, strings or booleans that are stored inside the behavior. Check out the section below about how to add and use properties. @@ -61,7 +61,7 @@ Events from the **doStepPreEvents** function are run every time a frame is rende The following `doStepPreEvents` function events automatically deletes objects that are too damaged: -![](pasted/20210906-235321.png) +![](do-step-pre-events.png) ### Add custom action, condition or expression @@ -76,7 +76,7 @@ Behaviors and the scene events communicate through functions: For example, this function defines an action that can be used to add damage to the object: -![](pasted/20210906-235538.png) +![](behavior-function.png) ### Run events at other lifecycle key times @@ -95,11 +95,11 @@ Once your behavior is created, you can start attaching it to objects. The best p Here, you can see the "Destructible Object" behavior for example (that was created in the previous screenshots): -![](pasted/20210907-000055.png) +![](user-side-behavior-list.png) The custom behavior that you created is then displayed in the list of the behaviors attached to the object: -![](pasted/20210907-000202.png) +![](user-side-behavior.png){ width="499" } You can run the game and see that the events in the `doStepPreEvents` function (or `doStepPostEvents`) will be executed. In the example of the Destructible behavior that was created, if the "Damage" variable is set to a number greater or equal to 100, the object will be destroyed automatically. @@ -111,10 +111,10 @@ To test this, we've added the "Destructible" behavior to object "Platform". Then Like any other "built-in behavior", you can also use actions/conditions (or expressions) if you have declared functions as such in the behavior. For example, in the "Destructible" behavior, we created an action to cause some damage to the object. We can find it and use it in the events sheet: -![](pasted/20210907-000606.png) +![](user-side-behavior-action.png) It is displayed in the events sheet: -![](custom-behavior-action-events-sheet.png) +![](user-side-events.png) As you can see, this allows creating very expressive and easy-to-read events. You can then make the behavior more complex or reuse it on other objects. diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234510.png b/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234510.png deleted file mode 100644 index bf03aa6f6fd..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234510.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234614.png b/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234614.png deleted file mode 100644 index 4cd88cdeb6c..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234614.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234834.png b/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234834.png deleted file mode 100644 index f3a2db78d8e..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-234834.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-235321.png b/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-235321.png deleted file mode 100644 index a9513d5ad61..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-235321.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-235538.png b/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-235538.png deleted file mode 100644 index 7f5bb7c330e..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210906-235538.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000055.png b/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000055.png deleted file mode 100644 index a235b5e47c1..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000055.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000202.png b/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000202.png deleted file mode 100644 index db5ab0e77cd..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000202.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000606.png b/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000606.png deleted file mode 100644 index 954a1a6fd77..00000000000 Binary files a/docs/gdevelop5/behaviors/events-based-behaviors/pasted/20210907-000606.png and /dev/null differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior-action.png b/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior-action.png new file mode 100644 index 00000000000..d6b144d5e17 Binary files /dev/null and b/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior-action.png differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior-list.png b/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior-list.png new file mode 100644 index 00000000000..a750e390098 Binary files /dev/null and b/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior-list.png differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior.png b/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior.png new file mode 100644 index 00000000000..4f9c9a50300 Binary files /dev/null and b/docs/gdevelop5/behaviors/events-based-behaviors/user-side-behavior.png differ diff --git a/docs/gdevelop5/behaviors/events-based-behaviors/user-side-events.png b/docs/gdevelop5/behaviors/events-based-behaviors/user-side-events.png new file mode 100644 index 00000000000..8b6882e3073 Binary files /dev/null and b/docs/gdevelop5/behaviors/events-based-behaviors/user-side-events.png differ