greenredled

愿景：一个依托 Tauri 框架的 3D 交通模拟游戏，带你在十字路口控制校车，学习交通规则与红绿灯逻辑。 当前阶段：🎉 已完成项目初始化、游戏引擎与场景搭建，校车与红绿灯系统已可交互。

🚧 项目当前状态

最新提交：首次提交（约 10 分钟前）

当前仓库已完成以下工作：

• ✅ Tauri 桌面应用框架初始化
• ✅ 前端 Vite + Vue/React 脚手架搭建
• ✅ 3D 场景开发（Three.js / Babylon）
• ✅ 红绿灯状态机与校车通行逻辑
• ✅ Windows / macOS / Linux 跨平台打包支持
• ✅ 提供 Windows 一键启动脚本和独立游戏入口

首次运行前，请确保已安装 Rust 工具链和 Node.js 环境。

✨ 核心游戏特性

• 🚦 3D 十字路口场景：包含双向车道、人行横道、红绿灯模型。
• 🚌 校车通行规则：校车在绿灯时自动通过路口，红灯时强制停止；支持手动强控红绿灯切换。
• 🎮 交互式视角：通过鼠标拖拽旋转/缩放，从任意角度观察校车和路况。
• 🖥️ 跨平台桌面应用：基于 Tauri 构建，原生性能，安装包体积小。
• ⚡ 一键游玩：Windows 用户双击 启动游戏.bat 即可运行；或通过 traffic-game.html 直接打开网页版。

👥 团队成员 (Goodfamily Organization)

本项目由以下三位核心贡献者共同维护（排名不分先后）：

角色	职责	成员
Maintainer	组织管理、代码审核、测试脚本编写	Xuaya
Developer	核心功能开发、3D 场景搭建、校车控制逻辑	good123
Document Writer	文档撰写、README 维护、PR 合入	s111

🚀 快速开始 (Quick Start)

1. 环境准备

由于项目使用 Tauri 框架，请先安装必要工具：

• Rust：访问 rustup.rs 安装（项目内已提供 rustup-init.exe）。
• Node.js：建议安装 18.x 及以上版本（包含 npm）。
• 构建工具：Windows 用户需安装 Microsoft Visual Studio C++ 生成工具；macOS 用户需安装 Xcode Command Line Tools。

2. 克隆仓库

```bash git clone https://gitlink.org.cn/goodfamily/greenredled.git cd greenredled

🚀 项目结构说明

greenredled/ ├── src/ # 前端源代码 │ ├── main.js/ts # 应用入口 │ ├── App.vue/jsx # 主游戏组件（含 Three.js 场景） │ └── assets/ # 静态资源（模型、纹理、音效） ├── src-tauri/ # Tauri 后端 (Rust) │ ├── src/ │ │ └── main.rs # Rust 主函数 │ ├── Cargo.toml # Rust 依赖清单 │ └── tauri.conf.json # Tauri 配置（窗口尺寸、权限等） ├── index.html # HTML 入口 ├── traffic-game.html # 独立网页版入口（仅前端） ├── package.json # 前端依赖管理 ├── vite.config.js # Vite 构建配置 ├── rustup-init.exe # Rust 安装器（Windows） ├── 启动游戏.bat # Windows 快速启动脚本 ├── SPEC.md # 技术规范文档 └── README.md # 项目说明