# cube_space

**Repository Path**: silwings/cube_space

## Basic Information

- **Project Name**: cube_space
- **Description**: 一款经典方块消除益智游戏，玩家通过移动、旋转下落的方块来填满整行并消除得分。游戏包含多种模式、124 个精心设计的关卡、自定义关卡编辑器，以及多风格音效系统。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-20
- **Last Updated**: 2026-02-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 方寸间 (CubeSpace)

[English](./README_EN.md)

一款基于 Kotlin + Jetpack Compose 开发的 Android 益智游戏。

## 游戏简介

方寸间是一款经典方块消除益智游戏，玩家通过移动、旋转下落的方块来填满整行并消除得分。游戏包含多种模式、124 个精心设计的关卡、自定义关卡编辑器，以及多风格音效系统。

## 游戏模式

### 普通模式

无尽玩法，方块持续下落，难度随等级逐步提升（下落速度加快）。每消除 10 行升一级，挑战你的最高分。支持 5 个存档槽位，随时保存和继续。

### 关卡模式

124 个预设关卡，每关有不同的初始方块布局，目标是清除所有预填方块。评分基于效率——使用的方块越少，得分越高。

### 自定义关卡

通过可视化网格编辑器创建自己的关卡，支持：
- 自由绘制初始方块布局
- 保存、编辑和删除自定义关卡
- 通过压缩编码分享关卡给其他玩家

## 游戏特性

### 操作方式

- 按钮控制：左移、右移、旋转、软降、硬降，共 5 个操作按钮
- 滑动手势：在游戏画布上左右滑动移动方块，上滑旋转，下滑硬降
- 软降：按住软降按钮加速下落（50ms 间隔），松开恢复正常速度
- 硬降：方块瞬间落到底部
- 长按连发：方向键和旋转键支持长按自动连发（200ms 起始延迟，80ms 重复间隔）
- 幽灵方块：半透明预览显示方块落点位置

### 计分系统

- 消行得分：1 行 100 分、2 行 300 分、3 行 500 分、4 行 800 分
- 连锁倍率：每层连锁 1.5 倍加成
- 等级倍率：得分乘以当前等级
- 硬降加分：每下落一行 +2 分；软降每行 +1 分
- 关卡模式：基础 10000 分，每使用一个方块扣 200 分，最低 500 分

### 连锁系统

消行后悬空方块会自动下落，触发连锁反应。多级连锁带有深度追踪，连锁越深粒子效果越强烈。

### 音效系统

4 种 BGM 风格：
- 8-bit 复古风
- 吉卜力风
- 新年风（恭喜发财）
- 本地音乐文件

3 种音效风格：
- 8-bit 复古
- 吉卜力
- 新年（放鞭炮）

所有音效通过 AudioTrack 实时合成，无需音频资源文件。BGM 和音效可独立开关，切换风格时自动配对。

### 视觉效果

- 消行粒子动画：每格 3 个粒子，6 种颜色，带物理模拟（重力、速度、透明度衰减）
- 连锁时粒子数量翻倍
- 消行闪烁动画（300ms）
- 按钮按压缩放动画
- 7 种方块各有独特配色

### 存档系统

- 5 个存档槽位，支持保存、读取、删除、覆盖
- 存档数据压缩编码（Deflate + Base64 + CRC32 校验）
- 支持导出分享和导入存档
- 剪贴板自动检测：切回应用时自动识别剪贴板中的存档或关卡数据

### 自定义关卡

- 可视化网格编辑器，触摸绘制方块布局
- 7 色调色板 + 橡皮擦
- 关卡命名、编辑、复制、重命名、删除
- 发布机制：标记关卡为已发布，记录最高分
- 压缩编码导出分享，支持导入其他玩家的关卡

## 技术实现

- 语言：Kotlin
- UI 框架：Jetpack Compose
- 架构：MVVM（GameViewModel + GameEngine）
- 状态管理：StateFlow + collectAsState
- 方块生成：7-bag 随机算法
- 旋转系统：SRS 旋转 + Wall Kick（偏移尝试：0, -1, 1, -2, 2）
- 数据持久化：SharedPreferences（存档、高分、设置、自定义关卡）
- 音频合成：AudioTrack 实时波形生成
- 协程：Kotlin Coroutines 处理游戏循环和异步操作

### 游戏参数

| 参数 | 值 |
|------|-----|
| 网格尺寸 | 15 × 21 |
| 方块类型 | I、O、T、L、S、Z、J（7 种） |
| 预览方块数 | 4 |
| 初始下落间隔 | 800ms |
| 最快下落间隔 | 100ms |
| 每级加速 | 70ms |
| 升级所需行数 | 10 行 |
| 预设关卡数 | 124 |
| 存档槽位 | 5 |