# 星落原野行

**Repository Path**: FullStackPeng/starry-wilderness-journey

## Basic Information

- **Project Name**: 星落原野行
- **Description**: 《星落原野行》聚焦“开放世界探索”核心体验，玩家可在无缝衔接的 3D 原野场景中自由移动、交互、发现隐藏线索与场景彩蛋，沉浸式感受旷野探索的乐趣。 项目基于前端技术栈实现轻量化 3D 游戏体验，无需安装客户端，通过浏览器即可畅玩。
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-11
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 星落原野行

✨ 一款以「自由探索广袤世界」为核心的 3D 探索类游戏，在星落的原野上，解锁未知的风景与秘密 ✨

## 项目介绍
《星落原野行》聚焦“开放世界探索”核心体验，玩家可在无缝衔接的 3D 原野场景中自由移动、交互、发现隐藏线索与场景彩蛋，沉浸式感受旷野探索的乐趣。
项目基于前端技术栈实现轻量化 3D 游戏体验，无需安装客户端，通过浏览器即可畅玩。

## 核心技术栈
| 技术/框架       | 作用说明                     |
|----------------|----------------------------|
| Vue 3          | 游戏前端界面与交互逻辑核心框架（组合式 API） |
| Three.js       | 3D 场景渲染核心，实现原野地形、模型、光影效果 |
| cannon-es      | 轻量级物理引擎，处理角色移动、碰撞检测、重力等物理规则 |

## 快速开始
### 环境要求
- Node.js >= 16.0.0
- npm/yarn/pnpm（推荐 pnpm）

### 安装与运行
```bash
# 克隆仓库
git clone https://gitee.com/你的用户名/starfall-wilderness.git

# 进入项目目录
cd starfall-wilderness

# 安装依赖
pnpm install

# 本地开发运行
pnpm dev

# 打包构建
pnpm build