Arnis：30 分钟在 Minecraft 里复刻一座真实城市，免费开源
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
框出老家所在的那片街区，等进度条走完，你就能走进 Minecraft 里那条真的存在过的街：路名、河道、楼房的占地，全部来自 OpenStreetMap 的真实数据，地面起伏则来自高程数据（真实地面的海拔信息）。Arnis 是一款免费开源的 Minecraft 世界生成工具，把指定经纬度范围的地形与建筑按原貌映射成方块，支持 Java 1.17+、基岩版和 Luanti 三种世界格式。这篇文章带你走完第一个世界的生成流程，并讲清地形和参数背后的原理。
5 分钟上手：从框选区域到生成完成
这一节解决"第一次跑起来要做什么"。不想装编译环境的，去官方发布页下载预编译包直接运行；想自己编译的，clone 下来再构建 GUI 版即可：
git clone https://gitcode.com/GitHub_Trending/ar/arniscargo run --release打开 GUI 后，用左侧矩形工具在内置地图上框出想要生成区域，选择世界格式（Java 或 Bedrock），点 "Start Generation"。窗口底部进度条实时刷新，看到 "Done! World generation completed" 就进游戏验收。如果你更喜欢命令行，--bbox按"最小纬度,最小经度,最大纬度,最大经度"填写，一条命令覆盖整个流程：
cargo run --release --no-default-features -- \ --output-dir="C:/YOUR_PATH/.minecraft/saves/worldname" \ --bbox="min_lat,min_lng,max_lat,max_lng"三种生成模式怎么挑：建筑、纯地形还是只要起伏
这一节帮你决定--mode选哪个档。这个参数控制生成粒度，默认值是geo-terrain，即真实起伏的地形上叠加道路、建筑等 OSM 要素；geo-only会把同样的要素放在平地上，适合只想快速看街区布局的场景；terrain-only则跳过 OpenStreetMap 查询和 Overture 数据抓取，只输出纯地形。什么时候改？想让某段山谷、某条河谷单独存在、不掺任何人工物时，选terrain-only。
高程参数怎么调：真实山体起伏落到方块的原理
这一节解释"山坡为什么像真的"。高程数据由 src/elevation/ 目录下的模块处理：程序先按区域自动挑选合适的高程源，找不到覆盖区域的高清源就回退到全球源，再依次做异常值剔除、空洞填补，最后把海拔压缩进世界高度上限、映射到 Minecraft 的 Y 轴。真正值得拨的旋钮是--scale：它控制一个方块对应多少米，默认 1.0 即真实大小，取值范围 0.05 到 4.0。想让整个世界缩小十倍摆进一个场景？把--scale调小；想放大细节，调大即可，但比例越大，单平方公里消耗的方块数越多，内存和时间开销会明显上涨。
树木、车辆、路牌默认长什么样：元素来源与性能开关
这一节回答"每个要素从哪来、哪里能省时间"。所有要素的解析与建模集中在 src/element_processing/：道路宽度、水体轮廓、建筑占地都从 OSM 标签映射为方块。树木是还原度最高的部分，程序内置了按 9 个气候区域划分的树种包（assets/tree-packs/，含上千棵.schem树模），按生成地点的中心坐标自动选包；--max-tree-size控制最大树型，默认giant，可选 small/medium/big/tall/giant，机器慢时调到big能省不少时间。车辆、起重机、喷泉等道具来自 assets/structures/ 下的.schem模板，地标建筑则从 3D 模型体素化而来，一个--no-3d能把 3D 模型和这些道具全部关掉。路牌与广告牌用--signage三档控制：none、默认的basic（路名、交通标志、公交站牌、广告牌）和full（额外生成店铺招牌、门牌号）。大区域生成建议保持--interior（建筑室内生成，默认关闭）不动。
大区域与纯地形：--bbox、比例尺和生成前预览
这一节面向"要跑一大片地方"的场景。--bbox决定区域范围，格式如48.1,11.5,48.2,11.6（最小纬度,最小经度,最大纬度,最大经度）；GUI 里框选时可直接读取对应坐标。配合--mode terrain-only只出地形、不查任何地图数据，是最省事的批量跑法。--scale在这里再出现一次：比例越大内存和磁盘占用越高，先小比例试跑再放大是稳妥的做法。另外，生成前加一个--map-preview，会先渲染一张俯视 PNG 图，让你进游戏前就检查整体布局是否合理。遇到问题时，参数细节和 FAQ 先查项目 Wiki；某片建筑没出来、坐标对不上这类问题，带上--bbox和完整参数去 Issues 页提问，GUI 里也有直达 Discord 社区的入口。
【免费下载链接】arnisGenerate any location from the real world in Minecraft with a high level of detail.项目地址: https://gitcode.com/GitHub_Trending/ar/arnis
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
