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 amount:5g 10s                # Add 5 gold and 10 silver
/coin gain amount:5g note:quest reward  # Add 5 gold with description
/coin lose amount:2g note:tavern bill   # Subtract 2 gold with note

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).

Usage: /coin ledger count:<optional>

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 amount:<string> note:<optional>

Add coins to your character with optional description.

The amount parameter accepts coin denominations like 5g, 10s, 3c in any combination.

Examples:

/coin gain amount:10g                          # Add 10 gold
/coin gain amount:5g 20s 15c                   # Add mixed denominations
/coin gain amount:100c note:found treasure     # Add copper with description
/coin gain amount:2g 3s note:sold loot         # Mixed amounts with description

Notes: - Coin amounts use g (gold), s (silver), c (copper) suffixes - Multiple denominations can be specified in the amount field - The note is optional and stored in the transaction history

/coin lose amount:<string> note:<optional>

Subtract coins from your character with optional description.

Examples:

/coin lose amount:5g                           # Lose 5 gold
/coin lose amount:2g 10s                       # Lose gold and silver
/coin lose amount:50c note:bought supplies     # Lose copper with description
/coin lose amount:1g 50c note:room and ale     # Mixed amounts with description

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 in the amount field:

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

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 or /coin 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 and /coin 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 amount: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 amount:25g note:starting treasure
-> Thorin gained 25g for starting treasure
-> New totals: 40g 0s 0c

Adventure Loot

# Found treasure
/coin gain amount:10g 50s note:goblin cave loot
-> Thorin gained 10g 50s for goblin cave loot
-> New totals: 50g 50s 0c

# Bought supplies
/coin lose amount:5g 30s note: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 - Select which character to manage coins for
• /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.

Legacy Prefix Commands

The prefix command syntax still works but will be removed in a future update:

Legacy Syntax	Slash Equivalent
!coin show	/coin show
!coin ledger	/coin ledger
!coin gain 5g quest reward	/coin gain amount:5g note:quest reward
!coin lose 2g tavern bill	/coin lose amount:2g note:tavern bill
!coin +10g	/coin gain amount:10g
!coin -5s	/coin lose amount:5s