# cocos-player

**Repository Path**: android.long/cocos-player

## Basic Information

- **Project Name**: cocos-player
- **Description**: cocos 游戏开发 入门教程中 中的 小赛车3D游戏
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cocos 游戏开发入门教程


bilibili 的 cocos creator 3.8.8游戏开发新手入门 2026年新版教程 

https://space.bilibili.com/513480210/lists/8216744?type=season 

## 项目介绍

这是一个基于 `Cocos Creator 3.8.8` 与 `TypeScript` 开发的 3D 休闲跑酷小游戏示例。玩家控制小车在赛道中持续前进，通过左右移动收集金币、躲避障碍，并在到达终点后完成挑战。

项目包含基础的角色移动、碰撞检测、分数统计、距离计算、音效播放、背景音乐以及胜利/失败提示等功能，适合作为 Cocos Creator 入门练习、课堂作业或小游戏原型项目参考。

## 核心玩法

- 小车会自动向前移动
- 通过键盘 `A` / `D` 控制左右移动
- 收集金币可以增加分数
- 撞到障碍物则挑战失败
- 到达终点后显示胜利结果
- 游戏结束后可重新加载场景开始新一轮

## 功能说明

- 使用 `Collider` 处理金币、障碍物和终点触发逻辑
- 使用 `Label` 实时显示分数与行进距离
- 使用 `AudioSource` 播放金币、胜利、失败和背景音乐
- 主相机会跟随小车同步前进
- 金币带有上下浮动效果，增强场景表现

## 项目结构

```text
assets/
  fbx/                3D 模型资源
  images/             UI 图片资源
  material/           材质资源
  resources/audio/    音频资源
  scene/              游戏场景
  ts/                 核心脚本
    player.ts         玩家控制、碰撞、UI、音频逻辑
    coin.ts           金币浮动动画逻辑
```

## 运行方式

1. 使用 `Cocos Creator 3.8.8` 打开项目目录
2. 打开场景 `assets/scene/scene.scene`
3. 在编辑器中预览或构建运行

## 适用场景

该项目适合用于：

- Cocos Creator 3.x 学习与实践
- TypeScript 游戏脚本开发示例
- 简单 3D 跑酷玩法原型搭建
- 基础碰撞与音频系统练习