chun92/card-framework
chun92/card-framework has 383 GitHub stars and 41 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-20 18:57 UTC. Last push 2026-05-08.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
A flexible and lightweight toolkit for building 2D card games (Solitaire, TCGs, roguelikes) in the Godot Engine.
开发工具README.md
原文Card Framework
Professional-grade Godot 4.x addon for building 2D card games. Create Solitaire, TCG, or deck-building roguelikes with flexible card handling and drag-and-drop interactions.

Key Features
• Drag & Drop System - Intuitive card interactions with built-in validation
• Flexible Containers - Pile (stacks), Hand (fanned layouts with HandAnchor), custom containers
• JSON Card Data - Define cards with metadata, images, and custom properties
• Editor Preview - Visual container previews in the Godot editor with live Inspector updates
• Production Ready - Complete FreeCell implementation included
• Extensible Architecture - Factory patterns, inheritance hierarchy, event system
Installation
From AssetLib: Search "Card Framework" in Godot's AssetLib tab
Manual: Copy contents to res://addons/card-framework
Quick Start
- Add CardManager - Instance
card-framework/card_manager.tscnabove all CardContainers in scene hierarchy - Configure Factory - Assign
JsonCardFactorytocard_factory_scene - Set Directories - Point
card_asset_dirto images,card_info_dirto JSON files - Add Containers - Create
PileorHandnodes as children of CardManager
Basic Card JSON
{
"name": "club_2",
"front_image": "cardClubs2.png",
"suit": "club",
"value": "2"
}
Core Architecture
CardManager - Root orchestrator managing factories, containers, and move history
Card - Individual card nodes with animations, face states, interaction properties
CardContainer - Base class for Pile (stacks) and Hand (fanned layouts)
CardFactory - Creates cards from JSON data, supports custom implementations
Sample Projects
example1/ - Basic demonstration with different container typesfreecell/ - Complete game with custom rules, statistics, seed generation
Run: res://example1/example1.tscn or res://freecell/scenes/menu/menu.tscn
Customization
Custom Containers - Extend CardContainer, override check_card_can_be_dropped()
Custom Cards - Extend Card class for game-specific properties
Custom Factories - Extend CardFactory for database/procedural card creation
Documentation
• Getting Started Guide - Complete setup and configuration
• API Reference - Full class documentation and method reference
• Changelog - Version history and upgrade guide
• Documentation Index - Complete documentation overview
Contributing
- Fork repository
- Create feature branch
- Commit with clear messages
- Open pull request with problem description
License & Credits
Framework: Open source Card Assets: Kenney.nl (CC0 License) Version: 1.4.0 (Godot 4.6+ compatible)
Thanks to: Kenney.nl, InsideOut-Andrew, Rosetta Code FreeCell