# CubeCity 新手游玩指南 🏙️

欢迎来到 CubeCity！这是一款轻松有趣的2.5D卡通城市模拟经营游戏。你将在这里规划土地、建造各类建筑、管理资源，让你的城市不断成长、繁荣。
本指南将带你快速上手，成为一名合格的城市市长！

---

## 1. 游戏简介 🎮

CubeCity 是一款以城市建设为核心的模拟经营游戏。你将从一块空地起步，逐步建造住宅、商业、工业、环境等多种建筑，合理布局道路，管理金币与人口，打造属于你的理想城市。

**核心特色：**
- 🏗️ 3D 城市建设与资源管理
- 🏠 RCI & ESG 多维建筑体系
- 💾 本地存储、响应式 UI
- 🎨 丰富的扩展与自定义空间

---

## 2. 快速开始 🚀

1. 打开游戏，点击"开始新城市"
2. 你将获得一块16x16格的空地和初始金币 💰
3. 通过左侧建筑面板选择建筑类型，点击地图上的地皮进行放置
4. 观察城市发展，合理扩展地皮、升级建筑，体验城市成长的乐趣！

---

## 3. 基础操作 🎯

### 3.1 建筑操作
- **选择建筑** 🏗️：左侧面板点击建筑卡片，查看建筑信息与建造消耗
- **放置建筑** 📍：选择后，点击地图上的空地即可建造（需消耗金币）
- **移动建筑** 🚧：切换到"搬迁"模式，点击目标建筑，再选择新位置放下
- **升级建筑** ⬆️：选中建筑后，若满足条件可点击"升级"按钮，提升产能与容量
- **拆除建筑** 💥：切换到"拆除"模式，点击建筑，确认后可回收部分金币
- **查看详情** 🔍：点击任意建筑或地皮，右侧会显示详细信息，包括人口、产出、状态等

### 3.2 快捷键操作 ⌨️
- **R键** 🔄：在建造或搬迁模式下旋转建筑方向
- **ESC键** ❌：取消当前选择或操作
- **鼠标右键** 🖱️：取消选择，返回默认状态
- **鼠标滚轮** 📏：缩放视角
- **鼠标拖拽** 🖱️：旋转视角

### 3.3 模式切换 🔄
游戏提供四种操作模式，可通过左侧面板切换：

| 模式 | 图标 | 功能 | 快捷键 |
|------|------|------|--------|
| **选择** | 🔍 | 查看建筑信息、升级建筑 | - |
| **建造** | 🏗️ | 放置新建筑 | R 旋转，ESC 取消 |
| **搬迁** | 🚧 | 移动现有建筑 | R 旋转，ESC 取消 |
| **拆除** | 💥 | 删除建筑 | ESC 取消 |

---

## 4. 建筑系统详解 🏢

### 4.1 建筑分类

#### 住宅类建筑 🏠
- **🏠 住宅**：基础住宅，提供人口容量
- **🏡 民宅**：高级住宅，提供更多人口容量

#### 商业类建筑 🏬
- **🏬 商店**：基础商业，产出金币
- **🏢 办公室**：高级商业，产出更多金币

#### 工业类建筑 🏭
- **🏭 工厂**：基础工业，提供就业和产出
- **🧪 化学工厂**：高级工业，高产出但高污染
- **☢️ 核电站**：发电设施，提供大量电力

#### 环境类建筑 🌳
- **🌳 公园**：提升环境质量，降低污染
- **🗑️ 垃圾站**：处理垃圾，减少污染
- **☀️ 太阳能电板**：清洁发电
- **🌬️ 风力发电塔**：清洁发电
- **🚰 水塔**：提供水资源

#### 社会设施 🏥
- **🗽 英雄纪念碑**：提升城市文化
- **🏥 医院**：提供医疗服务
- **👮 警察局**：维护治安
- **🚒 消防站**：提供消防服务

#### 基础设施 🛣️
- **🛣️ 道路**：连接建筑，确保正常运作

### 4.2 建筑相互作用系统 ⚡

建筑之间会产生相互影响，合理布局能获得额外加成：

#### 住宅建筑相互作用 🏠
- **🏠 住宅 + 🌳 公园**：每个相邻公园增加10%人口容量，居民满意度提升 😊
- **🏠 住宅 + 🏭 工厂**：相邻工厂减少15%人口容量，居民满意度下降 😢
- **🏠 住宅 + 🧪 化学工厂**：相邻化学工厂减少15%人口容量，居民满意度下降 😢

#### 商业建筑相互作用 🏬
- **🏬 商店 + 🌳 公园**：每个相邻公园增加10%收入，顾客满意度提升 😊
- **🏢 办公室 + 🌳 公园**：每个相邻公园增加12%收入，办公效率提升 😊
- **🏬 商店 + 🚰 水塔**：相邻水塔增加25%收入 💰

#### 工业建筑相互作用 🏭
- **🏭 工厂 + 🌳 公园**：每个相邻公园减少25%污染，环境友好 🌱
- **🏭 工厂 + 🧪 化学工厂**：相邻化学工厂减少25%污染，工业协同效应
- **🏭 工厂 + 🚰 水塔**：相邻水塔增加25%收入 💰
- **🧪 化学工厂 + 🏭 工厂**：相邻工厂增加20%收入，工业集群效应
- **🧪 化学工厂 + 🗑️ 垃圾站**：垃圾站减少30%污染，处理工业废料
- **🧪 化学工厂 + 🌳 公园**：公园减少15%污染，清洁环境提升生产效率

#### 发电设施相互作用 ⚡
- **☀️ 太阳能 + 🏠 住宅**：每个相邻住宅增加5%发电效率
- **☀️ 太阳能 + 🌬️ 风力**：相邻发电设施相互提升5%效率
- **🌬️ 风力 + 🌳 公园**：开阔环境增加8%发电效率

#### 环境设施相互作用 🌱
- **🌳 公园 + 🏠 住宅**：为住宅提供人口加成
- **🌳 公园 + 🏬 商业**：为商业提供收入加成
- **🌳 公园 + 🏭 工业**：为工业减少污染
- **🗑️ 垃圾站 + 🏭 工厂**：为工厂提供污染处理
- **🗑️ 垃圾站 + 🧪 化学工厂**：为化学工厂提供污染处理

### 4.3 建筑状态指示器 📊

建筑顶部会出现各种状态图标，及时处理可避免损失：

| 状态图标 | 含义 | 解决方案 |
|----------|------|----------|
| ⬆️ | 可升级 | 点击升级按钮提升建筑等级 |
| ⚡ | 电力不足 | 建造更多发电设施 |
| 👥 | 人口超负荷 | 建造更多住宅或减少就业岗位 |
| 🛣️ | 缺少道路连接 | 建造道路连接建筑 |
| 🌫️ | 污染过高 | 建造公园或垃圾站 |
| 🌟 | 提供增益效果 | 建筑正在为相邻建筑提供加成 |
| 😊 | 居民满意 | 环境良好，居民幸福 |
| 😢 | 居民不满 | 改善环境，减少污染 |

---

## 5. 资源管理系统 💰

### 5.1 主要资源

- **💰 金币**：主要通过商业、工业建筑自动产出，用于建造、升级、扩地
- **👥 人口**：由住宅容量决定，实际人口受就业岗位和满意度影响
- **⚡ 电力**：部分建筑消耗电力，需建造发电厂等设施保障供电
- **🌫️ 污染**：工业、发电等建筑会产生污染，环境类建筑可降低污染值
- **😊 满意度**：受人口利用率、环境、服务设施等影响，过低会导致人口流失和产出下降

### 5.2 资源平衡策略 ⚖️

- **人口平衡**：确保住宅容量与就业岗位匹配
- **电力平衡**：发电量要大于总耗电量
- **污染控制**：通过公园、垃圾站等设施降低污染
- **满意度维护**：通过环境设施和服务设施提升居民满意度

---

## 6. 界面说明 🖥️

- **左侧面板** 📋：建筑选择、模式切换、金币与资源显示
- **主画布** 🎨：3D 城市地图，支持鼠标拖拽旋转、缩放视角
- **右侧面板** 📊：显示选中建筑/地皮的详细信息、升级/拆除等操作按钮
- **底部栏** 📈：城市名称、当前天数、扩地按钮、排行榜入口等

---

## 7. 进阶技巧 🎯

### 7.1 布局策略 🏗️
- **🏠 住宅靠近 🌳 公园**：提升居民满意度和人口容量
- **🏭 工业远离 🏠 住宅**：减少污染对居民的影响
- **🏬 商业靠近 🌳 公园**：提升商业收入
- **🏭 工业靠近 🗑️ 垃圾站**：减少工业污染
- **⚡ 发电设施靠近 🏠 住宅**：提升发电效率

### 7.2 资源优化 💡
- **优先升级高产出建筑**：如化学工厂、购物中心等
- **关注状态提示**：及时处理电力不足、污染过高等问题
- **合理规划道路**：确保所有建筑都有道路连接
- **平衡发展**：避免单一类型建筑过多

### 7.3 经济策略 💰
- **早期发展**：优先建造住宅和基础商业
- **中期扩张**：增加工业产出，提升经济实力
- **后期优化**：完善环境设施，提升城市品质

---

## 8. 建筑一览表 🏢

| 图标 | 名称         | 分类         | 主要功能           | 产出/消耗         | 备注           |
|------|--------------|--------------|--------------------|-------------------|----------------|
| 🏠   | 住宅         | 住宅         | 提供人口容量       | 👥/⚡/🌫️           | 可升级         |
| 🏡   | 民宅         | 住宅         | 提供更多人口容量   | 👥/⚡/🌫️           | 可升级         |
| 🏬   | 商店         | 商业         | 产出金币           | 💰/⚡/🌫️/👥         | 可升级         |
| 🏢   | 办公室       | 商业         | 产出更多金币       | 💰/⚡/🌫️/👥         | 可升级         |
| 🏭   | 工厂         | 工业         | 提供就业/产出      | 💰/⚡/🌫️/👥         |                |
| 🧪   | 化学工厂     | 工业         | 高产出高污染       | 💰/⚡/🌫️/👥         | 可升级         |
| ☢️   | 核电站       | 工业         | 大量发电           | ⚡/🌫️/👥            |                |
| 🌳   | 公园         | 环境         | 降低污染/提升满意度| 🌫️/⚡              | 可升级         |
| 🗑️   | 垃圾站       | 环境         | 减少污染           | 🌫️/⚡/👥            |                |
| ☀️   | 太阳能电板   | 环境         | 清洁发电           | ⚡/🌫️/👥            |                |
| 🌬️   | 风力发电塔   | 环境         | 清洁发电           | ⚡/🌫️/👥            |                |
| 🚰   | 水塔         | 环境         | 提供水资源         | 👥/⚡               |                |
| 🗽   | 英雄纪念碑   | 社会         | 提升文化           | ⚡/🌫️               |                |
| 🏥   | 医院         | 社会         | 提供医疗服务       | 👥/⚡               |                |
| 👮   | 警察局       | 治理         | 维护治安           | 👥/⚡               |                |
| 🚒   | 消防站       | 治理         | 提供消防服务       | 👥/⚡               |                |
| 🛣️   | 道路         | 基础设施     | 连接建筑           | -                  | 必须连接       |

---

## 9. 建筑相互作用速查表 🔄

| 主体建筑 | 相互作用对象 | 距离 | 效果描述                     | 影响属性   |
|----------|--------------|------|------------------------------|------------|
| 🏠/🏡     | 🌳/🗽         | 1    | 每个相邻公园/纪念碑+10%人口  | maxPopulation |
| 🏠/🏡     | 🏭/🧪         | 1    | 每个相邻工厂/化工厂-15%人口  | maxPopulation |
| 🏬/🏢     | 🌳/🗽         | 1    | 每个相邻公园/纪念碑+10~12%收入| coinOutput   |
| 🏬       | 🚰           | 1    | 相邻水塔+25%收入             | coinOutput   |
| 🏭       | 🌳/🗽/☀️/🌬️   | 1    | 每个相邻绿化-25%污染         | pollution    |
| 🏭       | 🧪           | 1    | 相邻化工厂-25%污染           | pollution    |
| 🏭       | 🚰           | 1    | 相邻水塔+25%收入             | coinOutput   |
| 🧪       | 🏭           | 3    | 3格内有工厂+20%收入          | coinOutput   |
| 🧪       | 🗑️           | 2/3  | 2~3格内有垃圾站-30%污染      | pollution    |
| ☀️       | 🏠/🏡         | 1    | 每个相邻住宅+5%发电效率      | powerOutput  |
| ☀️/🌬️    | ☀️/🌬️        | 1    | 相邻发电设施+5%发电效率      | powerOutput  |
| 🌬️       | 🌳/🗽         | 1    | 相邻公园/纪念碑+8%发电效率   | powerOutput  |
| 🌳/🗽     | 🏠/🏡         | 1    | 相邻住宅获得人口加成         | maxPopulation|
| 🌳/🗽     | 🏬/🏢         | 1    | 相邻商业获得收入加成         | coinOutput   |
| 🌳/🗽     | 🏭/🧪         | 1    | 相邻工业获得污染降低         | pollution    |
| 🗑️       | 🏭/🧪         | 2/3  | 2~3格内工业获得污染降低      | pollution    |

---

## 10. 常见问题解答 ❓

**Q1：💰 金币不够怎么办？**
A：优先建造和升级商业、工业类建筑，提升金币产出。合理拆除低效建筑，回收部分资金。

**Q2：👥 人口增长缓慢？**
A：增加住宅容量，提升满意度，建造更多就业岗位（商业/工业）。

**Q3：🌫️ 城市污染太高？**
A：多建公园 🌳、垃圾站 🗑️ 等环境类建筑，远离住宅区布置工业。

**Q4：🏗️ 建筑无法放置？**
A：请确保目标地皮为空且与道路 🛣️ 相连，且金币充足。

**Q5：⚡ 电力不足？**
A：建造更多发电设施（☀️ 太阳能、🌬️ 风力、☢️ 核电站）。

**Q6：🔍 如何查看排行榜？**
A：点击底部栏的"排行榜"按钮，查看本地或全球玩家排名。

**Q7：🔄 如何旋转建筑？**
A：在建造或搬迁模式下，按 R 键旋转建筑方向。

**Q8：❌ 如何取消操作？**
A：按 ESC 键或鼠标右键取消当前选择。

---

## 11. 游戏小贴士 💡

- **🏗️ 合理布局**：住宅靠近公园、医院可提升满意度，工业远离住宅可减少污染
- **💰 资源平衡**：保持人口、就业、金币、满意度、电力等多项资源的平衡，避免瓶颈
- **⬆️ 升级优先级**：优先升级产出高、影响大的建筑，提升城市整体效率
- **📊 关注状态提示**：建筑顶部会出现各种状态图标，及时处理可避免损失
- **💾 自动保存**：游戏自动保存，无需担心丢失进度
- **🎮 享受过程**：城市建设是一个渐进的过程，享受每一步的成长
- **🌟 利用相互作用**：合理布局建筑，最大化资源产出与城市效率

---

## 12. 联系与反馈 📞

如有建议、BUG 反馈或想法，欢迎在项目 issues 区留言，或加入官方交流群与开发者互动！

---

祝你在 CubeCity 建设出独一无二的繁荣城市，享受模拟经营的乐趣！🎉
