search

godotengine / godot-docs

Godot Engine official documentation
https://docs.godotengine.org
Other
3.76k stars 3.06k forks source link

Resource manual page should include a discussion about "Make Unique", "Make Unique (Recursive)" and resource_local_to_scene #8243

Open timcode77 opened 10 months ago

timcode77 commented 10 months ago

Your Godot version: v4.1.2.stable.official [399c9dc39]

Issue description: "Make Unique", "Make Unique (Recursive)" and resource_local_to_scene are amongst the most confusing resource-related concepts for newcomers to Godot. But they are not mentioned in the manual page about Resources.

Not fully understanding them myself, I cannot suggest what should be added.

URL to the documentation page (if already existing): https://docs.godotengine.org/en/stable/tutorials/scripting/resources.html

timcode77 commented 10 months ago

Here is another example of the incompleteness of the documentation around this: A search for the term "recursive" in the Godot docs does not reveal any information about what "Make Unique (Recursive)" does.

timcode77 commented 10 months ago

Another example of the ambiguity around this stuff is the need to do weird code maneuvers to ensure scenes instantiated in code get their correct shader parameters uniquely.

material = material.duplicate(true) # This is weird and the need to do it should be highlighted in the manual.
material.get_shader_parameter("noise").noise.seed = randi()