# Welcome to Maps4FS

⚠️ Maps4FS is now [MapToPlay](https://maptoplay.com).\
⚠️ Maps4FS is retired. There will be no further updates and no support.

**Turn any real-world location into your next Farming Simulator adventure.**

Ever wondered what it would be like to farm in your hometown? Or recreate that beautiful countryside you visited last summer? Maps4FS makes it possible by transforming real geographic data into detailed, playable Farming Simulator maps.

## Support Policy

Maps4FS supports Farming Simulator 25. Farming Simulator 22 support was fully removed starting from Maps4FS 3.0.0 and Maps4FS Windows 1.0.0.

## What You Can Create

🌾 **Authentic Terrain** - Generate realistic elevation and landscape features 🛣️ **Real Road Networks** - Import actual road layouts from OpenStreetMap 🏞️ **Natural Textures** - Apply region-appropriate surface materials 🚜 **Functional Fields** - Create farmable areas based on real agricultural zones 🏡 **Farmland Boundaries** - Define property ownership and economic zones 🏔️ **Background Terrain** - Build stunning distant mountain ranges and landscapes 💧 **Water Features** - Generate rivers, lakes, and realistic water planes 🛤️ **Road Splines** - Create detailed 3D path networks for vehicles 🏘️ **Smart Building Placement** - Automatically place buildings in appropriate areas 🌲 **Procedural Elements** - Automatically place trees, foliage, and objects ⚡ **Electricity Networks** - Generate powerlines, poles, towers, and road-facing street lights 🗺️ **Overview Maps** - Generate in-game minimap displays 🏡 **Familiar Landscapes** - Bring recognizable locations into the game

## 🆕 What's New?

### 🪟 Windows App - Standalone Application

The easiest way to run Maps4FS on Windows! [**Download the Windows App**](/docs/setup-and-installation/windows_app.md) - no Docker or Python required. Just extract and run. Perfect for beginners and users who want a simple setup.

### 🌍 Atlas FS - Community Map Platform

Discover and share ready-to-play maps! [**Visit Atlas FS**](https://github.com/iwatkot/maps4fs/blob/main/docs/fs_atlas_about.md) to browse community-created maps based on real-world locations, or [**submit your own**](https://github.com/iwatkot/maps4fs/blob/main/docs/fs_atlas_submit.md) to share with the community.

***

## Your Journey Starts Here

### 🚀 Brand New to Maps4FS?

Jump right in with the [**Step by Step Guide**](/docs/getting-started/step_by_step_guide.md) - you'll have your first map generated in about 15 minutes! No technical expertise required.

### 🤔 Want to Understand the Bigger Picture?

Learn [**What Maps4FS Actually Does**](/docs/getting-started/what_is_maps4fs.md) and see how geographic data becomes playable terrain.

### 💻 Ready to Install?

Choose your setup method in [**How to Launch Maps4FS**](/docs/getting-started/how_to_launch.md):

* [**Windows App**](/docs/setup-and-installation/windows_app.md) - Standalone executable (easiest for Windows users)
* **Web Interface** - No installation required
* **Docker Deployment** - Full features for advanced users

## Popular Starting Points

Most users love to explore these areas first:

* [**DEM (Elevation)**](/docs/map-components/dem.md) - Make mountains, valleys, and rolling hills feel real
* [**Fields & Farmlands**](/docs/map-components/fields.md) - Design the heart of your farming operation
* [**Textures**](/docs/map-components/textures.md) - Give your map authentic visual character
* [**Electricity**](/docs/understanding-the-basics/electricity.md) - Configure powerlines and street lights with schema-driven placement
* [**Background Terrain**](/docs/advanced-topics/background_terrain.md) - Create stunning distant landscapes

## Get Inspired

🎥 **Visual Learner?** Check out the [**YouTube tutorials**](https://www.youtube.com/watch?v=hPbJZ0HoiDE\&list=PLug0g7UYHX8D1Jik6NkJjQhdxqS-NOtB9) that show real map creation from start to finish.

🌍 **Looking for Ready-to-Play Maps?** Visit [**Atlas FS**](https://github.com/iwatkot/maps4fs/blob/main/docs/fs_atlas_about.md) to browse and download community-created maps based on real-world locations - no editing required!

## Need Help Along the Way?

* **Stuck on something?** Check the [**FAQ**](/docs/getting-started/faq.md) for quick answers
* **Want to optimize your workflow?** See [**Workflow Optimizations**](/docs/getting-started/workflow_optimizations.md)
* **Running into issues?** Visit [**Getting Help**](/docs/setup-and-installation/get_help.md) for troubleshooting and community support

## Ready to Create Something Amazing?

The world is full of incredible places waiting to become your next farming adventure. Whether it's the rolling hills of Tuscany, the vast plains of the American Midwest, or that perfect valley you discovered on vacation - Maps4FS can bring it to life.

**Let's start building:** [**Begin with the Step by Step Guide →**](/docs/getting-started/step_by_step_guide.md)

## 🎨 Attribution Pack (Optional)

Want to show that your map was created with Maps4FS? You can use an **optional attribution pack** with graphics like "Created with Maps4FS" and "Powered by Maps4FS" that you can use on your maps, websites, or promotional materials.

**📦 Download**: [Attribution Pack](https://1drv.ms/u/c/a4f172ed55b8f7e1/IQDVdINs6vmMQYzXqabkL3w6AaF8ePwYx423W9e4RftVzFc?e=c5BgvK) - *Completely optional, not required*

These graphics are provided for users who want to credit the tool, but there's **no obligation** to use them. Use them if you'd like to show support or let others know how your map was created!

***

*From OSM maps to playable terrain in just a few clicks. Welcome to the future of map creation.*


---

# 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/readme.md?ask=<question>
```

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.
