"Every card is a story waiting to be told, an echo of power waiting to resonate." -- Archivist of the Deck of Echoes
This guide explains how to create custom cards for Veilborn Chronicles.
Understanding the Card System#
The Deck of Echoes#
Veilborn uses a unique dual-purpose card system called the Deck of Echoes:
- Face-Up Play: Active abilities with immediate effects
- Face-Down Play: Reactive traps and defensive responses
Every card has both an active and reactive mode, making deck-building strategically rich.
Card Types#
| Type | Purpose | Color | Primary Use |
|---|---|---|---|
| Echo | Character abilities | Blue | Active powers and attacks |
| Realm | Environmental effects | Green | Battlefield modifications |
| Fate | Random events | Purple | Chaos and luck manipulation |
| Bond | Connections | Gold | Party synergies and links |
Rarity Levels#
| Rarity | Symbol | Deck Limits | Power Level |
|---|---|---|---|
| Common | Circle | No limit | Low |
| Uncommon | Diamond | No limit | Medium |
| Rare | Star | Max 3 copies | High |
| Mythic | Crown | Max 3 total | Very High |
| Legendary | Dragon | Max 1 total | Extreme |
Card Definition Structure#
Basic Template#
const myCard: CardDefinition = {
id: 'unique-card-id',
cardId: 'CARD-001',
name: 'Card Name',
description: 'What the card does.',
cardType: 'echo',
rarity: 'common',
cost: {
resonance: 2,
},
effects: [
// Face-up effects
],
faceDownEffects: [
// Face-down effects (optional)
],
keywords: ['keyword1', 'keyword2'],
flavorText: 'Atmospheric text that adds lore.',
isActive: true,
};
Complete Card Example#
const probabilityShift: EchoCard = {
id: 'echo-weaver-probability-shift',
cardId: 'ECH-WEA-001',
name: 'Probability Shift',
description: 'Manipulate the threads of chance to alter an outcome.',
cardType: 'echo',
rarity: 'uncommon',
setId: 'core-set',
// Cost to play
cost: {
resonance: 2,
veilPoints: 0,
},
// Face-up (active) effects
effects: [
{
id: 'prob-shift-main',
type: 'stat_modify',
trigger: 'on_play',
target: 'ally',
stat: 'next_roll',
modifier: 'add',
value: 3,
description: 'Target ally gains +3 to their next roll.',
},
],
// Face-down (reactive) effects
faceDownEffects: [
{
id: 'prob-shift-react',
type: 'redirect',
trigger: 'on_reveal',
target: 'enemy',
description: 'Force an enemy to reroll their last result.',
conditions: [
{
type: 'stat_check',
stat: 'last_enemy_roll',
operator: '>=',
value: 15,
source: 'global',
},
],
},
],
// Deck requirements
requirements: {
requiredPath: 'weaver',
},
keywords: ['probability', 'manipulation', 'reroll'],
flavorText: 'The Weave does not care what "should" happen.',
artUrl: '/cards/echo/probability-shift.png',
isActive: true,
// Echo-specific fields
echoStrength: 2,
echoElement: 'flow',
resonanceAffinity: 'flow',
};
Card Types Deep Dive#
Echo Cards#
Echo cards represent character abilities - direct actions that affect the game state.
interface EchoCard extends CardDefinition {
cardType: 'echo';
echoStrength: number; // 1-5, power level
echoElement?: string; // Element affinity
resonanceAffinity?: string; // Resonance type bonus
}
Design Guidelines:
echoStrengthshould match the cost and impact- Strength 1: Minor utility (cost 1)
- Strength 3: Solid ability (cost 2-3)
- Strength 5: Powerful effect (cost 4+)
Example - Attack Echo:
const voidStrike: EchoCard = {
id: 'echo-shadow-void-strike',
cardId: 'ECH-SHA-015',
name: 'Void Strike',
description: 'Strike from the emptiness between spaces.',
cardType: 'echo',
rarity: 'rare',
cost: { resonance: 3 },
effects: [
{
id: 'void-strike-damage',
type: 'damage',
trigger: 'on_play',
target: 'enemy',
value: 4,
description: 'Deal 4 damage to target enemy.',
},
{
id: 'void-strike-bypass',
type: 'condition_apply',
trigger: 'on_play',
target: 'enemy',
description: 'This damage ignores 2 points of defense.',
conditions: [],
},
],
keywords: ['attack', 'void', 'piercing'],
echoStrength: 4,
echoElement: 'void',
resonanceAffinity: 'void',
isActive: true,
};
Realm Cards#
Realm cards create environmental effects that persist on the battlefield.
interface RealmCard extends CardDefinition {
cardType: 'realm';
realmDuration: number; // Turns the realm lasts
realmRadius?: number; // Area of effect in hexes
environmentalEffects: CardEffect[];
}
Design Guidelines:
- Duration should balance power
- Short duration (1-2 turns): Strong effects
- Long duration (4+ turns): Moderate effects
- Global realms: Weak but universal effects
Example - Area Realm:
const veilThinning: RealmCard = {
id: 'realm-void-veil-thinning',
cardId: 'RLM-VOI-003',
name: 'Veil Thinning',
description: 'Create a zone where the Veil grows weak.',
cardType: 'realm',
rarity: 'rare',
cost: { resonance: 3, veilPoints: 1 },
effects: [
{
id: 'veil-thin-place',
type: 'summon',
trigger: 'on_play',
target: 'self',
description: 'Create Veil Thinning zone at target location.',
},
],
environmentalEffects: [
{
id: 'veil-thin-buff',
type: 'buff',
trigger: 'continuous',
target: 'all_characters',
stat: 'void_abilities',
modifier: 'add',
value: 2,
description: 'All characters in zone gain +2 to Void abilities.',
},
{
id: 'veil-thin-danger',
type: 'damage',
trigger: 'on_turn_end',
target: 'all_characters',
value: 1,
description: 'Characters in zone take 1 Void damage at end of turn.',
},
],
keywords: ['zone', 'void', 'environmental'],
realmDuration: 3,
realmRadius: 2,
isActive: true,
};
Fate Cards#
Fate cards introduce controlled randomness and fortune manipulation.
interface FateCard extends CardDefinition {
cardType: 'fate';
fortuneValue: number; // Positive outcome strength
misfortuneValue: number; // Negative outcome strength
chaosWeight: number; // Randomness factor (0-100)
}
Design Guidelines:
chaosWeightdetermines predictability- Low chaos (0-30): Mostly reliable
- High chaos (70-100): Wild variance
- Balance fortune/misfortune for fairness
Example - Fortune Card:
const wheelOfFate: FateCard = {
id: 'fate-oracle-wheel',
cardId: 'FTE-ORA-007',
name: 'Wheel of Fate',
description: 'Spin the wheel and accept what comes.',
cardType: 'fate',
rarity: 'mythic',
cost: { resonance: 2 },
effects: [
{
id: 'wheel-spin',
type: 'buff',
trigger: 'on_play',
target: 'self',
description: 'Roll 1d6: 1-2 = misfortune, 3-4 = nothing, 5-6 = fortune.',
conditions: [
{ type: 'random', operator: '>=', value: 5, source: 'global' },
],
},
],
keywords: ['fortune', 'random', 'oracle'],
fortuneValue: 5,
misfortuneValue: 3,
chaosWeight: 66,
isActive: true,
};
Bond Cards#
Bond cards create connections between characters and enhance teamwork.
interface BondCard extends CardDefinition {
cardType: 'bond';
bondStrength: number; // 1-5, connection power
bondTargets: number; // How many can be bonded
bondType: 'ally' | 'weave' | 'realm' | 'universal';
}
Design Guidelines:
- Party synergy is the primary goal
- Single-target bonds: Stronger effects
- Multi-target bonds: Weaker per-target
- Universal bonds: Weakest but most flexible
Example - Party Bond:
const sharedFate: BondCard = {
id: 'bond-weaver-shared-fate',
cardId: 'BND-WEA-002',
name: 'Shared Fate',
description: 'Link the destinies of allies together.',
cardType: 'bond',
rarity: 'rare',
cost: { resonance: 3 },
effects: [
{
id: 'shared-fate-link',
type: 'weave_connect',
trigger: 'on_play',
target: 'all_allies',
connectionType: 'fate_link',
connectionStrength: 3,
description: 'Create fate links between all allies.',
},
{
id: 'shared-fate-benefit',
type: 'heal',
trigger: 'on_damage_taken',
target: 'all_allies',
value: 1,
description: 'When a bonded ally takes damage, all others heal 1.',
conditions: [],
},
],
keywords: ['bond', 'fate', 'party'],
bondStrength: 3,
bondTargets: 4,
bondType: 'ally',
isActive: true,
};
Card Effects System#
Trigger Types#
| Trigger | When It Fires |
|---|---|
on_play |
Card played face-up |
on_reveal |
Face-down card revealed |
on_discard |
Card discarded |
on_draw |
Card drawn |
on_turn_start |
Owner's turn begins |
on_turn_end |
Owner's turn ends |
on_attack |
Owner attacks |
on_defend |
Owner defends |
on_damage_taken |
Owner takes damage |
on_damage_dealt |
Owner deals damage |
continuous |
Always active in play |
activated |
Manually triggered |
Effect Types#
type EffectType =
// Damage/Healing
| 'damage' // Deal damage
| 'heal' // Restore health
// Buffs/Debuffs
| 'buff' // Positive modifier
| 'debuff' // Negative modifier
| 'stat_modify' // Change a stat
| 'condition_apply' // Apply status effect
| 'condition_remove' // Remove status effect
// Card Manipulation
| 'draw' // Draw cards
| 'discard' // Force discard
| 'exile' // Remove from game
| 'return_to_hand' // Return card to hand
| 'summon' // Create token/effect
| 'transform' // Change card type
| 'copy' // Duplicate effect
| 'steal' // Take control
| 'counter' // Cancel effect
| 'redirect' // Change target
// Resources
| 'resonance_gain' // Gain resonance
| 'resonance_drain' // Remove resonance
| 'veil_points_gain' // Gain VP
| 'veil_points_drain' // Remove VP
// Weave
| 'weave_connect' // Create connection
| 'weave_strengthen' // Boost connection
| 'weave_sever'; // Break connection
Target Types#
| Target | Description |
|---|---|
self |
The card owner |
ally |
Single ally |
enemy |
Single enemy |
all_allies |
All allies |
all_enemies |
All enemies |
all_characters |
Everyone |
random_ally |
Random ally |
random_enemy |
Random enemy |
card_in_hand |
Card in hand |
card_in_play |
Card in play |
card_in_discard |
Card in discard |
Conditions#
Effects can have conditions that must be met:
interface EffectCondition {
type:
| 'stat_check'
| 'card_count'
| 'resonance_check'
| 'health_check'
| 'weave_check'
| 'random';
operator: '>' | '<' | '>=' | '<=' | '==' | '!=';
value: number | string;
stat?: string;
source?: 'self' | 'target' | 'global';
}
Example Conditions:
// Only if target has low health
{ type: 'health_check', operator: '<=', value: 5, source: 'target' }
// Only if you have 3+ cards in hand
{ type: 'card_count', operator: '>=', value: 3, source: 'self' }
// 50% chance
{ type: 'random', operator: '>=', value: 50, source: 'global' }
Cost and Balance#
Cost Guidelines#
| Resource | Typical Value | Effect Level |
|---|---|---|
| Resonance 1 | Minor | Draw 1, +1 to roll |
| Resonance 2 | Standard | Deal 2 damage, heal 2 |
| Resonance 3 | Strong | Deal 4 damage, AoE effect |
| Resonance 4+ | Powerful | Major impact |
| Veil Points | Premium | Path-specific or powerful |
| Discard | Alternative | Flexible but costly |
Balance Checklist#
Before finalizing a card, verify:
- Cost matches power level
- Face-down mode is situationally useful but not better than face-up
- Keywords are accurate
- Description clearly explains all effects
- Conditions are achievable but not trivial
- Doesn't create infinite loops or soft-locks
- Synergizes with Path without being required
Deck Requirements#
Path-Specific Cards#
requirements: {
requiredPath: 'seer', // Only Seers can use
minLevel: 3, // Requires level 3+
requiredAwakening: 'truth_sight' // Specific awakening
}
Deck Building Rules#
Standard deck rules:
- Minimum 40 cards
- Maximum 60 cards
- Max 3 copies of any card
- Max 1 Legendary
- Max 3 Mythic total
Keywords Reference#
Common keywords and their meanings:
| Keyword | Meaning |
|---|---|
quick |
Can be played as reaction |
ritual |
Requires setup time |
persistent |
Stays in play |
fleeting |
Discards after use |
piercing |
Ignores some defense |
splash |
Affects adjacent targets |
channeled |
Requires concentration |
exhausting |
Can only use once per encounter |
Testing Your Cards#
Validation#
Use the deck validation system:
import { validateDeck, validateCard } from '@veilborn/core';
// Validate single card
const cardValidation = validateCard(myCard);
if (!cardValidation.valid) {
console.error('Card issues:', cardValidation.errors);
}
// Validate deck with card
const deckValidation = validateDeck(myDeck);
console.log('Card distribution:', deckValidation.typeDistribution);
console.log('Average cost:', deckValidation.averageCost);
Playtesting Recommendations#
- Test face-up and face-down modes separately
- Check interaction with Path abilities
- Verify conditions trigger appropriately
- Balance against similar-cost cards
- Test in different party compositions
Card Art Guidelines#
Image Specifications#
- Resolution: 750x1050 pixels (standard card ratio)
- Format: PNG with transparency
- File naming:
{type}-{path}-{name}.png
Art Style#
- Consistent with Veilborn aesthetic
- Clear focal point
- Visible at card size
- Color palette matching card type
For creature creation, see Creature Creation Guide For realm building, see Realm Building Guide