跳到正文

大地图:程序化布局、离线烘焙与斜看的镜头

联机放置游戏第 09 节 / 共 11 节 ·2026-11-16·~6 min

dock 的「地图」,也是小窗模式下的整页画面。代码在 client/assets/scripts/visual/pages/MapPage.ts(加 MapHd2d.ts、MapMinimap.ts、MapZoomBar.ts),生成与烘焙工具在 tools/art/map/ 和 tools/art/paperdoll/preview/。

1. 路线:烘焙式 2.5D

2026-11-09 用户拍板:场景在 3D 里搭,从固定相机离线烘成图,游戏里仍是 2D。

  • 不走引擎里的实时 3D:客户端没有 3D 管线,开发机上没装 Creator,网页性能也没把握。
  • 角色和场景用同一台相机、同一套像素化烘出来,所以拼在一起是一个画风。
  • 「HD-2D」(八方旅人那种)的层次感留给后处理:透视倾角、景深、调色、雾气。
  • 不画简笔画(用户:「简笔画不如不显示」):还没有烘焙美术的地点只挂名牌(图标 + 名字 + 等级),不画占位色块。

2. 程序化布局:街村,不是一圈

最早是手摆地点,城镇全挤在一个圆里,用户觉得很怪,要查 PCG 布局的做法。现在是 tools/art/map/gen-world.mjs 离线按固定种子生成一次,结果提交进仓库(游戏里不随机):

  1. 地貌:值噪声 fBm,2 米一格。十个地形特征:湖、森林、田地、山,加上六个战斗区域各自的地貌(雪原压在北边)。每个特征有半径、离村子的距离范围和最小间隔,边缘用域扭曲的椭圆,看着不像圆规画的。参考 Red Blob Games 的噪声地图 [1]。
  2. 采集建筑跟着资源走:伐木场在林子边,矿场在山脚,渔港在湖边,农庄在田里。
  3. 路网:A* 找路,按地貌给代价(草地 1、森林 5、岩石 6、水不可走),已有的路打折——所以新路倾向于从老路上分出去,长成树枝状。
  4. 沿路切地块摆房子:市场占十字路口,加工类和战斗类建筑沿路聚成街区。这是 Emilien 等 2012 年「任意地形上的村庄程序化生成」[2] 的思路:先按地形铺路,再沿路切地块,长出来的是街村。
  5. 植被:Bridson 泊松圆盘撒点 [3],每种地貌有自己的半径和概率;有手绘贴片,也有 Quaternius 的 CC0 模型。
  6. 工作点:伐木场 20 米内最近的 12 棵树,矿场 22 米内最近的 8 块石头;渔港在岸边、农庄在田里标点。
  7. 地标:矿洞口、遗迹拱门、火山口。

它同时写出三样东西:烘焙场景 art-source/map/scenes/world.json(3119 个物体)、map_sites.csv 里 20 个地点的坐标、一张布局预览图。

3. 烘焙

tools/art/map/bake-scene.mjs 用无头 Edge 打开本地预览服务器的 /scene 页(three.js),跑完把文件一张张取回来。烘一整张世界约 15 分钟。

  • 相机:正交,俯角 35°,每米 80 像素;4 倍超采样后像素化(和角色同一个 pixel.js:4×4 块过半覆盖才出一个像素,线性空间平均颜色,场景量化到 24 级),描 1 像素深色轮廓。
  • 地面切成 512 像素一块,整张世界 10240×7680 像素,300 块。地面是 12 张无缝手绘纹理(草地、林地、鹅卵石、雪、土路……,1024 像素 = 12.8 米),按地貌铺,路边按噪声咬合。
  • 立着的东西一个一张贴片,记下脚底位置;正交相机下同一个模型、同一个朝向和缩放烘出来一模一样,所以按原型去重:745 个实例只要 283 张图。
  • 另出一张 2560×1920 的缩小全图,镜头拉远时用。
  • 影子:有的贴片带单独的影子图(215 张);手绘的东西从图片 alpha 投影。

美术风格以《八方旅人》为基准,2026-11-11 用户的要求是「厚重而不是清新」:光影更厚重,房子更挺拔。

4. 镜头

  • 缩放 0.2–2(1 = 像素 1:1),默认 0.8;滚轮以光标为中心每格 ×1.12,右侧有对数刻度的缩放标尺。缩放低于 0.42 时只画那张缩小全图。
  • 斜看的透视镜头(MapHd2d):整张世界移到一个单独的层,由另一台相机渲进一张 RenderTexture,再斜 30°、视场 40° 透视着看——近大远小。人物、建筑贴片绕自己的脚底转回来站直,点击用射线打到地面或站着的建筑上。相机距离按「中间那一行保持 1:1」算。
  • 景深与调色(hd2d.effect):16 次黄金角采样的模糊,只模糊远处(画面上方);对比度 1.06、饱和度 1.12、偏暖;再加远处的雾、底部压暗、两侧暗角和暖色光。关掉后处理时,同样的气氛用 2 像素一条的色带画出来。
  • 跟随:镜头每帧向目标靠近 1 − 0.02^dt。
  • 小地图在右上角,以缩小全图为底,金点是村中心、红点是战斗区域、白点是村民、紫点是主角,点一下或拖动镜头就过去。

5. 排序、遮挡、裁剪

  • 人物和贴片按脚底的 y 排前后,只在顺序真的变了时才重排。
  • 走到房子后面时房子变半透明:主角在一张贴片后面(贴片脚底比主角低、够高、和主角的框重叠),这张贴片淡到不透明度 110/255。
  • 按需建节点:镜头移动超过 128 像素、缩放或倾角变了,才重新算一次可见范围(四周多留 320 像素);看得见的才建、才请求图片,近的先请求;出了画面就摘掉。

6. 可走区域与寻路

  • gen-world.mjs 顺手导出一张可走格子:1 米一格,128×168 格。水、建筑地块、树干和石头的半径不可走;路和每个地点门口(半径 1.6 米)强制可走。写进 scene.json 的 walk,93.6% 的格子可走。
  • 运行时,当前显示的那个建筑阶段或施工围挡的 block 多边形再挡掉一些格子(71 张贴片带这种多边形)。
  • 寻路(client-logic/mapwalk.ts):8 方向 A*,不许切墙角;目标落在不可走的格子上就换最近的可走格;找到后按视线拉直。键盘走(WASD / 方向键)时贴着墙滑。
  • 主角每秒 340 像素(约 4.3 米),村民 260。

7. 地图上的人

  • 主角:点地面走过去;点地点走到跟前打开它的页面(建筑 → 技能页,市场 → 市场页,村中心 → 家园页);战斗区域只走过去、不跳页(战斗状态都在右侧状态栏,跳页多此一举)。跑动是 8 方向 × 22 帧的图集,按走过的距离翻帧,不按时间——脚不打滑。站着 3 秒后开始有小动作(抱臂、张望),之后每 6–12 秒一次。武器平时背在身后、副手挂在腰间。
  • 村民:做某个工作就去占这个地点的一个空闲工作点(先挑没被挡住的、一棵树先站一个人),从门口按寻路跑过去,面朝对象播 8 方向的工作动作:砍树、挖矿、锻造、钓鱼、采集、制作、烹饪、炼药、炼金。点占满了的在建筑门口排队。现在有 49 个工作点:伐木场 20、矿场 16、渔港 6、农庄 7。
  • 战斗者:在正在打的区域前排成一排,播职业自己的待机和攻击动作;攻击的接触帧和战斗时间线对齐(战斗是逐位重放的,见 战斗 )。出手之间转向最近的怪。
  • 溜达的怪:每个区域的普通怪在 420 像素范围内慢慢溜达,一颠一颠的。

8. 建筑阶段、摆设与时装

  • 12 座建筑 × 5 个阶段 = 60 张贴片,按建筑等级选(1–4 / 5–9 / 10–14 / 15–19 / 20)。没盖的 11 个地点显示施工围挡,贴地画:立起来的话在透视镜头下会悬空。
  • 144 件摆设:9 组、每组 16 件,5 级之内每升一级多一件。
  • 主角的时装是运行时拼的:每个部件有彩色和深度两张图集,逐像素保留最近的那一层,见 客户端 与 美术管线 。紫色、金色时装带特效(星光与符文、光环与上升的光点)。

9. 改地图的流程

建筑模型或摆设到了:放进 model-source/building/<id>/ 或 art-source/map/props/<组>/ → 重跑 gen-world.mjs(有模型就自动摆进去)→ bake-scene.mjs world 重烘 → npm run art:import → gen-meta.mjs → 提交。

参考

  1. Red Blob Games, Making maps with noise functions:https://www.redblobgames.com/maps/terrain-from-noise/
  2. Emilien, Bernhardt, Peytavie, Cani, Galin, Procedural Generation of Villages on Arbitrary Terrains, The Visual Computer, 2012
  3. Robert Bridson, Fast Poisson Disk Sampling in Arbitrary Dimensions, SIGGRAPH 2007 sketches:https://www.cs.ubc.ca/~rbridson/docs/bridson-siggraph07-poissondisk.pdf