EFD Trading Card Mod - Custom Foundry VTT trading card system
Go to file
Cal Corum 80da308d17 Add ModConfig integration for card set info display
Integrate with ModOptions workshop mod to display loaded card sets
information in the game's Settings menu. Uses read-only dropdowns
(single-option) to show data without allowing user modification.

Features:
- ModConfigApi.cs wrapper for safe ModConfig interaction
- Auto-detect ModConfig availability via OnModActivated event
- Display total cards, total packs, and per-set card counts
- Graceful fallback when ModConfig not installed

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-19 22:06:15 -06:00
.claude Add unit testing framework and refactor parsing logic 2025-11-18 19:40:43 -06:00
CardSets/ExampleSet Implement card pack system with gacha mechanics 2025-11-19 21:44:29 -06:00
src Add ModConfig integration for card set info display 2025-11-19 22:06:15 -06:00
tests Add unit testing framework and refactor parsing logic 2025-11-18 19:40:43 -06:00
.gitignore Initial commit: Trading Card Mod scaffold for Escape from Duckov 2025-11-18 18:55:04 -06:00
CLAUDE.md Update CLAUDE.md for Phase 2 completion 2025-11-19 16:57:18 -06:00
deploy.sh Implement Phase 2: Core card framework with clone + reflection 2025-11-19 16:56:04 -06:00
info.ini Initial commit: Trading Card Mod scaffold for Escape from Duckov 2025-11-18 18:55:04 -06:00
README.md Initial commit: Trading Card Mod scaffold for Escape from Duckov 2025-11-18 18:55:04 -06:00
remove.sh Implement Phase 2: Core card framework with clone + reflection 2025-11-19 16:56:04 -06:00
TradingCardMod.csproj Implement card pack system with gacha mechanics 2025-11-19 21:44:29 -06:00
TradingCardMod.Tests.csproj Add unit testing framework and refactor parsing logic 2025-11-18 19:40:43 -06:00

Trading Card Mod for Escape from Duckov

A customizable trading card system that lets you add your own card sets to the game.

Requirements

Required Mod Dependency:

This mod requires the HarmonyLoadMod to be installed. It provides the Harmony library that many mods share to avoid version conflicts.

Installation

  1. Subscribe to HarmonyLib on Steam Workshop
  2. Build the mod (see Development section)
  3. Copy the TradingCardMod folder to your game's Duckov_Data/Mods directory
  4. Launch the game and enable both HarmonyLib and this mod in the Mods menu

Adding Card Sets

Creating a New Card Set

  1. Create a new folder in CardSets/ with your set name (e.g., CardSets/MyCards/)
  2. Create a cards.txt file in your folder
  3. Create an images/ subfolder for card artwork

Card Definition Format

Cards are defined in cards.txt using pipe-separated values:

CardName | SetName | SetNumber | ImageFile | Rarity | Weight | Value

Example:

Blue Dragon | Fantasy Set | 001 | blue_dragon.png | Ultra Rare | 0.01 | 500
Fire Sprite | Fantasy Set | 002 | fire_sprite.png | Rare | 0.01 | 100

Field Descriptions

Field Description Example
CardName Display name of the card "Blue Dragon"
SetName Name of the collection "Fantasy Set"
SetNumber Number for sorting (as integer) 001
ImageFile Image filename in images/ folder "blue_dragon.png"
Rarity Card rarity tier Common, Uncommon, Rare, Ultra Rare
Weight Physical weight in game units 0.01
Value In-game currency value 500

Image Requirements

  • Place images in your card set's images/ subfolder
  • Recommended format: PNG
  • Recommended size: 256x256 or similar aspect ratio

Comments

Lines starting with # are treated as comments and ignored:

# This is a comment
# CardName | SetName | SetNumber | ImageFile | Rarity | Weight | Value
Blue Dragon | Fantasy Set | 001 | blue_dragon.png | Ultra Rare | 0.01 | 500

Folder Structure

TradingCardMod/
├── TradingCardMod.dll
├── info.ini
├── preview.png
├── CardSets/
│   ├── ExampleSet/
│   │   ├── cards.txt
│   │   └── images/
│   │       └── (card images here)
│   └── YourCustomSet/
│       ├── cards.txt
│       └── images/
└── README.md

Development

Requirements

  • .NET SDK (for .NET Standard 2.1)
  • Escape from Duckov installed

Building

  1. Update DuckovPath in TradingCardMod.csproj to point to your game installation
  2. Build the project:
    dotnet build
    
  3. The compiled DLL will be in bin/Debug/netstandard2.1/

Linux Steam Paths

Common Steam library locations on Linux:

  • ~/.steam/steam/steamapps/common/Escape from Duckov
  • ~/.local/share/Steam/steamapps/common/Escape from Duckov

Testing

  1. Copy the build output to Duckov_Data/Mods/TradingCardMod/
  2. Launch the game through Steam
  3. Enable the mod in the Mods menu
  4. Check the game's log for [TradingCardMod] messages

Troubleshooting

"CardSets directory not found"

The mod will create this directory automatically. Add your card sets there.

Cards not appearing

  • Check that cards.txt follows the exact format (7 pipe-separated fields)
  • Ensure image files exist in the images/ subfolder
  • Check the game log for parsing errors

Build errors

  • Verify DuckovPath in the .csproj points to your actual game installation
  • Ensure you have .NET SDK installed with dotnet --version

License

This mod is provided as-is for personal use. Do not distribute copyrighted card artwork.

Credits

Built using the official Duckov modding framework.