datawhale/whale-town-front
3
2
Fork 2
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feature/网格瓦片系统 #9

Merged
moyin merged 7 commits from feature/网格瓦片系统 into main 2026-01-03 22:40:55 +08:00
Conversation 0 Commits 7 Files Changed 28 +644 -196
moyin commented 2026-01-03 22:40:51 +08:00
Owner
Copy Link

提交记录 - 网格瓦片系统功能完善

提交概览

分支: feature/网格瓦片系统
提交时间: 2026年1月3日
提交数量: 4个独立提交

详细提交记录

1. style：统一代码文件末尾换行格式

提交ID: a3d384d
类型: 代码格式调整

修改文件:

  • _Core/managers/NetworkManager.gd
  • _Core/managers/ResponseHandler.gd

说明: 为核心管理器文件添加标准的文件末尾换行符，统一代码格式规范。

2. scene：创建广场地图场景并添加环境瓦片资源

提交ID: e9fa212
类型: 场景和资源文件

新增文件:

  • scenes/maps/square.tscn - 广场地图场景
  • assets/sprites/environment/curb.png - 路缘瓦片纹理
  • assets/sprites/environment/floor_tile.png - 地板瓦片纹理
  • assets/sprites/environment/square.png - 广场瓦片纹理
  • assets/sprites/environment/square1.png - 广场瓦片变体
  • assets/sprites/environment/广场瓦片集.png - 瓦片集合
  • assets/sprites/environment/草地.png - 草地瓦片纹理
  • 以及对应的 .import 文件

说明:

  • 创建了新的广场地图场景，用于展示网格瓦片系统
  • 添加了多种环境瓦片纹理资源，支持32x32网格系统
  • 包含草地、地板、路缘等多种地形瓦片素材

3. docs：添加网格瓦片系统功能文档

提交ID: f527fa3
类型: 文档更新

新增文件:

  • docs/06-功能模块/网格瓦片系统.md

文档内容:

  • 系统概述和核心组件介绍
  • GridSystem和GrassTile的详细说明
  • 编辑器和代码使用方法
  • 网格规范和纹理要求
  • 完整的API参考文档

说明: 为网格瓦片系统提供了完整的功能文档，包含使用指南和技术规范。

4. chore：清理空的占位文件

提交ID: c621d70
类型: 项目维护

删除文件:

  • assets/sprites/sprites/characters/.gitkeep
  • assets/sprites/sprites/effects/.gitkeep
  • assets/sprites/sprites/environment/.gitkeep
  • tools/README.md

说明: 清理了不再需要的空占位文件和空文档，保持项目结构整洁。

功能特性

本次提交完善了网格瓦片系统的以下功能：

✅ 已完成功能

  • 32x32像素标准网格系统
  • 草地瓦片预制体组件
  • 广场地图场景示例
  • 多种环境瓦片资源
  • 完整的功能文档
  • 代码格式规范化

🎯 核心组件

  • GridSystem: 网格坐标转换和位置计算
  • GrassTile: 可视化瓦片组件，自动网格对齐
  • Square Scene: 广场地图场景，展示瓦片系统应用

📋 技术规范

  • 网格大小：32x32像素
  • 坐标系：左上角原点(0,0)
  • 纹理格式：PNG，尺寸为32的倍数
  • 对齐方式：瓦片中心对齐到网格中心

提交规范遵循

本次提交严格遵循项目的Git提交规范：

  1. 拆分原则: 将不同类型的改动拆分为独立提交
  2. 类型标识: 使用正确的提交类型（style、scene、docs、chore）
  3. 描述规范: 使用中文冒号，简短明确的描述
  4. 详细说明: 为复杂提交添加详细的改动说明
  5. 原子性: 每次提交都是完整且可独立运行的改动

下一步计划

  • 添加更多瓦片类型（水面、建筑等）
  • 实现瓦片编辑器工具
  • 优化大地图的瓦片渲染性能
  • 添加瓦片碰撞检测系统
# 提交记录 - 网格瓦片系统功能完善 ## 提交概览 **分支**: `feature/网格瓦片系统` **提交时间**: 2026年1月3日 **提交数量**: 4个独立提交 ## 详细提交记录 ### 1. style：统一代码文件末尾换行格式 **提交ID**: `a3d384d` **类型**: 代码格式调整 **修改文件**: - `_Core/managers/NetworkManager.gd` - `_Core/managers/ResponseHandler.gd` **说明**: 为核心管理器文件添加标准的文件末尾换行符，统一代码格式规范。 --- ### 2. scene：创建广场地图场景并添加环境瓦片资源 **提交ID**: `e9fa212` **类型**: 场景和资源文件 **新增文件**: - `scenes/maps/square.tscn` - 广场地图场景 - `assets/sprites/environment/curb.png` - 路缘瓦片纹理 - `assets/sprites/environment/floor_tile.png` - 地板瓦片纹理 - `assets/sprites/environment/square.png` - 广场瓦片纹理 - `assets/sprites/environment/square1.png` - 广场瓦片变体 - `assets/sprites/environment/广场瓦片集.png` - 瓦片集合 - `assets/sprites/environment/草地.png` - 草地瓦片纹理 - 以及对应的 `.import` 文件 **说明**: - 创建了新的广场地图场景，用于展示网格瓦片系统 - 添加了多种环境瓦片纹理资源，支持32x32网格系统 - 包含草地、地板、路缘等多种地形瓦片素材 --- ### 3. docs：添加网格瓦片系统功能文档 **提交ID**: `f527fa3` **类型**: 文档更新 **新增文件**: - `docs/06-功能模块/网格瓦片系统.md` **文档内容**: - 系统概述和核心组件介绍 - GridSystem和GrassTile的详细说明 - 编辑器和代码使用方法 - 网格规范和纹理要求 - 完整的API参考文档 **说明**: 为网格瓦片系统提供了完整的功能文档，包含使用指南和技术规范。 --- ### 4. chore：清理空的占位文件 **提交ID**: `c621d70` **类型**: 项目维护 **删除文件**: - `assets/sprites/sprites/characters/.gitkeep` - `assets/sprites/sprites/effects/.gitkeep` - `assets/sprites/sprites/environment/.gitkeep` - `tools/README.md` **说明**: 清理了不再需要的空占位文件和空文档，保持项目结构整洁。 ## 功能特性 本次提交完善了网格瓦片系统的以下功能： ### ✅ 已完成功能 - [x] 32x32像素标准网格系统 - [x] 草地瓦片预制体组件 - [x] 广场地图场景示例 - [x] 多种环境瓦片资源 - [x] 完整的功能文档 - [x] 代码格式规范化 ### 🎯 核心组件 - **GridSystem**: 网格坐标转换和位置计算 - **GrassTile**: 可视化瓦片组件，自动网格对齐 - **Square Scene**: 广场地图场景，展示瓦片系统应用 ### 📋 技术规范 - 网格大小：32x32像素 - 坐标系：左上角原点(0,0) - 纹理格式：PNG，尺寸为32的倍数 - 对齐方式：瓦片中心对齐到网格中心 ## 提交规范遵循 本次提交严格遵循项目的Git提交规范： 1. **拆分原则**: 将不同类型的改动拆分为独立提交 2. **类型标识**: 使用正确的提交类型（style、scene、docs、chore） 3. **描述规范**: 使用中文冒号，简短明确的描述 4. **详细说明**: 为复杂提交添加详细的改动说明 5. **原子性**: 每次提交都是完整且可独立运行的改动 ## 下一步计划 - [ ] 添加更多瓦片类型（水面、建筑等） - [ ] 实现瓦片编辑器工具 - [ ] 优化大地图的瓦片渲染性能 - [ ] 添加瓦片碰撞检测系统
moyin added 7 commits 2026-01-03 22:40:51 +08:00
feat：实现32x32网格系统核心功能 ba5b0daa13 
- 添加GridSystem类提供网格坐标转换
- 支持世界坐标与网格坐标互转
- 提供位置吸附和距离计算方法
- 包含网格区域和边界检查功能
config：更新核心配置支持网格系统 7a6e5be4f8 
- EventNames添加网格相关事件定义
- ProjectPaths添加网格系统和地形资源路径
scene：创建草地瓦片预制体 ced69fd4b6 
- 实现GrassTile组件，支持32x32网格对齐
- 添加自动纹理验证和占位符生成
- 提供网格位置设置和世界坐标转换
- 包含位置变化信号和调试功能
style：统一代码文件末尾换行格式 a3d384d39d
scene：创建广场地图场景并添加环境瓦片资源 e9fa21280e 
- 新增square.tscn广场地图场景
- 添加多种环境瓦片纹理资源
- 包含草地、地板、路缘等瓦片素材
docs：添加网格瓦片系统功能文档 f527fa3c38 
- 详细说明32x32网格系统的使用方法
- 包含核心组件介绍和API参考
- 提供编辑器和代码使用示例
chore：清理空的占位文件 c621d70475 
- 删除sprites目录下的空.gitkeep文件
- 删除tools目录下的空README.md文件
moyin merged commit 3d6c4e5356 into main 2026-01-03 22:40:55 +08:00
moyin deleted branch feature/网格瓦片系统 2026-01-03 22:40:56 +08:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
feifei moyin xiangwang25
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: datawhale/whale-town-front#9
Delete Branch "feature/网格瓦片系统"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?