用途:为 Godot 引擎开发数字卡牌游戏(CCG、构筑类、战术卡牌)提供架构蓝图,核心循环为抽牌、评估、出牌、按 LIFO 栈结算、弃牌或结束回合。
主要能力:基于 Resource 的卡牌数据定义(Inspector 可视化编辑);牌堆与弃牌堆管理,含抽牌、弃牌、重洗与防止空牌堆死锁;回合状态机管理抽牌、出牌、战斗等阶段;弧形手牌布局(Curve2D.sample_baked);原生拖拽与拖拽目标判定;用 Callable 或 Command Resource 推入 LIFO 栈做效果结算,支持嵌套触发与反制;Tween 驱动的牌堆/手牌过渡动画;密排棋盘用 _draw() 自定义绘制;数据驱动的界面响应。
使用方式:按技能链分阶段接入——数据(resources、custom-resources)、UI(control-nodes、layout-containers)、输入(drag-and-drop、state-machines)、逻辑(command-pattern、signals)、打磨(godot-tweening、shaders)。实施相关系统前需先阅读 card_effect_resolution.gd、card_tween_manager.gd、card_data_resource.gd 等脚本。
限制与要点:不要把卡牌逻辑硬编码进 UI,不要在 _process() 里算棋盘状态;不要用 FIFO pop_front 处理反应栈;移动牌堆必须用 Tween 而非瞬移;卡牌数值用 int 避免浮点漂移;Resource 的 _init() 须提供无参构造函数;遍历删除数组元素须倒序或 filter()。
具体安装命令、价格与平台信息暂未提供。