Skip to content
프로젝트

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.

이 수치를 측정하는 방법

측정된 스타 증가

in 24h
0
in 7 days
기록 수집 중
in 15 days
기록 수집 중
in 1 month
기록 수집 중

서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.

소개

A flexible and lightweight toolkit for building 2D card games (Solitaire, TCGs, roguelikes) in the Godot Engine.

개발 도구

README.md

Original

Card Framework

Version Godot License Platform

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.

Example1 Screenshot Freecell Screenshot

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

  1. Add CardManager - Instance card-framework/card_manager.tscn above all CardContainers in scene hierarchy
  2. Configure Factory - Assign JsonCardFactory to card_factory_scene
  3. Set Directories - Point card_asset_dir to images, card_info_dir to JSON files
  4. Add Containers - Create Pile or Hand nodes 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 types
freecell/ - 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

  1. Fork repository
  2. Create feature branch
  3. Commit with clear messages
  4. 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