# 夕照镇

**Repository Path**: rtccn_mc/sunset-town

## Basic Information

- **Project Name**: 夕照镇
- **Description**: 夕照镇游戏仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-22
- **Last Updated**: 2026-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 夕照镇 · Sunset Town

一个基于参数驱动事件引擎的 **2.5D 生活模拟沙盒**：没有赢面，只有不断演化的小镇与一命接一命的人生。玩家扮演小镇居民，在小镇里走动、点击物体、做出选择；事件由众多参数（经济、声望、季节、天气、时间、关系、年龄、健康）持续演化生成，非线性、可连锁。角色会老去、可能随机死亡；死后可选新身份，重入同一个继续前行的小镇。

## 素材仓库与索引（Code AI 必读）

> 全部素材随本仓库分发，**克隆仓库即获得全部美术 / 文本 / 数据**，无需另行下载。

- **仓库地址**：`https://gitee.com/rtccn_mc/sunset-town.git`（直接 `git clone` 即可）
- **美术素材**：`assets/img/`（瓦片 `tiles/` / 建筑 `buildings/` / 物件 `objects/` / UI `ui/` / 角色立绘 `chars_portraits/`，共 516 张 PNG）
- **素材索引**：`assets/img/manifest.json`（运行时加载清单）＋ `assets/ASSETS_图鉴.json`（416 条识别）
- **素材清单 CSV**：`assets/ASSETS_清单.csv`、`assets/ASSETS_清单_新增.csv`
- **文本素材**：`assets/data/`（`dialogues.json` 对白 / `events.json` 事件 / `items.json` 物品 / `buildings.json` 建筑 / `achievements.json` 成就 / `map.json` 地图 / `chars_mapping.json` 角色映射）
- **角色立绘登记**：`assets/img/ASSETS_角色立绘.json`（40 张，真实 CC-BY 3.0 像素素材）
- **数据统计报告**：`reports/data-stats/town-data-stats.html`（全维度盘点 + 图表）
- **人工盘查规范**：`README`、`docs/ASSETS.md`（外部 CC0 素材来源）、`scripts/assess_assets.md`

**快速定位**：美术走 `assets/img/` + `manifest.json`；对白/事件走 `assets/data/`；成品盘点看 `reports/data-stats/`。

## 技术栈

- **引擎**：Godot 4（GDScript 全栈），`TileMapLayer` 原生等角瓦片
- **数据**：JSON（事件池 / 地图 / NPC）
- **打包**：Godot Android 导出模板 + SDK，云端构建 APK

## 文档

全部设计文档在 [`docs/`](docs/README.md)：架构（ARCHITECTURE）、设计规范（DESIGN）、视觉硬锁规格（VISUAL_SPEC）、素材来源（ASSETS）、事件引擎（EVENTS）、需求（PRD）、端到端游玩示例（WALKTHROUGH）、实现交接单（SPEC）、界面对白层与经 UI 设计（UI_DESIGN）、可复用设计系统（DESIGN_SYSTEM）。

## 界面原型

在 `designs/sunset-town-ui/`：事件面板 3 套方案（A 叙事 / B 工具感 / C 沉浸）+ **完整界面家族**（D 主菜单 / E 对话 / F 背包 / G 商店 / H 存档 / I 设置 / J 地图 / K 日志 / L 社交），全部遵循 `docs/DESIGN_SYSTEM.md`（半透明灰黑 · 无黄 · 真像素 · 像素字体 · 磨损感），并有可复用组件模板库 `templates/`。本地服务器预览总览页 `index.html`。