Add node texture variants

[sfence]

This is the adoption of #12928. Closes #9193

I have rebased the original @TurkeyMcMac code and tested it.
It looks to be working without some artifact on my Linux.

To do

This PR is Ready for Review.

How to test

There are test nodes in the developer test game. They can be used to test.
There is also the command /node_visual which allows to change variant_offset for the wanted node.
Example of command: /node_visual testnodes:variant_color variant_offset 2

[sfence]

According to this: https://irc.minetest.net/minetest-dev/2023-01-08#i_6046142

it seems that there is nothing left to be done.

Am I right?

[Bituvo]

Would it be possible to add weights for each variant?

[sfence]

Would it be possible to add weights for each variant?

What do you mean by it?

[Bituvo]

What do you mean by it?

So that one texture is more likely to appear than another, for example. Like, dirt_1.png could have a 75% chance of appearing, but dirt_2.png could have a 25% chance.

[sfence]

What do you mean by it?

So that one texture is more likely to appear than another, for example. Like, dirt_1.png could have a 75% chance of appearing, but dirt_2.png could have a 25% chance.

So, I understand now.

This uses the node param2 value to choose the texture. So if the mod author wants to make some texture more common, he only needs to reflect in on_construct callback or/and in the mapgen generation code.

[doxygen-spammer]

Here Github frustrates me again, as it refuses to expand the C++ diffs. :(

I left comments in the code.

Maybe it should be made clear if you need to override the same set of properties in each variant, or if it is allowed to e. g. add an overlay tile only to variants 3 and 6.

[sfence]

Here Github frustrates me again, as it refuses to expand the C++ diffs. :(

I left comments in the code.

Maybe it should be made clear if you need to override the same set of properties in each variant, or if it is allowed to e. g. add an overlay tile only to variants 3 and 6.

So, It should be documented now as well.

There is probably a bug in overlay_tiles which uses color. I will look at it later.

[doxygen-spammer]

Documentation updates are satisfying. I wonder if item metadata needs to have both palette_index and variant. Probably yes, because in non-nodes they can be independent. I got the whole patch now, and have no further comments.

…

--- I don’t want to put a requirement on this pull request—but I got the idea that `description` should be variant-able. Then you can use one node definition for all colors of wool, with each color having the appropriate description, without manually creating item drops. (And with the configurable bitfield, it also works with colorfacedir. :) )

[sfence]

With the last commit, this PR should be able to fix issue #13417 as well and possibly make issue #13112 obsolete.

[doxygen-spammer]

Yeah, the per-player-per-nodedef variant offset is a cool idea. Finally allows to make nodes visible only to certain players, like ParticleSource.playername can do it for particles. The “barriers” of Minecraft, which are only visible while wielding a barrier, can be implemented this way. Honestly I do not think it _needs_ to be included in this pull request. But if it is included, it seems the documentation in lua_api.md is still missing. (I would also like this on the clientside modding API, for responsiveness.)

[doxygen-spammer]

*lightbulbgoeson* Ah, the variant offset explains why the API currently allows to define a higher variant count than can be accessed from the param2 bitfield. :)

[sfence]

@doxygen-spammer
I have rebased this. It includes lua_doc.md update, so the set/get_node_visual methods are documented now.

[doxygen-spammer]

Nice!

[kromka-chleba]

With the last commit, this PR should be able to fix issue #13417 as well and possibly make issue #13112 obsolete.

It would indeed fix the first issue but not the second one. ABMs and LBMs do more stuff than simply swapping textures. Sometimes you want to remove the node completely, move the nodes or maybe spawn a structure. Not being able to change ABMs/LBMs after they are created makes them inflexible while hitting performance.

[Zughy]

@sfence rebase needed

[Zughy]

(just in case: rebase still needed, one file conflicting)

[sfence]

@Zughy Yeah... some conflict PR has been merged during rebasing... :D