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

# FAQ

> Frequently asked questions about Veronica.

# Frequently Asked Questions

Find answers to common questions about Veronica's features, setup, and troubleshooting.

## General Questions

<AccordionGroup>
  <Accordion title="What is Veronica?">
    Veronica is a high-performance Discord bot built with TypeScript and discord.js. It provides comprehensive server management, moderation, economy, leveling, and entertainment features with AI-powered content filtering.
  </Accordion>

  <Accordion title="Is Veronica free to use?">
    Yes! Veronica's core features are completely free. Premium features like self-prefix, no-prefix mode, and AI command parsing are available for supporters.
  </Accordion>

  <Accordion title="How do I invite Veronica to my server?">
    Use our [invite link](https://discord.com/oauth2/authorize?client_id=YOUR_BOT_ID\&permissions=8\&scope=bot%20applications.commands) and select your server. Veronica requires Administrator permissions for full functionality.
  </Accordion>

  <Accordion title="What permissions does Veronica need?">
    Veronica requires Administrator permissions for optimal performance. At minimum, it needs: `Manage Messages`, `Moderate Members`, `Ban Members`, `Kick Members`, `Manage Roles`, `Manage Channels`.
  </Accordion>
</AccordionGroup>

## Setup & Configuration

<AccordionGroup>
  <Accordion title="How do I change the command prefix?">
    Use `/setprefix prefix:!` to change the server prefix. The default prefix is `,`.
  </Accordion>

  <Accordion title="How do I set up Auto-Moderation?">
    Run `/automod` to open the interactive control panel. Select modules to enable and configure thresholds. See our [Auto-Mod Guide](/setups/automod) for details.
  </Accordion>

  <Accordion title="How do I set up the Jail system?">
    Run `/jailsetup` to automatically create the Jailed role and #jail channel. Then use `/jail @user` to isolate problematic members. See the [Jail Guide](/setups/jail).
  </Accordion>

  <Accordion title="Can I disable certain features?">
    Yes! Most features can be disabled through the `/settings` panel or by not using them. Economy and leveling are opt-in via command usage.
  </Accordion>
</AccordionGroup>

## Features & Commands

<AccordionGroup>
  <Accordion title="How does the Global AFK system work?">
    When you set your AFK status with `/afk`, it's tracked across **all servers** where Veronica is present. When someone mentions you, Veronica notifies them of your AFK status and tracks missed mentions.
  </Accordion>

  <Accordion title="How do I earn Vero Bucks?">
    You earn Vero Bucks by:

    * Sending messages (15-25 XP per message, 60s cooldown)
    * Claiming daily rewards (`/daily`)
    * Winning gambling games
    * Participating in server events
  </Accordion>

  <Accordion title="How does the leveling system work?">
    You gain XP automatically by sending messages. XP requirements increase exponentially with each level. You can view your rank with `/rank` and compete on the `/leaderboard`.
  </Accordion>

  <Accordion title="What is the AI Filter?">
    The AI Filter uses Google's Gemini API to detect toxic, offensive, or harmful content in real-time. It can be enabled in the `/automod` panel with adjustable sensitivity.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Veronica isn't responding to commands">
    **Solutions:**

    * Verify Veronica is online (green status)
    * Check you're using the correct prefix (default: `,`)
    * Ensure Veronica has `Send Messages` permission in the channel
    * Try using slash commands: `/help`
    * Check if the bot is rate-limited or experiencing downtime
  </Accordion>

  <Accordion title="I'm getting permission errors">
    **Solutions:**

    * Ensure Veronica's role is **above** the roles it needs to manage
    * Verify Veronica has the required Discord permissions
    * Check if you have the necessary permissions to use the command
    * Ensure you're not trying to moderate someone with a higher role
  </Accordion>

  <Accordion title="Auto-Mod isn't working">
    **Solutions:**

    * Confirm modules are enabled in `/automod`
    * Check that users aren't whitelisted or have exempt roles
    * Verify Veronica has `Manage Messages` and `Moderate Members` permissions
    * Ensure the channel isn't in the exempt channels list
  </Accordion>

  <Accordion title="Jail system not working">
    **Solutions:**

    * Run `/jailsetup` to initialize the system
    * Ensure Veronica's role is above the "Jailed" role
    * Verify the #jail channel exists
    * Check that Veronica has `Manage Roles` permission
  </Accordion>

  <Accordion title="Economy/Leveling not tracking">
    **Solutions:**

    * Ensure you're not on cooldown (60s for messages)
    * Check that the channel isn't ignored for XP/economy
    * Verify you're not a bot (bots don't earn XP/currency)
    * Try using `/balance` or `/rank` to initialize your profile
  </Accordion>
</AccordionGroup>

## Premium Features

<AccordionGroup>
  <Accordion title="What are Premium features?">
    Premium features include:

    * **Self Prefix**: Set a personal prefix that works only for you
    * **No-Prefix Mode**: Use commands without any prefix
    * **AI Command Parsing**: Natural language commands (e.g., "Vero mute @user for 10m")
    * **Priority Support**: Faster response times in the support server
  </Accordion>

  <Accordion title="How do I get Premium?">
    Premium is available to supporters and contributors. Join our [Support Server](https://discord.gg/YOUR_INVITE_LINK) for more information.
  </Accordion>
</AccordionGroup>

## Technical Questions

<AccordionGroup>
  <Accordion title="What technology does Veronica use?">
    Veronica is built with:

    * **TypeScript** for type-safe code
    * **discord.js v14+** for Discord API interaction
    * **MongoDB** for data persistence
    * **Google Gemini AI** for content moderation
    * **Node.js** runtime environment
  </Accordion>

  <Accordion title="Is my data safe?">
    Yes. Veronica stores minimal data (user IDs, guild IDs, settings) required for functionality. We never store message content except for moderation logs. All data is encrypted and stored securely in MongoDB.
  </Accordion>

  <Accordion title="Can I self-host Veronica?">
    Veronica is currently not open-source. However, we're considering releasing a self-host version in the future.
  </Accordion>
</AccordionGroup>

## Still Need Help?

<CardGroup cols={2}>
  <Card title="Support Server" icon="discord" href="https://discord.gg/YOUR_INVITE_LINK">
    Join our community for live support and updates.
  </Card>

  <Card title="Documentation" icon="book" href="/overview/introduction">
    Browse comprehensive guides and tutorials.
  </Card>

  <Card title="Command List" icon="list" href="/resources/commands">
    View all available commands.
  </Card>

  <Card title="Report a Bug" icon="bug" href="https://github.com/YOUR_GITHUB_REPO/issues">
    Found a bug? Let us know!
  </Card>
</CardGroup>