星露谷物语农场规划器上手全攻略：从零布局到存档导入的完整实践

星露谷物语农场规划器上手全攻略：从零布局到存档导入的完整实践

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

如果你玩过《星露谷物语》，一定经历过这种时刻：第一年冬天发现铱洒水器漏浇了两排作物，想扩建谷仓却发现温室挡了路，最后只能忍痛推掉鸡舍、重排上百株作物，白白搭进去两个星期的收成。这种"返工税"几乎每个玩家都交过，而Stardew Valley 农场规划器（stardewplanner）的价值，就是把所有试错成本压在动手之前——在浏览器里先把整座农场"画"出来，确认无误再照图施工，游戏里那套"拆了重来"的流程在这里只需点一下撤销。

一分钟了解：这东西到底能干什么

规划器的本质是一张可无限修改的电子图纸。它基于 Node.js + Express 构建，前端用原生 JavaScript + SVG 渲染（依赖 Snap.svg），没有任何构建步骤，改完代码刷新页面就能看到效果。你可以在上面摆建筑、铺地板、种作物，系统会实时模拟游戏规则：哪些格子能耕地、哪些能盖房子、哪些根本过不去，全都按真实数据来，而不是让你在一张空白纸上随意发挥。

更难得的是地图覆盖范围：官方农场（标准、山顶、沙滩、四角、姜岛、采矿、钓鱼等十余种）之外，它还收录了二十多张知名 Mod 农场，比如 Immersive Farm、Larger Hilltop、Ali's Farm 系列，装了 Mod 的玩家同样能精确规划，切图时还会弹出作者信息以示尊重。

五分钟把本地工作台跑起来

环境要求低到几乎可以忽略，只需要一个 Node.js 环境。跟着下面三步走：

git clone https://gitcode.com/gh_mirrors/st/stardewplanner cd stardewplanner npm install && node index.js

随后浏览器打开http://127.0.0.1:3000，规划界面即刻呈现。因为前端零构建，想调试的人改完public/planner/js/里的代码，刷新页面就能看到变化，非常适合边玩边改的折腾型玩家。

王牌功能：洒水器覆盖范围可视化

很多人的第一年规划都是"种完再说"，直到发现浇水成了每天最累的活。规划器最实用的功能就是覆盖范围高亮：普通洒水器覆盖 3×3、优质洒水器 5×5、铱洒水器 7×7，摆下去之后湿润区域直接高亮，漏不漏浇、重不重叠一目了然。

类似的可视化还有稻草人的驱赶范围、蜂房的作用半径、祝尼魔小屋的收割范围，全部可以一键开关。新手可以用它设计出永不需要返工的自动化浇灌系统；进阶玩家则能拿来极限优化——在保证全覆盖的前提下把洒水器数量压到最少，给作物腾出更多格子。如果你用的是 Mod 地图，别忘了换图后系统还会用 SMAPI 导出的数据层校准放置限制，精度比早期版本高了不少。

把真实存档倒进规划器：一条 API 搞定

规划器最有技术含量的一手是存档导入。它内置 Express 路由，接受saveGame.xml或saveGame.zip（注意是常规 zip，不是 gzip），解析后重建你的真实农场：已经建好的建筑、种下的作物、铺好的地板全部还原到画布上。

curl --form "file=@saveGame.xml" http://127.0.0.1:3000/api/import

导入成功后，你可以在现有布局上继续优化——补洒水器、重新规划扩建区域，改完通过POST /api/save保存方案，服务端用 knex 接 MySQL 存储，并生成可读 ID 的分享链接。底层还预留了 Google Cloud Storage 上传（lib/uploader.js、lib/migrate_to_google.js），为多人分享铺好了路。

三个让效率翻倍的进阶技巧

• 季节渲染预览：界面里的渲染按钮能把农场按指定季节生成效果图。夏耕规划完，切成秋景看看配色，确认果树不会挡住视线再动工，能少走很多弯路。
• 导出 PNG 成品图：编辑器支持把当前画布导出为图片，做完规划直接导出当壁纸、发群炫耀，或者打印出来对着施工，比手机截图清晰得多。
• 键盘拖拽与覆盖开关：拖动建筑时按住覆盖模式可强制放置重叠元素；坐标显示开关能精确对齐每一格，适合强迫症级别的对齐控。删除建筑也有多种快捷方式，按Del或Esc即可，不必一个个右键。

从使用者到贡献者：代码结构其实很好懂

项目目录清爽到让人舒适：lib/下是数据库、导入器、迁移脚本；migrations/里按时间戳命名的文件记录着 schema 演进史；engine/下的board.js、brush.js、building.js把画布、画笔、建筑三者彻底解耦。想加一个新作物？去public/planner/js/data/sprites.js注册贴图，再往data/补一份 JSON 配置即可。

社区已经在讨论这些方向：自动统计摆放物品数量（比如算算一共放了多少洒水器）、更逼真的建筑深度渲染、更多树木和树液采集器类型。项目维护者采用 PR 驱动的协作方式——提交代码、通过审核、合入主干，你的名字就会出现在贡献者名单里，官方站点也会同步上线你的功能。

把图纸变成现实

游戏里返工一次，损失的是一个季节的收成；规划器里返工一次，损失的只是几秒钟。两者之间的差距，就是你从读到这里开始行动的几分钟。选一张你正在用的农场地图，先摆个洒水器看看覆盖范围，再拖一栋谷仓试试碰撞检测——你的完美农场，值得先在这张永不出错的图纸上诞生。

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