diff --git a/Chunk-generator.md b/Chunk-generator.md
new file mode 100644
index 0000000..da2d716
--- /dev/null
+++ b/Chunk-generator.md
@@ -0,0 +1,7 @@
+Every instance need a chunk generator, they can be easily created by extending the ChunkGenerator class
+
+Example found [here](https://github.com/Minestom/Minestom/blob/master/src/main/java/fr/themode/demo/generator/NoiseTestGenerator.java)
+
+We have ChunkGenerator#generateChunkData which is called once for all chunk, the batch is then executed and the chunk packet sent to all nearby players.
+
+Populators can also be specified, they are executed after the chunk generator as a way to "populate" the world (trees, structures, etc...)
\ No newline at end of file