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.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
A flexible and lightweight toolkit for building 2D card games (Solitaire, TCGs, roguelikes) in the Godot Engine.
Developer ToolsREADME.md
OriginalCard 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