SuperAPI AI 工具集

godot-genre-card-game

通用与其它

查看项目

更新于 10-15 21:33

技能介绍

用途:为 Godot 中开发数字卡牌游戏(CCG/构筑卡牌)提供架构与实现指引,核心循环为抽牌→评估→出牌→结算(LIFO 栈)→弃牌/结束。

主要能力:提供一套可复用组件思路,包括 card_effect_resolution.gd(LIFO 效果栈,用 push_back/pop_back 解析嵌套触发与反制)、card_data_resource.gd(可在 Inspector 编辑的 Resource 卡牌定义,要求无参 _init)、card_tween_manager.gd(可中断的牌堆/手牌补间,避免瞬移)、deck_shuffle_bag.gd(洗牌均匀性)、turn_state_machine.gd(抽牌/出牌/战斗阶段)、card_drag_drop.gd(_get_drag_data 原生拖放)、board_query_filter.gd、reactive_card_ui.gd、board_state_dictionary.gd(Vector2i 网格跟踪)、match_state_resetter.gd、deck_builder_validator.gd 等。

使用方式:技能按数据→UI→输入→逻辑→润色的链路组织,需先阅读上述强制组件再实现对应系统;官方文档链接仅在研究具体 API 时按需打开。

主要限制与禁忌:不要在 UI 脚本中硬编码卡牌逻辑;不要在 _process() 中做盘面 Power/Toughness 计算,应使用信号触发或集中式 EffectStack 解析器;反应栈必须用 LIFO(pop_back),不可用 FIFO pop_front;拖放时须管理 Z-Index;牌堆间移动须用 create_tween()/tween_property 且时长 0.2s 以上,不可瞬移;手牌须用 Curve2D 的 sample_baked() 布局,不可用 global_position;必须处理空牌库并自动重洗弃牌堆;离散数值用 int,避免浮点漂移;100+ 图标用 _draw() 自定义绘制;遍历数组时反向迭代或 filter()。

依赖与配套:前置技能包括 godot-project-foundations、godot-resource-data-patterns、godot-gdscript-mastery、godot-ui-containers;配套有 godot-tweening、godot-signal-architecture、godot-input-handling、godot-turn-system、godot-shaders-basics 等。具体版本、授权与收费信息暂未提供。