# 🌍 TerraForge
A customizable Python tool for generating maps for games and simulations.
Features:
* 🗺️ Biome Maps – Generate overworld maps using customizable noise-based elevation
* 🏰 Dungeon Maps – Procedurally generate multi-level dungeons with rooms, corridors, and stairs
* 🖼️ Image Export – Export biome maps as images (PNG format)
***
## 🧰 Features
* Procedural elevation map generation using simplex noise
* Biome assignment based on elevation values
* Export elevation and biome maps as .png images
* Fully customizable noise and biome settings
* Image size and output directory control
* Customizable dungeon generator
***
## 📦 Requirements
* [noise](https://pypi.org/project/noise/)
* [numpy](https://pypi.org/project/numpy/)
* [pillow](https://pypi.org/project/pillow/)
***
## 🚀 Usage - TerraForge (Biome Maps)
`from terraforge import TerraForge`
`generator = TerraForge(map_size=300, image_size=(600, 600))`
`generator.generate(output_dir="maps")`
***
## 🚀 Usage - DungeonForge (Dungeons)
`from dungeonforge import DungeonForge`
`generator = DungeonForge()`
`dungeon_map = generator.generate()`
***
### 🚀 Want More Power? Try TerraForgePro
**[TerraForgePro](https://gum.co/u/rwq2bbml) adds:**
- Noise Types:
- Elevation
- Moisture
- Temperature
- Island Falloff Shaping:
- Radial (Default)
- Edge (Coastal Shaping)
- Archipelago (Multiple Island Centers)
💡 You can technically add moisture and temperature in the free version, but TerraForgePro handles it out of the box—plus you get new falloff types, better island generation, and future updates.
Raw data
{
"_id": null,
"home_page": null,
"name": "terraforge-core",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "python, procedural, generation, biome, noise, dungeon",
"author": "Brianna Ladson",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/48/e6/da8317e351f86094cd22ecc3701cd1d0da1acfd7692bc46903b46ab07470/terraforge_core-1.0.1.tar.gz",
"platform": null,
"description": "# \ud83c\udf0d TerraForge\r\nA customizable Python tool for generating maps for games and simulations.\r\n\r\nFeatures:\r\n* \ud83d\uddfa\ufe0f Biome Maps \u2013 Generate overworld maps using customizable noise-based elevation\r\n* \ud83c\udff0 Dungeon Maps \u2013 Procedurally generate multi-level dungeons with rooms, corridors, and stairs\r\n* \ud83d\uddbc\ufe0f Image Export \u2013 Export biome maps as images (PNG format)\r\n\r\n***\r\n\r\n## \ud83e\uddf0 Features\r\n* Procedural elevation map generation using simplex noise\r\n* Biome assignment based on elevation values\r\n* Export elevation and biome maps as .png images\r\n* Fully customizable noise and biome settings\r\n* Image size and output directory control\r\n* Customizable dungeon generator\r\n\r\n***\r\n\r\n## \ud83d\udce6 Requirements\r\n* [noise](https://pypi.org/project/noise/)\r\n* [numpy](https://pypi.org/project/numpy/)\r\n* [pillow](https://pypi.org/project/pillow/)\r\n\r\n***\r\n\r\n## \ud83d\ude80 Usage - TerraForge (Biome Maps)\r\n`from terraforge import TerraForge`\r\n\r\n`generator = TerraForge(map_size=300, image_size=(600, 600))`\r\n\r\n`generator.generate(output_dir=\"maps\")`\r\n\r\n***\r\n\r\n## \ud83d\ude80 Usage - DungeonForge (Dungeons)\r\n`from dungeonforge import DungeonForge`\r\n\r\n`generator = DungeonForge()`\r\n\r\n`dungeon_map = generator.generate()`\r\n\r\n***\r\n### \ud83d\ude80 Want More Power? Try TerraForgePro\r\n**[TerraForgePro](https://gum.co/u/rwq2bbml) adds:**\r\n- Noise Types:\r\n - Elevation\r\n - Moisture\r\n - Temperature\r\n \r\n- Island Falloff Shaping:\r\n - Radial (Default)\r\n - Edge (Coastal Shaping)\r\n - Archipelago (Multiple Island Centers)\r\n\r\n\ud83d\udca1 You can technically add moisture and temperature in the free version, but TerraForgePro handles it out of the box\u2014plus you get new falloff types, better island generation, and future updates.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A customizable Python tool for generating maps for games and simulations.",
"version": "1.0.1",
"project_urls": null,
"split_keywords": [
"python",
" procedural",
" generation",
" biome",
" noise",
" dungeon"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "aae78530ff5cda86310bd767dec52d4a55f834d5205e5ff80ae3da381d2a53ee",
"md5": "4f638e68fa61cddd719019fab6bbc62b",
"sha256": "773faa3dc6f819c034b8f090bedda57c0e779be994c802a9eedd35e067cc2434"
},
"downloads": -1,
"filename": "terraforge_core-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4f638e68fa61cddd719019fab6bbc62b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8297,
"upload_time": "2025-07-18T04:51:49",
"upload_time_iso_8601": "2025-07-18T04:51:49.926353Z",
"url": "https://files.pythonhosted.org/packages/aa/e7/8530ff5cda86310bd767dec52d4a55f834d5205e5ff80ae3da381d2a53ee/terraforge_core-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "48e6da8317e351f86094cd22ecc3701cd1d0da1acfd7692bc46903b46ab07470",
"md5": "47d086fb672751224fc6847c44f200a6",
"sha256": "3f5a1228edb2a44d404baa9b278ae39fde2fd1b85774cd225522911b80ad3083"
},
"downloads": -1,
"filename": "terraforge_core-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "47d086fb672751224fc6847c44f200a6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 8029,
"upload_time": "2025-07-18T04:51:50",
"upload_time_iso_8601": "2025-07-18T04:51:50.955322Z",
"url": "https://files.pythonhosted.org/packages/48/e6/da8317e351f86094cd22ecc3701cd1d0da1acfd7692bc46903b46ab07470/terraforge_core-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-18 04:51:50",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "terraforge-core"
}
JSON