As much as I love camelCase (guilty), snake_case is Godot's standard so maybe it's worth it to change it.

I am wondering how much out of scope would be a chunk system - generating an infinite world with this addon (depending on the generator used).

Saving/loading chunks to disk may be out of scope but I could totally see a system where depending on the player position, a level gets re-generated dynamically.

It's way more flexible than having predetermined variables in the generator, but at the same time I think it's a bit confusing? What do yall think?
(TileInfo is a resource you use to tell the generator which tile to place, it contains the TileMap layer, the atlas_coord and source_id if it's a single cell, or the terrain set and terrain if it's a terrain)

This function could be overridden to add checks before adding a tile to the grid Dictionary, like not going outside the bounds in a HeightmapGenerator or things like that.

Using Dictionaries is just really bad. I'll make a concept soon.

I was testing the demo scenes and everything worked worked fine except the walker generation
I got this error

I did not modify anything for this to happen.

My current version of Godot is 4.0.3 and I am using commit e345b77 which is the latest at the current time.

Add a TileInfo resource that holds different TileInfos with different weights, and randomly chooses one of them, getting replaced with it.

(Name needs work)
Basically, what this modifier does is change a tile based on it's height. An example would be: the first tile is a grass tile, the next 3 ones are dirt, then they're stone until the last one, which is bedrock. However, I'm not sure how to implement this since the height can variate between columns. So even though you could set it to look for a certain height, this would just create a straight line. Any help would be appreciated.

Another generator that could be nice, a maze with a start and an end.

I am using v0.8.0 of Gaea, and I would like to have chunks generated on ready, but I cannot get the chunk loader to load in the chunks that the ChunkLoader3D creates. I attached a generator and an actor to it. It seems to generate chunks, as it takes a while to load, but it does not show any. I can provide images if needed. Is there a specific way I need to set this up?

Using a pathfinding algorithm, we could start an "agent" in a certain starting position and then remove the tiles the agent can't reach. This should help with, for example, the smoothing modifier which can sometimes cause little islands.

Add documentation for nodes and modifiers. Both in Godot and Github.

HeightmapGenerator2D takes a very long time to generate. Tested with a 1750x900 world, it takes about 25 seconds with no modifiers, and the carver modifier only seems to add only about 2 seconds.

This generator is taking 10-12 seconds using the demo, which is A LOT compared to other generators.

Something to do with Gaea, greek mythology, and procgen ofc.

The documentation for submitting assets to the Asset Library mentions removing every warning from the addon. This would mean adding _ to unused variables and stuff like that.

in the demo of heightmap when the player moves some distance the chunks are loaded a bit off and it increases more when u move more

With #29 merged, the new chunk system is now available and working great. However, it could still use some optimizations. We could use threads, though I have no idea how to work with them. Do you think it needs more optimization?

Hi my preview seems to flicker in and out of view when I pan/zoom. Unclear what's causing this. Not sure if this is an issue with the package or godot.

Pretty much followed: https://www.youtube.com/watch?v=oB1xsCcO9wI&t=957s

Could hold TileInfos, maybe each with an offset, that all get placed when this is set.

• Basic generation
• ChunkLoader
• Using modifiers

I am encountering a bug where if you have a tile map with collisions, when I generate a map using that tile map there are extra collisions beside collidable tiles. This happens to every 2d generator and I have tried to fix it with no success. Is this a bug or is there something I am doing wrong?

Once I enable plugin in project settings I got these errors:

Godot Engine v4.1.2.stable.official (c) 2007-present Juan Linietsky, Ariel Manzur & Godot Contributors.
--- Debug adapter server started ---
--- GDScript language server started ---
res://addons/gaea/generators/generator.gd:35 - Parse Error: Could not parse global class "GaeaGrid" from "res://addons/gaea/grid.gd".
res://addons/gaea/generators/generator.gd:54 - Parse Error: Could not parse global class "GaeaGrid" from "res://addons/gaea/grid.gd".
res://addons/gaea/generators/generator.gd:64 - Parse Error: Could not parse global class "GaeaGrid" from "res://addons/gaea/grid.gd".
res://addons/gaea/generators/generator.gd:35 - Parse Error: Function "get_grid" cannot be used as getter because of its signature.
res://addons/gaea/modifiers/2D/modifier_2d.gd:0 - Parse Error: Could not resolve class "Modifier".
res://addons/gaea/modifiers/modifier.gd:30 - Parse Error: Could not parse global class "GaeaGrid" from "res://addons/gaea/grid.gd".
res://addons/gaea/modifiers/modifier.gd:36 - Parse Error: Could not parse global class "GaeaGrid" from "res://addons/gaea/grid.gd".
modules/gdscript/gdscript_compiler.cpp:2594 - Condition "!base->is_valid() && !base->reloading" is true. Returning: ERR_BUG

Thank you for the excellent repository.

I am looking to take different Tiles from the NoiseGenerator (e.g. Deep water, shallow water, sand, grass, deep grass) and render each particular Tile layer to different TileMaps in the TilemapGaeaRenderer.

Why do this?

Shader Materials are applied to the entire tilemap. If I have a shader material for my water tiles, but I don't want it applied to any other tilemap layers (e.g. sand, grass, etc), how can I support this in Gaea? You could imagine that every biome might have shaders applied at the tilemap layer and want layer-wise tilemap rendering.

It would seem that it's compatible with the way the Tiles from NoiseGenerator are being generated, the code is just missing a specific tilemap to render into. Alternatively, another hack would be to have a shared Tilemap resource, then 2 TilemapGaeaRenderers, and select which Tiles are included/excluded from the rendering for the target Tilemap. Then I could render some layers to one tilemap and other layers to another.

Any thoughts on how I could:

1. hack this quickly
2. More permanent and principled solution?

Thanks again, really great work!

This is due to the fact that before the Renderer can connect the signals on ready, the generation already emits it. This can be fixed by placing the Renderer above it, but that's obviously not good. Not sure how to fix it though.

While the Array works, I think it'd be nice to have a custom UI in the inspector. Something similar to Blender's UI for adding modifiers.

I am looking at this on my phone and I cant see a demomstration of, how the terrain looks. Can you please add some. Kindly. Thank you.

I think the grid could be changed to a GaeaGrid resource, instead of just a dictionary. This resource would still have a dictionary, but it would allow for easier adding of features and saving.

The pros:

• Could add get_value and set_value methods which would allow for doing stuff like #25, #48 or #51.
• As a resource, it can be easily saved and loaded.
• Grid logic would be separated from generation, which is kinda what we've been doing with stuff like separating generation from rendering, and all that.
• Could have helper functions such as getting the neighbors of a tile (which already exist in the Generator class, but is a bit of a mess).

The cons:

• Lot of refactoring
• Resources can sometimes be a bit wonky
• Can't think of anything more tbh

A native modifier to Gaea that overwrites the assigned tile based upon defined XY region within the MapRenderer. This would allow for a defining of polar and desert biomes within the generator.

If it considers the existing value, it should feather that overwritten tile in. Eg. If pos within Region and Value within Range, then overwrite tile.

no example scenes bro :(

• GaeaGenerator
• ChunkAwareGenerator
• NoiseGenerator
• TileInfo
• ChunkLoader

everything works but heightmaps.

I'm getting the error:
res://addons/gaea/generators/2D/heightmap_generator/heightmap_generator_2d.gd:25 - Invalid set index 'seed' (on base: 'Nil') with value of type 'int'.

I made a recreation of my issue, with a HeightmapGenerator2D and a WalkerGenerator. They both have the same tilemap settings and TilemapGaeaRenderer.

Am I doing something wrong? There's no documentation for heightmaps so I used the same setup used in the getting started tutorial.

project showcasing my issue:
gewrwertgtwegr.zip

I think generation and rendering should be different scripts.
The Generator classes should only be responsible for generating a certain area (like implemented in #29). The actual tile placing could handle another script.

This approach will have some advantages in my opinion:

• Regenerating data each time would be unnecessary because the user could implement saving logic and the WIP chunk system could take advantage of unloading.
• The plugin will be more universal. When users could handle drawing by themself, more custom solutions will be possible because they won't be bound to TileMaps.

Feedback is appreciated!

When the actor is in a negative postition, it does not work.

The solution is to change the code in 'chunk_loader_2d' and 'chunk_loader_3d' to put a cast float() in one of the variable:

func _get_actors_position() -> Vector2i:
	# getting actors positions
	var actor_position := Vector2i.ZERO
	if actor != null: actor_position = actor.global_position.floor()

	var tile_position: Vector2i = actor_position / generator.tile_size

	var chunk_position := Vector2i(
		floori(float(tile_position.x) / generator.chunk_size.x),
		floori(float(tile_position.y) / generator.chunk_size.y)
	)

	return chunk_position

func _get_actors_position() -> Vector3i:
	# getting actors positions
	var actor_position := Vector3i.ZERO
	if actor != null: actor_position = actor.global_position.round()

	var tile_position: Vector3i = actor_position / generator.tile_size

	var chunk_position := Vector3i(
		roundi(float(tile_position.x) / generator.chunk_size.x),
		roundi(float(tile_position.y) / generator.chunk_size.y),
		roundi(float(tile_position.z) / generator.chunk_size.z)
	)

	return chunk_position

When I was looking at the code I notices you are storing the values using a dictionary where the key is the position. This method is great except, when looking at the other Issues like Issue #6 where you want to place different blocks based on height in the colum. And Issue #7 and #16 where you discuss about using chunks to optimize drawing and generating infinite terrain.

I dont think the way tiles are stored should change, because for most generations the current system is perfect. but when I look at the code I see alot of instances where the grid is directly acceses, which should rather be though a set_block and get_block variable, that way you could exchange the ways blocks are stored to suite the generation type.

I suggest using an oct tree but its 2d so its actually a quad tree, to store data. Then you could use a simple algorithm to get the top most block of each colum. A octree is great for storing limited sized worlds, but not great for infinite sized worlds. But that is where the dictionary method comes in, at a certain point when one octree has too mutch depth, then you can split the oct trees up into dictionaries of oct trees whith a maximum of 4 octrees in memory to make it look seemless. And then loading and unloading as needed.

Some modifiers which affect tiles could use for some filters such as "exclude certain tiles" or "only modify certain tiles". Maybe by having an Array of TileInfos.
Now, if we wanted to check if the TileInfos match, the user would have to reference the same resource. Either that, or we could add a matches_tile_info in the TileInfo class which checks if all properties are the same. Is that worth it or just having the user reference the resource is enough?

I'd love to see the plugin added to the Godot Asset Library. Currently, it seems unavailable there the last time I tried searching for it. Having it in the Asset Library would make installation more convenient for Godot users.

Will there be C# support in the future?