# What is Maps4FS? **Maps4FS** is a powerful map generator that creates realistic Farming Simulator maps from real-world locations using OpenStreetMap data and satellite imagery. Transform any place on Earth into a playable farming environment with just a few clicks. ## 🎯 What Does It Do? Maps4FS automatically generates complete, ready-to-use map templates for **Farming Simulator 25** by: * 🗺️ **Analyzing real terrain** using multiple DTM providers (including high-quality sources where available) * 🌍 **Processing OpenStreetMap** data for roads, buildings, and land use * 🛰️ **Downloading satellite images** for realistic textures * 🌾 **Creating farmable fields** based on real agricultural areas * 🌲 **Generating forests** with appropriate tree placement * 🌊 **Building water systems** including rivers and lakes * 🛣️ **Generating 3D road meshes** with realistic textures from OSM data * 🏘️ **Placing buildings** automatically in appropriate areas * 📐 **Producing 3D terrain** with accurate elevation models ## 🚀 Key Features ![Maps4FS Interface](https://github.com/iwatkot/maps4fsapi/releases/download/2.6.0/screenshot-localhost-3000-1757595208136.png) ### Automated Generation * **Fields & Farmlands**: Automatically detects and creates farmable areas * **Forests**: Places trees based on real forest data with customizable density * **Water Systems**: Generates water planes for rivers, lakes, and ponds * **Road Generation**: Creates 3D road meshes with proper textures and UV mapping * **Roads & Splines**: Creates road networks and spline systems * **Buildings**: Intelligent building placement in appropriate areas * **Decorative Foliage**: Adds realistic vegetation and grass areas ### Flexible Map Sizes * Standard sizes: **2x2, 4x4, 8x8, 16x16 km** * **Custom dimensions** for unique projects * **Map scaling** to adjust real-world size to in-game dimensions * **Map rotation** for optimal field orientation ### Professional Output * **Giants Editor ready** templates * **Background terrain** with satellite textures * **Height maps** with realistic elevation * **Texture layers** for different surface types * **Complete file structure** for immediate use ## 🌟 Why Choose Maps4FS? ### Based on Real Data Unlike fictional maps, Maps4FS uses actual geographic data to create authentic farming environments. Your virtual farm will mirror real agricultural areas with accurate terrain, realistic field layouts, and proper infrastructure. ### Time-Saving Automation What traditionally takes weeks of manual work in Giants Editor can be accomplished in hours. Maps4FS handles the heavy lifting of terrain generation, field creation, and asset placement automatically. ### Highly Customizable Every aspect of generation can be fine-tuned: * **Terrain settings** (elevation, water depth, foundations) * **Vegetation options** (tree density, grass types, forest species) * **Field parameters** (size, padding, farmland margins) * **Building placement** (types, categories, custom assets) * **Visual quality** (texture resolution, satellite imagery) ## 🎮 Perfect For * **Map Modders** looking to create realistic farming environments * **Server Administrators** wanting unique, location-based maps * **Players** who want to farm their hometown or favorite locations * **Content Creators** needing diverse, high-quality maps ## 🛠️ How It Works 1. **Choose Your Location**: Select any area on Earth using coordinates or place names 2. **Configure Settings**: Adjust map size, terrain features, and generation options 3. **Generate**: Let Maps4FS process the data and create your map 4. **Import**: Load the generated template into Giants Editor 5. **Customize**: Add your own touches, buildings, and modifications 6. **Play**: Enjoy farming in your custom, real-world inspired map ## 🌍 Global Compatibility Maps4FS works worldwide thanks to: * **OpenStreetMap** global coverage * **Multiple DTM providers** for elevation data (high-quality sources available in many regions) ## 🆕 Recent Additions ### Windows App The [**Windows App**](https://maps4fs.gitbook.io/docs/setup-and-installation/windows_app) provides the easiest way to run Maps4FS on Windows without Docker or Python installation. Simply download, extract, and run - perfect for users who want a straightforward setup experience. ### Atlas FS [**Atlas FS**](https://github.com/iwatkot/maps4fs/blob/main/docs/fs_atlas_about.md) is our new community platform where you can: * Browse ready-to-play maps created by the community * Download maps based on real-world locations * [Submit your own maps](https://github.com/iwatkot/maps4fs/blob/main/docs/fs_atlas_submit.md) to share with others * Discover new farming locations from around the world * **Multiple satellite providers** for high-quality imagery * **Flexible coordinate systems** supporting any location ## 📖 Getting Started Ready to create your first map? Check out our guides: * 📚 [Step by Step Guide](https://maps4fs.gitbook.io/docs/getting-started/step_by_step_guide) - Complete walkthrough from start to finish * ⚙️ [Main Settings](https://maps4fs.gitbook.io/docs/understanding-the-basics/main_settings) - Essential configuration options * ❓ [FAQ](https://maps4fs.gitbook.io/docs/getting-started/faq) - Common questions and answers * 🎓 [Video Tutorials](https://www.youtube.com/watch?v=hPbJZ0HoiDE\&list=PLug0g7UYHX8D1Jik6NkJjQhdxqS-NOtB9) - Complete YouTube playlist ## 💬 Community & Support Join thousands of map creators in our community: * **Discord**: [Join our server](https://discord.gg/wemVfUUFRA) for help, tips, and map sharing * **GitHub**: [Report issues](https://github.com/iwatkot/maps4fs/issues) or contribute to development * **YouTube**: [Watch tutorials](https://www.youtube.com/@iwatkot) and see Maps4FS in action *** *Transform any location on Earth into your next farming adventure with Maps4FS.* --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://maps4fs.gitbook.io/docs/getting-started/what_is_maps4fs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.