iwatkot/maps4fs

快速开始

对于不想阅读详细内容的用户，直接选择以下方式：
选项 1：启动 @maps4fs *** 机器人，点击几下即可生成地图模板。
选项 2：在浏览器中运行 Docker 版本。在终端中运行以下命令：

bash
docker run -d -p 8501:8501 iwatkot/maps4fs

然后在浏览器中打开 http://localhost:8501。
如果不了解 Docker 使用方法，请查看 Docker 版本，操作非常简单。

概述

本项目的核心思想源于出色的 https://github.com/klamann/maps4cim 项目。

视频教程：如何从真实世界数据生成《模拟农场 22》地图。

本项目的主要目标是为《模拟农场》生成基于真实世界数据的地图模板。需要强调的是，模板不是完整地图，而只是创建地图的起点。该工具仅使用内置纹理来突出不同类型的地形和建筑物（具有正确的形状和比例），并生成高度图。其余工作需要用户自行完成。因此，如果您认为只需运行此工具就能获得可玩地图，可能会失望。但如果您是地图制作者，此工具将为您节省大量时间。
如果您是地图制作新手，以下是简要流程：

1. 使用本工具生成地图模板。
2. 下载 Giants 编辑器。
3. 在 Giants 编辑器中打开地图模板。
4. 开始创建地图（添加道路、田地、建筑物等）。

核心功能和特性

• 支持通过经纬度输入位置（例如从谷歌地图获取）。
• 支持选择地图大小（2x2、4x4、8x8 公里、16x16 公里）。
• 生成地图模板（支持的对象列表见 此部分）。
• 生成高度图。

支持的对象

本项目基于 OpenStreetMap 数据。有关详细信息，请参考 此页面。

• "building": True（建筑物）
• "highway": ["motorway", "trunk", "primary"]（高速公路、主干道、一级公路）
• "highway": ["secondary", "tertiary", "road"]（二级公路、三级公路、普通公路）
• "highway": ["unclassified", "residential", "track"]（未分类道路、 residential 道路、小径）
• "natural": "grassland"（草地）
• "landuse": "farmland"（农田）
• "natural": ["water"]（水域）
• "waterway": True（水道）
• "natural": ["wood", "tree_row"]（森林、树篱）

随着项目发展，此列表将不断更新。

使用方法

选项 1：*** 机器人

🟢 推荐所有用户使用，无需安装任何软件。
使用 *** 机器人 @maps4fs。
注意：由于主机的 CPU 和内存限制，仅支持 2x2 和 4x4 公里的地图。如果需要更大地图，请使用 Docker 版本。

!https://github.com/iwatkot/maps4fs/assets/***/ede69fe8-1a34-4ede-908f-52c9dc355ae4

使用简单，无需指南。开始使用吧！

选项 2：Docker 版本

🟢 推荐需要更大地图的用户，安装非常简单。
您可以通过 Docker 在浏览器中启动带有简约界面的项目。按照以下步骤操作：

1. 为您的操作系统安装 Docker。
2. 在终端中运行以下命令：

bash
docker run -d -p 8501:8501 iwatkot/maps4fs

3. 打开浏览器并访问 http://localhost:8501。
4. 填写必填字段并点击“生成”按钮。
5. 地图生成完成后，点击“下载”按钮获取地图。

!https://github.com/user-attachments/assets/b80c458b-29ea-4790-a640-8fa3b5550610

选项 3：本地源码运行

🔴 仅推荐熟悉 Python 的高级用户。
按照以下步骤在本地启动项目，或观看 视频教程：

配置说明

工具界面的“高级设置”选项卡中提供以下高级设置：

• max_height - 地图的最大高度。默认值为 400。平原地图建议设置较小值，山地地图建议设置较大值。可能需要尝试不同值以获得理想结果。
• blur_seed - 模糊算法的种子值。默认值为 5（表示 5 米）。值越大，地图越平滑；值越小，地图细节越丰富。请注意，对于地形崎岖的区域，禁用模糊算法可能导致地图非常粗糙。建议保持默认值。

生成信息文件

脚本还会在 output 文件夹中生成 generation_info.json 文件，包含以下键：
"coordinates" - 您输入的地图中心坐标，
"bbox" - 地图的经纬度边界框，
"distance" - 地图尺寸（米），
"minimum_x" - 地图的最小 x 坐标（UTM 投影），
"minimum_y" - 地图的最小 y 坐标（UTM 投影），
"maximum_x" - 地图的最大 x 坐标（UTM 投影），
"maximum_y" - 地图的最大 y 坐标（UTM 投影），
"height" - 地图高度（米）（由于地球不是平面，此值与 distance 不相等，抱歉平地说支持者），
"width" - 地图宽度（米），
"height_coef" - 由于需要精确尺寸的纹理，地图高度会乘以此系数，
"width_coef" - 同上，适用于宽度，
"tile_name" - 用于生成高度图的 SRTM 瓦片名称，例如 "N52E013"。

您可以使用此信息调整其他数据源（如纹理、高度图等）以匹配地图。

Bug 报告和功能请求

如果发现 Bug 或有新功能想法，请在 https://github.com/iwatkot/maps4fs/issues 创建 issue，或通过 *** 直接联系我。
ℹ️ 请不要因 *** 机器人故障联系我。如前所述，这与主机限制有关，您可以随时本地运行工具，或通过***支持项目，或许我能负担更好的主机服务。