技能与成长树
核心规则
将技能树建模为 DAG,而非常规的树。一个节点可以有多个前置条件。循环会破坏校验,因此要拒绝任何会创建循环的管理端写入。
在服务端校验解锁。永远不要信任客户端的解锁请求。在服务端检查前置条件和货币,并在同一个事务中写入扣费和解锁记录。
在解锁时对节点做快照。在解锁记录中存储其前置条件、花费、效果和层级。这样在平衡性补丁之后,你仍能审计玩家购买了哪些内容。
按层级缩放花费。固定花费会让后期节点随着收入增长变得便宜。使用 cost = baseCost * tier^exponent,并依据每层级的玩家收入来调整指数。
始终提供重置(respec)。可以免费并带冷却,或用软货币付费。
将效果存储为数据。把效果保存在 JSONB 中({ "stat": "attack", "modifier": "+10%" }),并在服务端应用。这样平衡性调整只需更新数据,无需重新部署。
渐进式展示节点。当前置条件满足后再显示某个节点,这样新玩家不会一上来就面对整棵技能树。
流程
对每个节点分类:主动(由玩家触发的技能)、被动(始终生效的加成)、解锁(对内容或机制的访问入口)、转生(重置后仍保留的加成)。
填写设计文档。开始新技能树时复制 templates/skill-tree-template.md;其中包含花费表、重置策略、转生规则和平衡性检查清单。
创建数据表。构建后端时复制 boilerplate/skill-tree.ts。它定义了 skill_nodes(技能树定义,前置条件为节点 ID 的 JSONB 数组)和 player_skills(每次解锁一行,按玩家和节点唯一,并带快照)。
构建解锁端点。POST /skills/unlock/:nodeId 调用 unlockNode(db, playerId, nodeId, spend),在一个事务中执行资格检查、扣费和插入。spend 为必需参数,因此扣费不能被遗漏:传入 (tx, playerId, cost) => spendCurrency(tx, playerId, SKILL_CURRENCY, cost),使用 postgres-game-schema 中带保护的 spendCurrency。当玩家无法支付时它返回 false,unlockNode 会回滚。用 onDelete: 'cascade' 为 player_skills.player_id 到你的 players 表添加外键(文件中已标出位置)。
缓存已解锁集合。如果读取技能树会访问数据库,则缓存每个玩家已解锁的节点 ID,并在解锁或重置提交后删除缓存条目。
构建重置端点。POST /skills/respec:收取费用或检查冷却,删除该玩家的 player_skills 行(转生节点除外,按定义它们在重置后保留),退还被删除节点上花费的点数,并使缓存失效,除缓存删除外全部在一个事务中完成。
在每次管理端写入时运行健康检查。detectCycles 返回每个前置条件循环;findMissingPrerequisites 返回指向已删除节点的前置条件。如果任一结果非空,则拒绝该写入。
端点
端点 | 方法 | 作用
/skills/tree | GET | 返回完整技能树以及玩家在每个节点上的解锁状态(getPlayerTree)
/skills/unlock/:nodeId | POST | 在一个事务中校验前置条件和花费、扣费、插入
/skills/respec | POST | 收取费用、删除玩家解锁记录、退还点数
陷阱
把解锁状态放在客户端。容易被篡改,并且会与服务端不一致。
在并发下仅信任资格检查。两个并行请求可能都通过检查。对 (player, node) 的唯一索引会拒绝重复解锁,失败的插入会回滚该事务的扣费。但针对不同节点的请求不受此保护:你传入的 spend 必须自行保护钱包更新,正如 postgres-game-schema 中的 spendCurrency 通过 WHERE amount >= cost 并检查只更新了一行来实现的那样。
在 Drizzle 中链式调用 .where()。普通 select 只允许一个 .where();第二次调用会导致类型错误,而且构建器只存储最后一个条件。请用 and(...) 组合条件。
驱动程序不支持事务。Drizzle 的 neon-http 驱动会在 transaction() 中抛出 No transactions support in neon-http driver。请为 unlockNode 和 respec 使用支持交互式事务的驱动。
不提供重置。早期一个糟糕的选择会永久锁死流派。
固定花费。随着收入增长,后期节点会变得极其便宜。
不做循环检查。一个循环前置条件会让循环中的每个节点都不可达。
把效果写在代码里。每次平衡性调整都需要重新部署。
一次性显示整棵树。会让新玩家不知所措。
文件
boilerplate/skill-tree.ts:构建后端时复制。包含 Drizzle 表、canUnlock、unlockNode、hasUnlocked、getPlayerTree、detectCycles、findMissingPrerequisites。调用方传入自己的 Drizzle 数据库;该文件不导入任何驱动。
templates/skill-tree-template.md:设计新技能树时复制。
references/sources.md:需要了解该技能背后的来源时阅读。
相关技能
game-design-fundamentals:核心循环与成长节奏。
game-economy-design:技能点收入、花费和货币消耗点。
postgres-game-schema:玩家和钱包表,以及用于带保护扣费的 spendCurrency。
redis-game-patterns:缓存每个玩家已解锁的节点集合。