maps4fs Docker 镜像下载 - 轩辕镜像

快速开始

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

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

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

概述

本项目的核心思想源于出色的 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 版本。

!*** 机器人

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

选项 2：Docker 版本

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

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

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

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

!Web 界面

选项 3：本地源码运行

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

本地版本说明（点击展开）

*️⃣ 此选项已过时，发布版本中不再提供 zip 归档。您需要克隆仓库并手动运行脚本。

1. 克隆仓库。
2. 为您的操作系统安装 Python 3.12。
3. 运行脚本以创建虚拟环境、安装依赖并启动工具：
   • Windows：右键点击 run.ps1 并选择“使用 PowerShell 运行”（如果出现错误，在 PowerShell 中运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser）
   • Linux / Mac：在工具文件夹的终端中执行 sh run.sh（如果安装了 bash，Windows 系统也可使用此命令）
4. 将显示简约图形界面。
5. 从谷歌地图复制经纬度并粘贴到相应字段。操作方法：右键点击地图上的某个位置，点击类似 52.520008, 13.404954 的坐标。第一个数字是纬度，第二个是经度。该点将作为地图中心。
6. 选择地图大小（2048、4096、8192 或 *** 米）。地图越大，生成时间越长。警告：在 Giants 编辑器中打开大型地图需要高性能电脑。不建议生成超过 8192 米的地图。
7. 如果需要更改设置，可查看高级设置。强烈建议根据地图调整 max_height 值。对于平原地图，设置较小值（如 200）；对于山地地图，设置较大值（如 800）。
8. 点击“生成”按钮。
9. 等待地图生成完成。
10. 地图将保存在工具文件夹的 output 目录中。您可以在 Giants 编辑器中打开 output/maps/map/map.i3d 检查是否正常。如需重新运行脚本，从步骤 4 开始。脚本将删除之前的地图并生成新地图。
11. 现在可以将 output 文件夹复制到其他位置，开始在 Giants 编辑器中创建地图。

配置说明

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

• 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 或有新功能想法，请在 此处 创建 issue，或通过 *** 直接联系我。
ℹ️ 请不要因 *** 机器人故障联系我。如前所述，这与主机限制有关，您可以随时本地运行工具，或通过***支持项目，或许我能负担更好的主机服务。