> ## Documentation Index
> Fetch the complete documentation index at: https://veronicadocs.xo.je/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy Configuration

> Set up and customize Veronica's virtual currency and gambling systems.

# Economy Configuration

Veronica's economy system provides a robust virtual currency framework with gambling, shopping, and leaderboard features. This guide will help you configure and customize the economy for your server.

## Overview

The economy system includes:

* **Virtual Currency**: "Vero Bucks" earned through activity
* **Gambling Games**: Blackjack, Dice, Scratch Cards
* **Shop System**: Purchase roles and items
* **Leaderboards**: Track top earners

<Info>
  The economy system is **enabled by default** and works across all servers where Veronica is present.
</Info>

## Basic Commands

<CodeGroup>
  ```bash Balance theme={null}
  # Check your balance
  /balance
  ,balance

  # Check another user's balance
  /balance user:@Member
  ,balance @Member
  ```

  ```bash Daily Rewards theme={null}
  # Claim daily currency
  /daily
  ,daily
  ```

  ```bash Transfer theme={null}
  # Send money to another user
  /pay user:@Member amount:1000
  ,pay @Member 1000
  ```
</CodeGroup>

## Gambling Commands

<CardGroup cols={2}>
  <Card title="Blackjack" icon="spade">
    Classic card game against the dealer. Bet your Vero Bucks and try to reach 21.

    ```bash theme={null}
    /blackjack bet:500
    ```
  </Card>

  <Card title="Dice Roll" icon="dice">
    Roll dice and win based on the outcome. Higher rolls = bigger payouts.

    ```bash theme={null}
    /dice bet:1000
    ```
  </Card>

  <Card title="Scratch Cards" icon="ticket">
    Purchase scratch cards for a chance to win big prizes.

    ```bash theme={null}
    /scratch
    ```
  </Card>

  <Card title="Coinflip" icon="coin">
    Bet on heads or tails for a 50/50 chance to double your money.

    ```bash theme={null}
    /coinflip bet:500 choice:heads
    ```
  </Card>
</CardGroup>

## Shop System

Configure items and roles that users can purchase:

### Adding Shop Items

<Steps title="Item Creation Workflow">
  <Step title="Initialize Shop">
    Use the add command to define your items and their respective prices.

    ```bash theme={null}
    /shop add item:VIP Role price:10000 description:Get VIP perks
    ```

    <Check>Item successfully registered in the server database.</Check>
  </Step>

  <Step title="Link Roles">
    Associate items with Discord roles for automatic assignment upon purchase.
    <Check>Role mapping verified.</Check>
  </Step>

  <Step title="Test Purchase">
    Verify the shop works correctly by making a test purchase.

    ```bash theme={null}
    /shop buy item:VIP Role
    ```

    <Check>Purchase flow confirmed and roles assigned.</Check>
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Leveling Rewards" icon="award" href="/configuration/leveling">
    Combine economy with leveling for a complete RPG experience.
  </Card>

  <Card title="Permissions" icon="shield-lock" href="/configuration/permissions">
    Control who can manage economy and earn Vero Bucks.
  </Card>
</CardGroup>

## Leaderboards

View top earners and most active economy participants:

<CodeGroup>
  ```bash Server Leaderboard theme={null}
  # View top earners in current server
  /leaderboard
  ,leaderboard
  ```

  ```bash Global Leaderboard theme={null}
  # View top earners across all servers
  /globalleaderboard
  ,gleaderboard
  ```
</CodeGroup>

## Configuration Options

<AccordionGroup>
  <Accordion title="Earning Rates">
    Customize how users earn currency:

    * **Message Rewards**: 10-50 Vero Bucks per message (cooldown: 60s)
    * **Daily Rewards**: 500-1000 Vero Bucks per day
    * **Activity Bonuses**: Extra rewards for voice chat participation
  </Accordion>

  <Accordion title="Gambling Limits">
    Set minimum and maximum bet amounts:

    * **Minimum Bet**: 100 Vero Bucks
    * **Maximum Bet**: 10,000 Vero Bucks
    * **Cooldowns**: 5 seconds between games
  </Accordion>

  <Accordion title="Shop Permissions">
    Control who can purchase items:

    * **Role Requirements**: Require specific roles to access certain items
    * **Level Requirements**: Lock items behind level milestones
    * **Purchase Limits**: Set maximum purchases per user
  </Accordion>
</AccordionGroup>

<Warning>
  **Anti-Abuse:** Veronica includes built-in cooldowns and rate limiting to prevent economy exploitation.
</Warning>

## Best Practices

<CardGroup cols={2}>
  <Card title="Balanced Pricing" icon="scale-balanced">
    Set shop item prices relative to earning rates. A good rule: VIP roles should cost 7-14 days of daily rewards.
  </Card>

  <Card title="Gambling House Edge" icon="percent">
    All gambling games have a slight house edge to prevent infinite money generation.
  </Card>

  <Card title="Regular Events" icon="calendar">
    Host economy events (double XP weekends, bonus rewards) to keep engagement high.
  </Card>

  <Card title="Monitor Leaderboards" icon="chart-line">
    Check leaderboards regularly to detect potential exploits or unusual activity.
  </Card>
</CardGroup>

<Tip>
  Use `/balance top` to quickly view the richest members in your server and reward top contributors with special roles or perks.
</Tip>