TileSet 资源规范（V1.0 完整版）

AI World Sim 的唯一标准资源规范。统一全场景、角色、特效、UI 的美术尺寸、风格、动画、输出与引擎适配规则。

• Version: 1.0 Full
• Target Engine: PixiJS 7.x+
• Frontend Stack: Nuxt 3 + Vue3 + TypeScript
• Render Solution: WebGL / PixiJS
• Art Style: Dark Pixel Art（统一暗黑像素风）
• Base Tile Size: 32 × 32 px
• 参考美术基准： Stardew Valley、Eastward、Animal Crossing、RimWorld
• 整体色调： 偏暗、对比度适中、像素轮廓清晰、低饱和度写实像素风格

---

一、设计目标与核心约束

本资源包为 AI World Sim 多人在线沙盒模拟世界的唯一标准资源规范，统一全场景、角色、特效、UI 的美术尺寸、风格、动画、输出与引擎适配规则，支撑地图无限生成、昼夜天气、建筑扩建、动态交互、多人同步核心玩法，可长期迭代复用。

资源必须满足硬性能力：

• 支持超大地图无限平铺扩展，无拼接瑕疵
• 完全适配 AI 程序化随机地图生成逻辑
• 资源轻量、可批量加载，适配多人在线场景同步
• 原生支持昼夜光影明暗叠加、色温切换
• 无缝适配雨雪雾等多层天气渲染叠加
• 支持建筑单体替换、扩建、拆除的模块化适配
• 所有动态资源支持帧动画循环、暂停、速度调节

---

二、项目资源目录结构

assets/
    # 地图核心瓦片（静态拼接层）
    tiles/
        terrain/      # 基础地形草地/泥土/石地/沙地
        road/         # 全类型道路拼接块
        water/        # 静态水域+动态水域瓦片
        nature/       # 自然地貌装饰
        buildings/    # 全部建筑主体
        props/        # 地面道具、摆件、边界装饰

    # 动态精灵（角色/载具交互层）
    sprites/
        npc/          # 所有职业NPC角色精灵
        player/       # 玩家主角精灵
        vehicle/      # 全部交通工具精灵

    # 全局动态特效（叠加渲染层）
    effects/
        water/        # 浪花、涟漪、水波纹
        smoke/        # 青烟、浓烟、浮动烟雾
        fire/         # 明火、星火、燃烧特效
        weather/      # 雨、雪、雾、光晕天气

    # 全局UI资源
    ui/
        icons/        # 职业、状态、功能小图标
        panels/       # 弹窗、面板、背景框
        buttons/      # 各类交互按钮

    # 图集打包输出目录（最终上线资源）
    atlas/
        world_tiles.png
        world_tiles.json

---

三、通用 Tile 强制规范

1. 基础尺寸标准

• 标准地形/道路/自然瓦片：32 × 32 px
• 建筑特殊尺寸：64×64 px、96×96 px（单独规定，禁止随意改动）

2. 美术出图硬性规则

• 严格 Pixel Perfect 像素点对点绘制，无模糊、无抗锯齿、无高斯模糊
• 输出格式：24位透明底 PNG，禁止 JPG、WEBP、带白底图片
• 无多余杂点、隐形像素、边缘溢色
• 四边边缘绝对干净，无锯齿、无半透明过渡边
• 全资源统一明暗基调、饱和度、对比度，风格零偏差

3. 边距与扩边工程标准（解决 WebGL 黑缝）

• Padding 内边距： 2 px（主体内容居中留白）
• Extrude 扩边： 1 px（边缘像素复刻扩边）
• 所有瓦片必须执行扩边流程，图集打包禁止省略

4. 图层渲染层级规则

从底到顶渲染顺序：

地形瓦片 → 道路瓦片 → 水域瓦片 → 自然装饰 → 建筑 → 道具 → 角色/载具 → 动态特效 → UI层

所有资源层级固定，禁止乱序。

---

四、地形 Tile 完整明细规范

1. 草地 Grass（16张）

纯草地、浅草、深草、枯草边、草地外边缘、草地内转角、草地外转角、高低草过渡。全覆盖地形拼接场景，无拼接断层。

2. 泥土 Dirt（12张）

浅泥土、深泥土、干土、湿土、直向泥路、弯曲泥路、草地泥土过渡边。适配野外、农田、荒野场景。

3. 石地 Stone（16张）

天然乱石地、规整石砖路、裂纹石面、老旧石面、青苔石地、石地边缘、石草过渡边。适配广场、古道、废墟、古镇场景。

4. 沙地 Sand（12张）

干沙地、细沙地、海边湿沙地、沙滩边缘、沙地草地过渡、沙地水域过渡。适配沙漠、河滩、海岸场景。

5. 水域 Water（32张 + 4帧循环动画）

静水湖面、缓流河水、海面静水、近海波浪、远海大浪、水域边缘、水陆过渡边、深浅水过渡。

动画强制标准： 4帧匀速循环，无跳帧、无卡顿；明暗层独立，可适配昼夜亮度叠加，白天通透、夜晚偏暗深蓝。

---

五、道路 Tile 完整拼接规范

• 道路基准宽度： 1 Tile（32px），全局道路宽度统一，无宽窄偏差
• 资源总量： 40+张，实现全自动无瑕疵拼接

完整品类： 水平直路、垂直直路、四角转角路、四向十字路口、T字三向路口、左右断头路、尽头死路、路边停车格、人行横道、道路与草地过渡边、道路与泥土过渡边。

美术规则： 道路纹理方向统一、接缝像素对齐、无拼接黑线、无纹理错位。

---

六、建筑资源完整规范

1. 住宅建筑（12张 | 64×64 px）

原木小屋、简陋石屋、普通民居、双层小楼、精致住宅、豪华独栋、老式公寓、多层居民楼、乡村小院、屋顶变体、旧房翻新款、极简毛坯房。

适配：居民区随机生成、住宅等级迭代、旧房换新建筑替换逻辑。

2. 商业建筑（96×96 px）

咖啡馆、休闲酒吧、便民超市、中式餐饮店、西式餐厅、银行网点、公共图书馆、文创商店。

3. 公共建筑（96×96 px）

小学、综合医院、社区警局、消防中心、市政大厅、公共服务中心。

4. 工业建筑

轻型加工厂、大型厂房、仓储库房、物资仓库、火力发电站、小型能源站。

5. 办公建筑

普通写字楼、科技公司大楼、创业产业园、商务办公楼。

建筑通用规则： 底部对齐 32px 瓦片网格、阴影统一向下、明暗光影统一、支持单层替换叠加昼夜滤镜。

---

七、自然场景与道具完整资源规范

类别	数量	说明
树木 Tree	6种	小树、中树、大树、枯树、常青松树、阔叶树，支持疏密搭配随机生成
灌木 Bush	6种	高低疏密样式
花卉 Flower	12种	不同野花、园艺花簇
景观岩石 Rock	8种	大小、裂纹、青苔岩石
枯木原木 Log	4种	横放、斜放、断木样式
路灯 Lamp	4种	老式、现代、庭院、马路路灯
休闲长椅 Bench	4种	公园、街边、庭院款式
围栏栅栏 Fence	16种	木栏、石栏、铁栏、矮篱、高墙样式
邮箱 Mailbox	4种	复古、现代、小区、街边邮箱

通用道具规则： 底部贴合地面、无悬浮、无穿模，可自由随机摆放组合。

---

八、NPC 角色精灵完整规范

• 标准尺寸： 32×48 px
• 四朝向： 上、下、左、右，全覆盖视角
• 单朝向帧数： 8帧/动作，动作流畅均匀，无快慢帧偏差

完整动作状态库： 待机、慢走、快跑、静坐、睡眠、工作劳作、进食、对话交谈、喜怒哀乐情绪动态。

角色美术规则： 像素轮廓清晰、比例统一、阴影统一、同职业色调统一，多人同屏无违和感。

---

九、交通工具完整规范

品类： 家用小汽车、货运卡车、城市公交、救护车、警车、自行车

动画标准： 左右平移行驶动画，匀速运动，贴合道路网格；支持静止、行驶、停靠三种状态切换。

适配逻辑： 可沿道路路径点移动，支持多人同屏载具同步显示。

---

十、动态特效完整帧规范

特效	帧数	说明
水域 Water	4帧匀速循环	涟漪、细浪
火焰 Fire	6帧燃烧循环	星火、明火、旺火梯度
烟雾 Smoke	8帧上浮消散循环	轻烟、浓烟
降雨 Rain	8帧下落循环	细雨、大雨
降雪 Snow	8帧飘落循环	小雪、大雪
光影 Light	4帧明暗呼吸闪烁	适配昼夜切换、路灯点亮

特效通用规则： 透明底、无黑边、叠加模式适配 WebGL，可调节透明度、速度、密度。

---

十一、UI 图标完整规范

1. 职业图标

程序员、医生、教师、警察、工人、厨师、商人、艺术家。图标风格统一极简像素风。

2. 角色状态图标

开心、生气、难过、疲劳、困倦、饥饿、恋爱、工作、聊天、学习。状态辨识度极高。

UI 通用标准： 尺寸统一、线条粗细一致、配色统一、无杂色、适配浅色/深色背景切换。

---

十二、PixiJS 图集打包与 JSON 标准

所有图集输出 JSON 必须严格匹配以下结构，引擎零修改直接解析：

{
  "frames": {
    "grass_01": {
      "frame": { "x": 0, "y": 0, "w": 32, "h": 32 },
      "rotated": false,
      "trimmed": false,
      "spriteSourceSize": { "x": 0, "y": 0, "w": 32, "h": 32 },
      "sourceSize": { "w": 32, "h": 32 }
    }
  }
}

打包规则： 禁止旋转资源、禁止自动裁切、禁止自动缩放、保留原始尺寸与坐标。

---

十三、全局统一命名规范

全资源强制使用 snake_case 纯小写下划线命名，禁止大写、驼峰、空格、中文、特殊符号。

标准命名范式： 类别_细分_状态_朝向_序号

规范示例：

类别	示例
地形	grass_01、dirt_deep_02
道路	road_corner_ne、road_cross、road_t_left
自然	tree_oak_large、tree_pine_small
建筑	hospital、school、factory、cafe
角色	npc_doctor_walk_down_01、npc_teacher_idle_up_02

---

十四、动画全局统一参数

• 通用帧率： FPS 15（全局统一，避免快慢动画割裂）
• 循环模式： 除一次性特效外，所有环境动画默认无限循环
• 昼夜适配： 所有动态资源不改变帧内容，仅通过引擎亮度/色温滤镜调节
• 天气叠加： 特效层独立渲染，不与地形、角色图层冲突

---

十五、资源输出与交付标准

1. 出图格式

全部资源：透明底 PNG，RGB8 + Alpha 通道，无压缩失真。

2. 图集打包工具要求

支持 Extrude 扩边、固定 Padding、禁止旋转裁切，输出标准 PixiJS 图集。

3. 交付包结构

源码分层资源 + 最终 atlas 打包资源双份交付。

4. 验收硬性标准

• 无拼接黑缝、无像素错位、无悬浮穿模
• 所有命名 100% 合规
• 动画无跳帧、无卡顿、无反向异常
• 全资源色调风格统一
• WebGL 渲染无报错、无透明异常

---

十六、版本迭代规划

V1.0 基础世界（已固化）

完整地形、道路、建筑、自然道具、基础 NPC 静态资源，支撑基础地图生成。

V2.0 动态世界升级

全量动画适配、完整天气系统、昼夜光影系统、载具动态、角色全动作动画。

V3.0 场景深度拓展

室内精细化地图、地铁交通系统、大型商业综合体、超大森林生态、港口海岸线专项场景、更多细分职业与交互状态。

---

十七、最终规范目标

本 V1.0 完整版规范，实现美术标准化、工程规范化、引擎适配一体化、迭代可持续化，构建一套完全适配 AI World Sim 沙盒多人在线模拟玩法的原创暗黑像素艺术资源体系。

• 可维护： 规则统一、问题可溯源、迭代不混乱
• 可扩展： 模块化资源，支持无限新增场景与道具
• 可复用： 全资源通用适配多场景、多玩法
• 引擎兼容： 100% 适配 PixiJS + WebGL 渲染
• 线上稳定： 满足多人在线、大场景、高并发渲染需求

---

📐 详细美术规范见 Design — Art Bible 📐 详细界面设计见 Design — UI Design 📦 资源管线流程见 Design — Asset Pipeline