企业官网建设流程全解析

星露谷农场规划器：免费完成农场布局设计与存档导入

【免费下载链接】stardewplannerStardew Valley farm planner项目地址: https://gitcode.com/gh_mirrors/st/stardewplanner

星露谷农场规划器是一个免费的在线农场布局工具，玩家可以在浏览器里选农场地图、拖拽摆放作物、建筑与洒水器，生成设计方案并保存；已有存档的玩家还能直接导入存档继续优化现有农场。

一个卡住玩家布局的场景

开局买下一块标准农场后，头几周常这样度过：花两三个游戏日搭起鸡舍，测试几天发现它离种植区太远，每天捡蛋要横穿整个农场；挪走重建又要再花几天，栅栏还挡住了通往温室的必经路。反复用存档点试错，每套方案都要付出游戏内天数成本。问题不在玩家不懂规划，而在于游戏里缺少一种零成本的比稿方式——这正是画布类规划工具要解决的。

核心能力总览

• 地图库覆盖游戏全部官方农场类型：标准、森林、山顶、海滩、四角以及姜岛、矿场，layouts.js 里还收录了记忆农场、社区农场、终极农场等数十张社区与 MOD 地图。
• 侧边栏按建筑、设备、作物、装饰分类，点选后在画布上点放，落位前即可看到格子对齐的预览；每种地图还配有可建造、可通行、可开垦三层网格信息。
• 摆放结果实时渲染在对应地图背景上，换季节可看到作物外观变化，调整方案不需要退回游戏验证。
• 提供POST /api/import端点，接受 saveGame.xml 或 saveGame.zip，把既有存档解析成画布上的建筑与作物位置，导入后直接返回可编辑的设计页链接。
• 设计可一键保存并生成分享链接，服务端按内容哈希去重，相同布局不会重复占用存储。
• 代码以 Apache License 2.0 开源，可自由使用、修改和分发。

从启动到导入存档的完整流程

先在终端拿到项目并启动服务，随后打开本地地址即可进入规划界面：

git clone https://gitcode.com/gh_mirrors/st/stardewplanner cd stardewplanner npm install npm start

浏览器指向http://localhost:3000后进入画布页，在地图上选一块农场类型，例如标准农场。接着从顶部分类菜单挑一件建筑，如大谷仓，在可建造区域点一下落位；再挑铱洒水器和栅栏，沿种植区边缘补一圈。发现鸡舍挡住通道，选中它拖到另一侧，周围作物不需要重摆。对布局满意后保存，页面会给出一个可收藏、可分享的链接。

如果农场已经玩了一段时间，不必从零画起。把存档目录里的 saveGame.xml 上传到/api/import，导入成功后页面直接呈现现有建筑与作物位置，在此基础上挪动物品、补洒水器，完成一轮针对现有农场的优化。

进阶玩法

洒水器覆盖范围对照

洒水器决定种植区的最小网格尺度，三种等级的覆盖格数如下：

以 4×4 的田块为例，单个铱洒水器即可覆盖整块，而普通洒水器至少需要 4 个；规划时先用铱洒水器的覆盖圈量出田块，再决定田与田之间留多宽的通道。

如何把游戏存档导入规划器

把存档以file字段提交给POST /api/import即可，支持 saveGame.xml 或 saveGame.zip，文件上限 25MB；服务端按每分钟约 40 次限流，超出会返回 429。响应体里包含id与absolutePath，前者是存档的可读标识，后者就是导入后设计页的地址。注意 zip 必须是普通 zip 格式，gzip 压缩包会被拒绝。

避坑指南

• 建筑无法放置：光标下的格子不在该地图的可建造层内，或落在已有建筑、不可通行区，换个位置即可，网格数据在 js/data/layer-information 目录按地图分文件存放。
• 洒水器之间露出干土：相邻覆盖格之间留了超过一步的空隙，把田块收拢成洒水器半径的整数倍，或改用覆盖更大的等级。
• 导入存档失败：文件不是 saveGame.xml 或 zip 已损坏，换回游戏原始目录的文件再试，同时确认大小不超过 25MB 且未触发限流。

技术速览

后端是 Node.js + Express 的轻量服务，数据层为 MySQL 与 Knex，前端为原生 JavaScript 加 Canvas 渲染。关键文件及职责：

• index.js：应用入口，挂载静态目录与 /api 路由；
• engine/board.js：画布渲染与交互核心；
• engine/brush.js：画笔与拖放逻辑；
• data/layouts.js：各农场地图的尺寸、房屋与温室坐标；
• routes/index.js：/api/import、/api/save、/api/render 等接口实现。

参与贡献

项目采用 Apache License 2.0，可自由使用与再分发；想改进功能时，克隆仓库、切一个功能分支、提交 PR 即可，通过审核后合入主站。

好的布局在游戏外就能定型，把反复试错的时间还给耕作本身。

【免费下载链接】stardewplannerStardew Valley farm planner项目地址: https://gitcode.com/gh_mirrors/st/stardewplanner