# DoubleGridSystemUnity **Repository Path**: AXingYa/double-grid-system-unity ## Basic Information - **Project Name**: DoubleGridSystemUnity - **Description**: No description available - **Primary Language**: C# - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-13 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # DoubleGridSystemUnity 基于 Dual Grid(双网格)的 Unity 2D 自动拼接地形系统。逻辑地形数据与 Tilemap 表现分离,支持 16-Tile 自动拼接、稳定地形身份、多地形规则融合、运行时绘制、撤销、批量刷新、版本化 JSON 存档和编辑器场景绘制。 本仓库既是可复用的 UPM 包,也是演示项目。 ![Dual Grid 自动拼接示意](com.doublegrid.system/Documentation~/images/preview.png) ## 目录 ```text double-grid-system-unity/ ├── com.doublegrid.system/ 可导入其它项目的 UPM 包 │ ├── Runtime/ 数据、渲染、编辑、存档(不引用 UnityEditor) │ ├── Editor/ Inspector、Scene 绘制工具 │ ├── Tests/EditMode/ 自动化测试 │ ├── Samples~/Demo/ 示例 │ └── Documentation~/ 文档 ├── DoubleGridSystem/ 演示用 Unity 2022.3 项目 │ ├── Assets/Scenes/SampleScene.unity │ └── Packages/manifest.json file: 引用上面的包 └── Tileset_256/ 拆图素材(不属于包) ``` ## 快速开始 ### 作为包导入其它项目 把 `com.doublegrid.system` 放到目标项目旁边,在目标项目 `Packages/manifest.json` 中加入: ```json "com.doublegrid.system": "file:../com.doublegrid.system" ``` 或通过 Package Manager 的 **Add package from git URL** 使用: ```text https://your.git.host/your-account/double-grid-system-unity.git?path=/com.doublegrid.system ``` 详细接入步骤、坐标约定、Mask 映射、API、存档与编辑器工具说明见 [包文档](com.doublegrid.system/README.md)。 ### 运行演示 用 Unity 2022.3 打开 `DoubleGridSystem` 项目,打开 `Assets/Scenes/SampleScene.unity`,进入 Play: - 左键绘制、右键擦除、按住拖动连续绘制; - `1` / `2` / `3` 切换单格 / 方形 / 圆形笔刷; - `4` / `5` 切换笔刷地形为草地 / 泥土; - `Space` 清空,`R` 重新生成; - `Ctrl+Z` / `Ctrl+Y` 撤销 / 重做; - `F5` / `F9` 保存 / 加载 JSON 存档。 编辑器内绘制:**Tools → Double Grid → Map Painter**,画完直接进入 Play;演示项目的 `DualGridDemo` 会优先加载 Map Asset 中已编辑的地图(其他场景使用 `DualGridMapLoader`)。 Fusion 配置:**Tools → Double Grid → Fusion Setup Wizard**,按向导创建/关联 Catalog、Definition、Rule Set 和 Fusion Tilemap。 三/四地形示例:演示场景左侧是三地形 T,右侧是四地形十字;生成的美术在 `Assets/Arts/Generated/`,可直接替换。 自动生成合成图:**Tools → Double Grid → Terrain Art Generator**,按 Catalog 批量生成 Pair,Junction 按四角选择生成,并自动写回 Rule Set。 ## 约定 - 逻辑坐标 `(x, y)` 是网格顶点,也是表现格的左下角;修改一个顶点影响四个表现格。 - Mask 位权:`BL = 1`、`BR = 2`、`TL = 4`、`TR = 8`;Mask 0 清空该表现格。 - Mask → 16-Tile 槽位映射沿用项目已验证的顺序,不可随意改动。 ## 测试 包的 `Tests/EditMode` 覆盖 Mask、映射表、刷新范围、批量去重、笔刷、撤销、地形身份、规则解析、融合渲染和存档 v1/v2 兼容。演示项目已把包加入 `testables`,直接打开 **Window → General → Test Runner** 运行即可(当前 103 个 EditMode 测试)。 命令行: ```text Unity.exe -batchmode -projectPath DoubleGridSystem -runTests -testPlatform EditMode -testResults results.xml ``` ## 许可证 [Mulan PSL v2](LICENSE)