Coin Management

Track your character's coins directly in Discord with a complete audit trail of all transactions.

Quick Start

!coin show                    # See current coin amounts
!coin ledger                  # View recent transaction history
!coin gain 5g 10s            # Add 5 gold and 10 silver
!coin gain 5g quest reward   # Add 5 gold with description
!coin lose 2g tavern bill    # Subtract 2 gold with note
!coin +15s found treasure    # Shorthand: add 15 silver with note
!coin -3g 5c bridge toll     # Shorthand: subtract with description

Commands

!coin show

Display your character's current coin amounts.

Example:

!coin show

Gandalf's coins: 🟡 25g 🔘 13s 🟤 7c

!coin ledger

View your character's recent transaction history (last 3 transactions).

Example:

!coin ledger

Gandalf's recent coin transactions:
1. -2g → 25g 13s 7c (2024-01-15) - tavern bill
2. +5g +10s → 27g 3s 7c (2024-01-14) - quest reward from mayor
3. +15g → 22g 3s 7c (2024-01-14) - starting treasure

!coin gain <amounts> [description]

Add coins to your character with optional description.

Examples:

!coin gain 10g                    # Add 10 gold
!coin gain 5g 20s 15c             # Add mixed denominations  
!coin gain 100c found treasure    # Add copper with description
!coin gain quest reward 5g 10s    # Description can come first
!coin gain 2g for slaying 3s rats # Mix amounts and description

Notes: - Coin amounts (like 5g, 10s, 3c) are automatically detected - Everything else becomes the transaction description - Order doesn't matter - put descriptions before, after, or mixed with amounts

!coin lose <amounts> [description]

Subtract coins from your character with optional description.

Examples:

!coin lose 5g                      # Lose 5 gold
!coin lose 2g 10s                  # Lose gold and silver
!coin lose 50c bought supplies     # Lose copper with description
!coin lose tavern bill 2g 5s       # Description can come first
!coin lose 1g for room 50c for ale # Mix amounts and description

Notes: - Coin amounts (like 5g, 10s, 3c) are automatically detected - Everything else becomes the transaction description - Order doesn't matter - put descriptions before, after, or mixed with amounts

Shorthand Syntax

Use + and - prefixes for quicker commands. Descriptions work the same way.

Examples:

!coin +10g                   # Same as: !coin gain 10g
!coin -5s                    # Same as: !coin lose 5s
!coin +2g 15s                # Same as: !coin gain 2g 15s
!coin +10g quest reward      # Same as: !coin gain 10g quest reward
!coin -5s tavern meal        # Same as: !coin lose 5s tavern meal
!coin +treasure 5g 10s found # Description can be anywhere

Coin Amounts

Supported Formats

• 5g - 5 gold pieces
• 10s - 10 silver pieces
• 25c - 25 copper pieces
• 5 - 5 gold pieces (defaults to gold)
• 2g 10s 5c - Mixed denominations

Multiple Denominations

You can specify multiple coin types in any order:

!coin gain 5g 10s 3c         # Add 5 gold, 10 silver, 3 copper
!coin +15s 2g                # Order doesn't matter

Transaction Descriptions

Flexible Syntax

Add context to your transactions with natural language descriptions. The bot automatically separates coin amounts from description text.

Key Features: - Mix coin amounts and descriptions in any order - No quotes needed (but they're allowed)
- Everything that isn't a coin amount becomes your note - Notes are stored in the transaction history for context

Examples:

!coin gain 5g quest reward from mayor     # Description after amounts
!coin gain quest reward 5g from mayor     # Description around amounts  
!coin +treasure found 10g 5s in dungeon   # Description before and after
!coin lose tavern bill 2g for the night   # Natural language flow
!coin -3g 5c toll for crossing bridge     # Shorthand with description

What Counts as Coin Amounts: - 5g, 10s, 25c - Standard format - 5 - Plain numbers (treated as gold) - Case insensitive: 5G, 10S, 25C

Everything Else Becomes Your Note: - Words, punctuation, numbers in text - paid 5 gold → coin: none, note: "paid 5 gold" - 5g paid to smith → coin: 5g, note: "paid to smith"

How It Works

Two Tracking Systems

The bot supports two separate coin tracking approaches:

1. Shadowdarklings Only - Your character sheet manages all coins
2. Discord Tracking - The bot tracks coins with full transaction history

You cannot use both simultaneously. Once you start using Discord commands (!coin gain/lose), the bot takes over coin tracking.

Transaction History

Every coin change creates a permanent ledger entry: - What changed (gained/lost amounts) - When it happened (timestamp) - Why it happened (description and notes) - Running totals after the change

Example Transaction:

Date: 2024-01-15 14:30 UTC
Change: +5g +10s +0c
New Total: 25g 13s 7c  
Description: Gained coins via Discord command
Notes: Loot from dragon fight

Current Coin Calculation

Your current coins are determined by: - If you've never used Discord coin commands: Values from your character sheet - If you've used Discord coin commands: Most recent ledger entry totals

Character Updates & Reconciliation

When you update your character from Shadowdarklings, the bot intelligently handles coin differences.

Automatic (No Prompt)

If your character sheet's coins haven't changed since your last update: - ✅ Character updates automatically - ✅ Your Discord-tracked coins are preserved
- ✅ All other character changes applied normally

Common scenario: You level up, change equipment, or gain XP, but don't touch the coin fields on your sheet.

Manual Choice (Prompt)

If your character sheet's coins have changed since your last update:

You'll see three options:

📊 Accept with tracked coins

• Use: Discord's tracked coin amounts
• Effect: Character updates, coin fields from sheet are ignored
• Best for: When your sheet is outdated and Discord tracking is current

📄 Accept with sheet coins

• Use: Coin amounts from your character sheet
• Effect: Discord tracking syncs to match your sheet
• Best for: When you've made purchases outside Discord

❌ Reject update

• Use: Cancel the entire character update
• Effect: No changes to character or coins
• Best for: When you need to resolve discrepancies first

Audit Trail

Every reconciliation decision creates a ledger entry for transparency: - Records which coins were offered vs. which were chosen - Documents the reconciliation decision - Maintains complete history of all coin changes

Best Practices

Starting Fresh

If you're new to Discord coin tracking: 1. Update your character normally (coins will come from sheet) 2. Use !coin show to see current amounts 3. Start using !coin gain/lose for future transactions

Consistent Tracking

• Pick one system: Either use Discord commands OR manage coins in Shadowdarklings
• Be consistent: Don't mix manual sheet edits with Discord tracking
• Add notes: Use descriptive notes for better record keeping

Error Prevention

• The bot prevents negative coin amounts
• All transactions are validated before being saved
• You'll get clear error messages if something goes wrong

Example Error:

!coin lose 100g

Insufficient gold! You need 75 more gold (you have 25g).

Examples

Starting Character

# Check starting coins (from character sheet)
!coin show
→ Thorin's coins: 🟡 15g 🔘 0s 🟤 0c

# First Discord transaction
!coin gain 25g starting treasure
→ Thorin gained 🟡 25g for starting treasure
→ New totals: 🟡 40g 🔘 0s 🟤 0c

Adventure Loot

# Found treasure
!coin +10g 50s goblin cave loot
→ Thorin gained 🟡 10g 🔘 50s for goblin cave loot
→ New totals: 🟡 50g 🔘 50s 🟤 0c

# Bought supplies  
!coin -5g 30s bought rations and rope
→ Thorin lost 🟡 5g 🔘 30s for bought rations and rope
→ New totals: 🟡 45g 🔘 20s 🟤 0c

Character Updates

# Level up (no coin changes on sheet)
[Update character in Shadowdarklings - coins unchanged]
→ ✅ Character updated automatically. Your tracked coins preserved.

# Major story event (coins changed on sheet) 
[Update character in Shadowdarklings - added reward coins]
→ ⚠️ Coin mismatch detected!
   📊 Tracked coins: 45g 20s 0c
   📄 Sheet coins: 45g 20s 100c
   [Choose: Accept tracked | Accept sheet | Reject]

Troubleshooting

"You need to select a character first"

Solution: Use !character <name> to select your active character.

"Insufficient coins" errors

Solution: Check your current amounts with !coin show. You might have fewer coins than expected.

Coin amounts seem wrong after character update

Explanation: If you chose "Accept with sheet coins" during reconciliation, your Discord tracking synced to match your character sheet values.

Want to see transaction history

Solution: Use !coin ledger to view your recent transactions (last 3 entries with dates and notes).

Related Commands

• !character <name> - Select which character to manage coins for
• !character list - See all your characters
• !sheet - View your current character sheet

---

The coin management system preserves complete transaction history and provides full transparency into all coin changes, ensuring you never lose track of your character's wealth.