diff --git a/tutorial_instancing.md b/tutorial_instancing.md index 39f8a06..d0dafba 100644 --- a/tutorial_instancing.md +++ b/tutorial_instancing.md @@ -6,15 +6,15 @@ Having a scene and throwing nodes to it might work for small projects, but as a To recap: A scene is a collection of nodes organized as a tree, where they can have only one single node as the tree root. -

+

In Godot, a scene can be created and saved it to disk. As many scenes can be created and saved as desired. -

+

Afterwards, while editing an existing or a new scene, other scenes can be instanced as part of it: -

+

In the above picture, Scene B was added to Scene A as an instance. It may seem weird at first, but at the end of this tutorial it will make complete sense! @@ -24,24 +24,54 @@ To learn how to do instancing, let's start with downloading a [pre-made scene](m Unzip this scene in any place of our preference. Then, add this scene to the project manager using the 'Import' option: -

+

Simply browse to inside the project location and open the "engine.cfg" file. The new project will appear on the list of projects. Edit the project by using the 'Edit' option. This project contains two scenes "ball.scn" and "container.scn". The ball scene is just a ball with physics, while container scene has a nicely shaped collision, so balls can be thrown in there.

-

+

Open the container scene, then select the root node: -

+

Afterwards, push the '+' shaped button, this is the instancing button! -

+

Select the ball scene (ball.scn), the ball should appear in the origin (0,0), move it to around the center of the scene, like this: -

+

+ +Press Play and Voila! + +

+ +The instanced ball fell to the bottom of the pit. + +###A Little More + +There can be as many instances as desired in a scene, just try instancing more balls, or duplicating them (ctrl-D or duplicate button): + +

+ +Then try running the scene again: + +

+ +Cool, huh? This is how instancing works. + +###Even More! + +Select one of the many copies of the balls and go to the property editor. Let's make it bounce a lot more, so look for the bounce parameter and set it to 1.0: + +

+ +The next it will happen is that a green "revert" button appears. When this button is present, it means we modified a property from the instanced scene to override for a specific value in this instance. Even if that property is modified in the original scene, the custom value will always overwrite it. Pressing the revert button will restore the property to the original value that came from the scene. + + + +