# rpg-demo

**Repository Path**: Ruemo/rpg-demo

## Basic Information

- **Project Name**: rpg-demo
- **Description**: 游戏开发常见业务功能实现示例
- **Primary Language**: C#
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-31
- **Last Updated**: 2026-05-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RPG 养成系统 Demo

从旧 TypeScript RPG 项目中提取核心养成系统，逐个做成**独立可运行**的 Unity 最小 Demo，共计 **26 个模块 + 1 个进阶版红点（Demo06b）**。每个 Demo 自包含、通过事件驱动解耦、用 ScriptableObject 模拟服务端数据，可作为 Unity 游戏养成系统的参考项目。

## 技术栈

- **Unity 2022.3.61f1c1** + **C#**（Mono，.NET Standard 2.1）
- **TextMesh Pro** — 文本渲染
- **DOTween** — 动画补间
- **Newtonsoft.Json** — JSON 数据解析
- **ScriptableObject** — 配置数据承载

## 核心架构

- 每个模块通过**事件总线**对外通信，UI 只监听事件刷新
- Demo 之间**互相独立**，需要的外部系统用简化版内嵌
- `BaseModule<T>` 泛型单例 + `BasePanel` 面板基类 + `GameApp` 场景入口，统一开发模式
- 轻量框架 **LitFW**：事件系统、定时器、状态机、日志工具
- 每个 Demo 对应一份保姆级手动搭建文档（`Other/开发计划-手动部分/`）

## Demo 一览

### 基础资源类

| Demo | 模块 | 核心功能 |
|------|------|---------|
| Demo01 | PlayerModule | 经验累积、连升多级、等级上限 |
| Demo02 | MoneyModule | 多币种增减、消费验证、溢出自动转换 |
| Demo03 | AutoValueModule | 离线恢复计算、阶梯购买、每日限购、上限扩展 |

![Demo01](MarkdownAssets/demo01.gif)

![Demo02](MarkdownAssets/demo02.gif)

![Demo03](MarkdownAssets/demo03.gif)

### 进度追踪类

| Demo | 模块 | 核心功能 |
|------|------|---------|
| Demo04 | TaskModule | 事件驱动进度更新、三态状态机流转 |
| Demo05 | SignInModule | 位掩码记录、累加天数、周期奖励 |
| Demo06 | RedPointSystem | 观察者模式、聚合逻辑（OR/AND）、父子红点树 |
| Demo06b | RedPointSystem | 红点进阶版 |

![Demo04](MarkdownAssets/demo04.gif)

![Demo05](MarkdownAssets/demo05.gif)

![Demo06](MarkdownAssets/demo06.gif)

### 养成内容类

| Demo | 模块 | 核心功能 |
|------|------|---------|
| Demo07 | EquipModule | 装备创建（基础+随机属性）、穿戴替换、强化升级 |
| Demo08 | SkillModule | 条件解锁、等级参数化描述、被动属性加成 |
| Demo09 | TroopModule | 槽位管理、上阵/下阵、同英雄去重、编队战力 |

![Demo07](MarkdownAssets/demo07.gif)

![Demo08](MarkdownAssets/demo08.gif)

![Demo09](MarkdownAssets/demo09.gif)

### 综合系统类

| Demo | 模块 | 核心功能 |
|------|------|---------|
| Demo10 | ShopModule | 商品购买、库存扣减、定时刷新、阶梯限购 |
| Demo11 | AdventureModule | 线性关卡推进、战力碾压自动通关、体力消耗 |
| Demo12 | DuoBaoModule | 概率池、双层保底（小保底/大保底）、累计里程碑奖励 |
| Demo13 | CombatPassModule | Phase+Lv 二维进度、免费/付费双轨奖励、周期重置 |
| Demo14 | BagModule | 道具存取、背包容量管理、道具使用 |
| Demo15 | MailModule | 邮件列表、附件领取、已读/未读状态 |
| Demo16 | ArenaModule | 排名挑战、奖励结算、对手刷新 |
| Demo17 | TutorialModule | 引导步骤管理、条件触发、完成状态记录 |
| Demo18 | TowerModule | 层级推进、波次挑战、扫荡功能 |
| Demo19 | TreasureModule | 宝物收集、属性加成、神器激活 |
| Demo20 | SourceModule | 道具产出途径展示、一键跳转 |
| Demo21 | GuaJiModule | 离线时长计算收益、挂机上限、领取奖励 |
| Demo22 | HandBookModule | 图鉴解锁进度、收集奖励 |
| Demo23 | XiLianModule | 属性洗炼、锁定词条、洗炼材料消耗 |
| Demo24 | HuoDongModule | 活动周期管理、任务进度、活动奖励 |

![Demo10](MarkdownAssets/demo10.gif)

![Demo11](MarkdownAssets/demo11.gif)

![Demo12](MarkdownAssets/demo12.gif)

![Demo13](MarkdownAssets/demo13.gif)

![Demo14](MarkdownAssets/demo14.gif)

![Demo15](MarkdownAssets/demo15.gif)

![Demo16](MarkdownAssets/demo16.gif)

![Demo17](MarkdownAssets/demo17.gif)

![Demo18](MarkdownAssets/demo18.gif)

![Demo19](MarkdownAssets/demo19.gif)

![Demo20](MarkdownAssets/demo20.gif)

![Demo21](MarkdownAssets/demo21.gif)

![Demo22](MarkdownAssets/demo22.gif)

![Demo23](MarkdownAssets/demo23.gif)

### 工具/框架类

| Demo | 模块 | 核心功能 |
|------|------|---------|
| Demo25 | ConfigDrivenModule | 配置驱动、条件系统、表达式引擎、属性注册 |
| Demo26 | AttrPipelineModule | 属性流水线计算 |

![Demo25](MarkdownAssets/demo25.gif)