diff --git a/map-generator/README.md b/map-generator/README.md
index 6afeb55f5..896e922ab 100644
--- a/map-generator/README.md
+++ b/map-generator/README.md
@@ -33,6 +33,14 @@ To process a subset of maps, pass a comma-separated list:
 
 `go run . --maps=northamerica,world`
 
+## Output Files
+
+- `../resources/maps/<map_name>/manifest.json` - JSON metadata containing map dimensions and land tile counts for all scales.
+- `../resources/maps/<map_name>/map.bin` - Full-scale binary map data packed with terrain type and magnitude.
+- `../resources/maps/<map_name>/map4x.bin` - 1/4 scale (half dimensions) binary map data used for mini-maps.
+- `../resources/maps/<map_name>/map16x.bin` - 1/16 scale (quarter dimensions) binary map data used for mini-maps.
+- `../resources/maps/<map_name>/thumbnail.webp` - WebP image thumbnail of the map.
+
 ## Create image.png
 
 The map-generator will process your input file at `assets/maps/<map_name>/image.png` to generate the map
@@ -105,11 +113,16 @@ Using the `name` from your json:
 
 ## Notes
 
-- Maps should be between 2 - 3 million pixels square (area)
 - Islands smaller than 30 tiles (pixels) are automatically removed by the script.
 - Bodies of water smaller than 200 tiles (pixels) are also removed.
 - The map generator normalizes dimensions to multiples of 4. Any pixels beyond `Width - (Width % 4)` or `Height - (Height % 4)` are cropped.
 
+For Performance Reasons:
+
+- Maps should be between 2 - 3 million pixels square (area).
+- Maps with over 3 million land tiles are not recommended.
+- Average land tile count is around 1 - 2 million.
+
 ## 🛠️ Development Tools
 
 - **Format map-generator code**: