# 🎮 英雄天赋系统 (Talent System) ## 📌 项目概述 这是一个为游戏英雄系统设计的**功能完整、高度可扩展的天赋配置系统**。系统支持四种不同类型的天赋效果定义，每种类型都有清晰的触发条件和效果机制，可以轻松创建复杂而有趣的英雄特性。 --- ## 📦 项目结构 ``` assets/script/game/common/config/ ├── TalSet.ts # ⭐ 核心配置文件 (435行) ├── TalSet_Example.ts # 💡 集成示例 (424行) ├── TalSet_USAGE.md # 📖 详细文档 (400+行) ├── TalSet_QuickRef.md # ⚡ 快速参考 (350+行) └── TalSet_README.md # 📋 本文件 - 总体说明 ``` --- ## ✨ 核心功能 ### 1️⃣ 等级类天赋 (LEVEL_ATTR) 当英雄升到指定等级时触发效果 - **示例**: 每升5级，攻击力增加10% - **ID范围**: 7001-7099 - **特点**: 里程碑式的属性增长 ### 2️⃣ 行为计数类天赋 (ACTION_COUNT_ATTR) 当特定行为累计达到次数时触发 - **示例**: 每攻击10次，闪避率增加1% - **ID范围**: 7101-7199 - **支持行为**: 攻击、技能释放、受到伤害 - **特点**: 可选择按等级重置或持续累积 ### 3️⃣ 受伤计数类天赋 (DAMAGE_COUNT_ATTR) 当英雄累计受伤达到次数时触发 - **示例**: 每受伤10次，最大生命值增加100 - **ID范围**: 7201-7299 - **特点**: 坦克英雄的成长机制 ### 4️⃣ 技能触发类天赋 (ACTION_TRIGGER_SKILL) 满足条件时自动释放指定技能 - **示例**: 每攻击15次，自动释放反击技能 - **ID范围**: 7301-7399 - **特点**: 创建链式反应和特殊战斗机制 --- ## 🚀 快速开始 (5分钟) ### 第一步：初始化英雄天赋 ```typescript import { initHeroTalents } from "./TalSet_Example"; // 为英雄 ID=5001 (刘邦) 初始化天赋 initHeroTalents(5001, [7001, 7202]); // 7001: 剑意提升 (等级类) // 7202: 防御强化 (受伤类) ``` ### 第二步：监听游戏事件 ```typescript import { onHeroLevelUp, onHeroAttack, onHeroDamaged, onHeroSkillCast } from "./TalSet_Example"; // 在英雄升级系统中调用 onHeroLevelUp(5001, 10); // 英雄升到10级 // 在战斗系统中调用 onHeroAttack(5001, 50); // 英雄发动攻击 onHeroSkillCast(5001, 6001); // 英雄释放技能 onHeroDamaged(5001, 30); // 英雄受到伤害 ``` ### 第三步：查询天赋信息 ```typescript import { getTalConf } from "./TalSet"; // 获取单个天赋配置 const talConfig = getTalConf(7001); console.log(talConfig.name); // "剑意提升" // 获取英雄的天赋状态 const talentInfo = globalTalentManager.getHeroTalentInfo(5001); talentInfo?.talents.forEach((instance, talId) => { console.log(`天赋${talId}: 堆叠${instance.stackCount}层`); }); ``` --- ## 📚 文档导航 | 文档 | 内容 | 何时阅读 | |------|------|--------| | **TalSet.ts** | 核心代码，类型定义和配置表 | 需要了解数据结构 | | **TalSet_USAGE.md** | 详细说明，四种天赋类型详解 | 深入学习天赋系统 | | **TalSet_QuickRef.md** | 速查表，代码片段和模板 | 快速查阅和参考 | | **TalSet_Example.ts** | 完整实现，天赋触发器和查询工具 | 了解系统实现细节 | | **TalSet_README.md** | 本文件，项目总体说明 | 第一次使用 | ### 推荐阅读顺序 1. 📋 **本文件** (10分钟) - 了解项目整体 2. ⚡ **TalSet_QuickRef.md** (10分钟) - 快速上手 3. 📖 **TalSet_USAGE.md** (20分钟) - 深入理解 4. 💡 **TalSet_Example.ts** (查需) - 参考实现 --- ## 🎯 预置天赋示例 ### 等级类天赋 | ID | 名称 | 效果 | 触发 | |---|------|------|-----| | 7001 | 剑意提升 | 攻击力 +10% | 每5级 | | 7002 | 法力修炼 | 魔力 +15 | 每3级 | ### 行为计数类天赋 | ID | 名称 | 效果 | 触发 | |---|------|------|-----| | 7101 | 强化闪避 | 闪避率 +1% | 每10次攻击 | | 7102 | 暴击强化 | 暴击率 +2% | 每15次攻击 | | 7103 | 连击精通 | 攻击力 +5% | 每8次技能 | ### 受伤计数类天赋 | ID | 名称 | 效果 | 触发 | |---|------|------|-----| | 7201 | 坚甲护体 | 生命 +100 | 每10次受伤 | | 7202 | 防御强化 | 防御 +3% | 每12次受伤 | | 7203 | 魔抗修炼 | 魔防 +5 | 每15次受伤 | ### 技能触发类天赋 | ID | 名称 | 效果 | 触发 | |---|------|------|-----| | 7301 | 连击反击 | 释放技能6010 | 每15次攻击 | | 7302 | 受伤反制 | 释放技能6011 | 每8次受伤 | | 7303 | 技能链接 | 释放技能6012 | 每5次技能 | --- ## 🔧 如何添加新天赋 ### 方案：添加 "越战越强" 战士天赋 **步骤 1**：确定天赋类型 - 受伤时变强 → 使用 **DAMAGE_COUNT_ATTR** **步骤 2**：分配天赋ID - 下一个受伤类 ID → **7204** **步骤 3**：在 `TalSet.ts` 中添加配置 ```typescript // 在 talConf 对象中添加： 7204: { talId: 7204, name: "越战越强", desc: "每受伤8次，攻击力增加4%", talType: TalType.DAMAGE_COUNT_ATTR, trigger: { type: "damageCount", count: 8, resetPerLevel: false, } as IDamageCountTrigger, effect: { type: "attrModify", attr: TalAttrType.AP, value: 4, percent: true, } as IAttrModifyEffect, stackable: true, maxStack: 18, }, ``` **步骤 4**：使用新天赋 ```typescript initHeroTalents(5001, [7204]); // 为英雄添加新天赋 ``` --- ## 🎮 与英雄系统集成 ### 在 heroSet.ts 中添加天赋字段 ```typescript // 修改 heroInfo 接口 export interface heroInfo { uuid: number; name: string; // ... 其他属性 ... talents?: number[]; // 新增：天赋ID数组 } // 为具体英雄添加天赋 5001: { uuid: 5001, name: "刘邦", // ... 其他属性 ... talents: [7001, 7202], // 刘邦的天赋 } ``` ### 在战斗系统中触发天赋 ```typescript // 在战斗逻辑中适当位置调用： // 1. 英雄升级时 hero.onLevelUp((newLevel) => { onHeroLevelUp(hero.id, newLevel); }); // 2. 英雄攻击时 hero.onAttack((damage) => { onHeroAttack(hero.id, damage); }); // 3. 英雄受伤时 hero.onDamaged((damage) => { onHeroDamaged(hero.id, damage); }); // 4. 英雄释放技能时 hero.onSkillCast((skillId) => { onHeroSkillCast(hero.id, skillId); }); ``` --- ## 💡 设计原则 ### 1. 触发条件与效果分离 - **触发条件**负责"何时激发" - **效果**负责"产生什么影响" - 两者独立定义，灵活组合 ### 2. 高度扩展性 - 新增属性类型？直接加入 `TalAttrType` 枚举 - 新增行为类型？直接加入 `TalActionType` 枚举 - 新增触发条件？创建新的 `ITriggerCondition` 接口 ### 3. 类型安全 - 使用 TypeScript 接口确保配置正确 - 使用类型强制进行编译时检查 - 避免运行时类型错误 ### 4. 清晰的ID命名规范 ``` XYZZ ├─ X: 类别 (7 = 天赋) ├─ Y: 子类型 (0=等级, 1=行为, 2=受伤, 3=技能) └─ ZZ: 序列号 (01-99) 示例： 7001 → 7(天赋) 0(等级) 01(第1个) 7102 → 7(天赋) 1(行为) 02(第2个) ``` --- ## 📊 关键数据结构 ### 天赋配置接口 ```typescript interface ItalConf { talId: number; // 天赋ID name: string; // 天赋名称 desc: string; // 天赋描述 talType: TalType; // 天赋类型 trigger: ITriggerCondition; // 触发条件 effect: ITalEffect; // 效果 stackable?: boolean; // 是否可堆叠 maxStack?: number; // 最大堆叠次数 } ``` ### 天赋实例数据 ```typescript interface HeroTalentInstance { talId: number; // 天赋ID stackCount: number; // 当前堆叠层数 actionCounter: number; // 行为计数 damageCounter: number; // 受伤计数 lastTriggerLevel: number;// 最后触发等级 isActive: boolean; // 是否激活 } ``` --- ## ⚡ 性能建议 ### 1. 初始化一次，复用多次 ```typescript // ✅ 推荐 const manager = globalTalentManager; for (let i = 0; i < 1000; i++) { manager.onHeroAttack(heroId, 50); } // ❌ 不推荐 (频繁查询) for (let i = 0; i < 1000; i++) { getTalConf(7001); } ``` ### 2. 缓存配置对象 ```typescript // ✅ 推荐 const configs = getTalConfByType(TalType.LEVEL_ATTR); configs.forEach(config => { /* 使用 */ }); // ❌ 不推荐 (重复查询) for (let i = 0; i < 100; i++) { const config = getTalConf(7001); } ``` ### 3. 合理设置堆叠上限 ```typescript // 防止无限堆叠导致性能问题 maxStack: 20, // 而不是无限 ``` --- ## 🐛 调试与测试 ### 打印所有天赋信息 ```typescript import { TalentQueryHelper } from "./TalSet_Example"; TalentQueryHelper.printAllTalents(); ``` ### 获取特定条件的天赋 ```typescript import { TalentQueryHelper, TalAttrType, TalActionType } from "./TalSet_Example"; // 获取所有影响生命值的天赋 const hpTals = TalentQueryHelper.getTalentsByAttribute(TalAttrType.HP); // 获取所有与攻击相关的天赋 const attackTals = TalentQueryHelper.getTalentsByAction(TalActionType.ATTACK); ``` ### 查看英雄天赋状态 ```typescript import { globalTalentManager } from "./TalSet_Example"; const talentInfo = globalTalentManager.getHeroTalentInfo(5001); console.table(Array.from(talentInfo?.talents.values() || [])); ``` --- ## 📋 完整集成示例 ```typescript // main.ts 或 game.ts import { initHeroTalents, onHeroLevelUp, onHeroAttack, onHeroDamaged, TalentSystemExample } from "./TalSet_Example"; class GameSystem { initGame() { // 1. 为英雄初始化天赋 initHeroTalents(5001, [7001, 7202, 7101]); // 2. 在战斗系统中监听事件 this.setupEventListeners(); } setupEventListeners() { // 英雄升级时 on('heroLevelUp', (heroId, newLevel) => { onHeroLevelUp(heroId, newLevel); }); // 英雄发动攻击时 on('heroAttack', (heroId, damage) => { onHeroAttack(heroId, damage); }); // 英雄受伤时 on('heroDamaged', (heroId, damage) => { onHeroDamaged(heroId, damage); }); } // 用于调试 debugTalents() { const example = new TalentSystemExample(); example.initLiuBangTalents(); example.simulateLevelUp(); example.simulateCombat(); example.queryTalentInfo(); } } ``` --- ## 🎓 学习路径 ### 初级 (理解基础) 1. 阅读本文件 2. 查看 TalSet_QuickRef.md 3. 运行预置示例 ### 中级 (自定义开发) 1. 阅读 TalSet_USAGE.md 2. 参考 TalSet_Example.ts 3. 添加新的天赋配置 ### 高级 (系统扩展) 1. 研究 TalSet.ts 源代码 2. 创建新的触发条件类型 3. 实现自定义效果逻辑 --- ## 🤝 贡献指南 ### 添加新的预置天赋 1. 确定天赋类型和ID 2. 在 TalSet.ts 中添加配置 3. 在本文档中更新示例表格 4. 在 TalSet_USAGE.md 中记录详情 ### 报告问题 - 配置错误？检查接口是否实现 - 触发不工作？检查事件是否正确调用 - 性能问题？检查 maxStack 是否过大 --- ## 📞 快速帮助 ### Q: 天赋何时触发？ **A**: 取决于配置的触发条件： - 等级类：升到指定等级 - 行为类：行为累计达到指定次数 - 受伤类：受伤累计达到指定次数 - 技能类：满足前三种条件之一 ### Q: 如何禁用某个天赋？ **A**: 初始化时不添加该天赋ID即可 ```typescript initHeroTalents(heroId, [7001, 7002]); // 不包括 7101 ``` ### Q: 天赋堆叠有上限吗？ **A**: 有，由 `maxStack` 属性控制 ```typescript maxStack: 20, // 最多堆叠20次 // 不设置则无限堆叠（不推荐） ``` ### Q: 百分比效果如何计算？ **A**: 在实现层面应用 ```typescript // 如果 percent: true，value: 10 // 则增益 = 基础属性 × 110% (基础+10%) // 多堆叠层 = 基础属性 × (1 + 0.1 * stackCount) ``` --- ## 📄 许可证 这个天赋系统是项目的内部组件，遵循项目许可。 --- ## ✅ 检查清单 在投入使用前，请确认： - [ ] 已阅读本文档 - [ ] 了解四种天赋类型的区别 - [ ] 能够添加新天赋配置 - [ ] 已在游戏系统中集成事件监听 - [ ] 已进行性能测试 - [ ] 已验证天赋触发正常 --- ## 📞 支持 遇到问题？ 1. 查看 **TalSet_QuickRef.md** 的常见问题 2. 参考 **TalSet_USAGE.md** 的详细说明 3. 查看 **TalSet_Example.ts** 的实现代码 4. 检查浏览器控制台的调试输出 --- **天赋系统已就绪！🚀 祝游戏开发愉快！** --- ## 📊 系统统计 | 指标 | 数值 | |------|------| | 总代码行数 | ~1,200 | | 预置天赋 | 12个 | | 支持属性 | 9种 | | 支持行为 | 3种 | | 触发条件类型 | 3种 | | 效果类型 | 2种 | | 最大天赋ID | 7399 | | 扩展性评分 | ⭐⭐⭐⭐⭐ |