getting_started/step_by_step/instancing

[giscus[bot]]

getting_started/step_by_step/instancing

In the previous part, we saw that a scene is a collection of nodes organized in a tree structure, with a single node as its root. You can split your project into any number of scenes. This feature ...

https://docs.godotengine.org/en/stable/getting_started/step_by_step/instancing.html

[TheApproStorm]

Help, whenever i try to open the instancing project the whole thing crashes

[Calinou]

Which Godot version are you using and what graphics card model do you have?

The instancing starter uses the Forward+ rendering method, which may not work if your GPU doesn't support Vulkan. You could try opening the project with the --rendering-method gl_compatibility command line argument as a workaround.

Eventually, all starter projects should be made to use Compatibility (as they don't use advanced graphics features), but this might work for now.

[v012345]

use Godot Engine v4.3.stable , I can open the project and run well

[brianhsu]

Use Godot 4.3 stable on Linux also works fine for me.

[rreshrr]

hi. me helped installing vulkan lib

[Pascal-CP]

I think the "Weapon" box above the "Player Ship" box in the shooter game diagram should be called "Player" ?

[BhavinTheGreat]

@Pascal-CP its correct as its referring to the weapon that may be put or installed on the ship like a battleship.

[rvelasquez]

@BhavinTheGreat Missile is an instance of Enemy, perhaps a more specific name would make it clear like ShipWeapon/Canon/Turret would make it more clear?

[BhavinTheGreat]

@BhavinTheGreat Missile is an instance of Enemy, perhaps a more specific name would make it clear like ShipWeapon/Canon/Turret would make it more clear?

yup that would do too

[v-kydela]

But why is a weapon instantiating a weapon? Should it be instantiating a bullet perhaps?

[das-nayan]

"To make a resource unique for one instance, right-click on it in the Inspector and click Make Unique in the contextual menu." Make Unique is not showing in the contextual menu for Gravity Scale resource, even though it isn't unique. Please correct me.

[Calinou]

Gravity Scale is not a resource, but a property of the RigidBody2D node. This is what you should click instead:

[das-nayan]

Thank you!

[bill-in-iowa]

I think it would clear up confusion if you say right click on PhysicsMaterial instead of saying right click on it!!.

[Calinou]

Pull request opened:

• Tweak note about making Physics Material unique in Creating instances godot-docs#10032

[Josias-Cruz]

When I tried to import the project I just got a black screen with the project tile at the top,

I'm on Windows 10, and Intel(R) HD Graphics 520

[MuJame]

So if I make a game with multiple playable characters with unique abilities each, i should make a basePlayer and then instantiate? Do I do that for the levels as well?

[rvelasquez]

Yes, this is quite common. In basePlayer you would have shared attributes that all players have in common. Similar with levels. However, usually in object oriented languages you just call it Player, not basePlayer.

[YasinMahdizadeh]

Hi, Thanks for the great documentation!

In shooter game diagram, many arrows enter the stage scene and tip of arrows form a circle like shape, That was hard to read and it took me some time to figure out that they are actually arrows.

[stann-co]

it's not clear from this how to instance from code

[Calinou]

The Scripting languages page comes after this one, so I think it's by design that instantiating from code is not mentioned.

We could add a quick mention of using PackedScene.instantiate(), but it may be confusing for those who are reading the documentation in order and have never used a scripting language before.

[stann-co]

I found the article through google, whilst searching for "in code" And it didn't stand out to me in the page overview, maybe it could be added to the name of whatever page it shows up on.
The real fault is probably just on google SEO

[jakeometer]

Hello, I don't seem to have "PhysicsMaterial" under Inspector for the ball, can anybody help please?

[chihwahli]

Please help, there is no text or button to create PhysicsMaterial at all. I opened everything in the inspector of the ball.tscn.
Might be more handy to change the tutorial. Cannot continue.

[Piralein]

Does your ball.tscn contain a node called Ball with the type RigidBody2D?
You can mouseover the Ball node in the scene tree to see its type.

If you select this node it should show a RigidBody2D group inside the inspector, it should contain the PhysicsMaterial.
If not, what properties are displayed and how is the uppermost group called?

[azrael4h]

There isn't a type called RigidBody2D in the inspector. There's a CollisionShape2D, Node2D, CanvasItem, and Node shown in the inspector when selecting the Ball.tscn in the file system. Furthermore, there is no means to actually add PhysicsMaterial; rightclicking on any of those just brings up a documentation drop box, and left clicking just selects them in the inspector.

None of those have the RigidBody2D under them either. It does not exist under the Ball.tscm node. Godot 4.3, just downloaded both the updated Godot and the asset files today.

[azrael4h]

Selecting Main.tscm does have the RigidBody2D, but you cannot actually edit the properties of the PhysicsMaterial. The Bounce, Friction, etc... is greyed out and inaccessible.

[Grimslip]

I struggled with this for a while, until I realised that "Ball" was not selected in the Scene. I had selected the ball by clicking on it in the viewport, which in turn selected the CollisionShape2D node. Once I clicked on Ball in the Scene panel, all was well.

[mirkojotic]

The arrows tell you which scene owns which.

is this per chance meant to mean:

The arrows point to the owner of the scene.

[Calinou]

Yes 🙂

Pull request opened:

• Clarify the meaning of instancing diagram arrows in Creating instances godot-docs#10487

[UkaSystems]

Why not add a simple code examples for instancing?

[Calinou]

This tutorial comes before the Scripting languages tutorial, so it would be counter-intuitive if code was mentioned before you've learned about it.

However, I've added a link to the other tutorial that specifically covers instancing scenes through code:

• Clarify difference between Godot's scene instancing and hardware instancing godot-docs#10622

[danieljacobsen-ai]

"The arrows tell you which scene owns which."

What does that even mean? Owns = is the abstract scene resource for? There is no textual description here of how one scene can "own" another.

It seems that some arrows mean "contained in", for example a table scene instances is placed insides a room scene instance, and therefore there is an arrow from "table" to room."

[rdepew]

The instancing_starter.zip doesn't work with Godot v4.4.

[Calinou]

godotengine/godot-docs-project-starters#12 updates all starter projects for 4.4, but it should work already if you click Upgrade & Restart in the UID dialog that shows up upon editing the project.

[knightmb]

The example instancing_starter still shows up as 4.2 in v4.4 when I downloaded it. It can be a little confusing at first, but the directions to just upgrade and restart seem to work fine. I had to scroll all the way down here to find it because I didn't want to get off track from the instructions.

[anugrhaswi]

Help!! im really frustrated as i cannot find the bounce attribute under RigidBody2D????

[Calinou]

The Bounce property is part of the PhysicsMaterial resource, which you create in the Physics Material property.

[vaishnavgade]

I was able to access the Bounce Attribute after selecting PhysicsMaterial Dropdown and clicking Edit. Hope that helps.

[Talketsu]

How come the HUD is instanced from the Market? Or is the idea that the HUD in this theoretical shooter would contain an instances of a Market scene?

Also is the idea with the enemy instancing on a Missile that Enemy is shooting a Missile and thus the Missile comes from the Enemy? In that case why is the Enemy instanced on the Missile?

Is the lone "weapon" instanced by code meant to be a random weapon on the stage to pick-up?

There's a lot of assumptions we need to make about the shooter in place to understand this diagram, it would be good to maybe bring up an example game and show how the design language ties to that in specific, cause there's a couple things in the diagram as is that I find difficult to grasp and makes the concept seem potentially more complicated than I understand it to be.