> For the complete documentation index, see [llms.txt](https://wanitools.gitbook.io/wani-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wanitools.gitbook.io/wani-docs/boost-bot-v2/setup-guide.md).

# Setup Guide

## Setup Guide

Step-by-step instructions to get everything running. For a full field-by-field explanation of every option, see **Configuration** — this page focuses on **what to do**, not what each key means.

Your package contains only three things:

```
AdvancedBoostBotV2.exe
Config.yaml    
Data/
```

***

### Requirements

Before continuing, make sure you have:

* **License key** — provided with your purchase.
* **A Discord bot token** — create one at [discord.com/developers/applications](https://discord.com/developers/applications).
* **Nitro tokens** in `Data/1 Month Tokens.txt` or `Data/3 Month Tokens.txt` (one per line).
* **Proxies** (recommended, **required for captcha solving**) in `Data/Proxies.txt`.

***

### Initial Setup

1. Extract the bot files and open **`Config.yaml`**.
2. Fill in your **`License`** key.
3. Set your **`DiscordSettings.BotToken`** (bot token from the Developer Portal).
4. Add your Discord user ID to **`DiscordSettings.Owners`**.
5. Run the bot — it will auto-register all slash commands on startup.

> Make sure your bot has been invited to your Discord server with the `applications.commands` scope before starting.

***

### AutoBuy Setup

There are **2 ways** to set up products — a command, or manually.

#### Option A — Command (fastest)

Run one command per product. Works on all supported platforms.

* **`/create-boost-product`** `amount:` int `duration:` 1 Month / 3 Months `price:` number `watermark:` true/false
* **`/create-token-product`** `duration:` 1 Month / 3 Months `price:` number *(sells raw tokens)*

The bot creates the product, sets the dynamic delivery URL, and adds the invite/watermark fields for you.

#### Option B — Manual (on your store)

1. Create the product on your site. **Title format must be** `{Boost Amount} Boosts | {length} Month` — e.g. **`14 Boosts | 3 Month`** for 14 boosts, 3 months.
2. Set the product **delivery type to Dynamic**.
3. Copy the **dynamic URL** printed in the bot console and paste it into the product's dynamic URL field, then save.
4. Add a **custom field** on the product, named exactly like `InviteFieldName` in config (default `Invite Link:`). Set its input type to **text**.
5. (Optional) To let customers watermark, add more custom fields matching the names under `Customerization` (e.g. `Display Name:`, `Bio:` …).

#### Configuration

Find your **API key** on your platform (usually under store settings / security) and your **shop name**, then fill in `AutoBuySettings`:

```yaml
AutoBuySettings:
  Enabled: true
  Site: "sellauth"           # [shoppex, sellapp, sellauth, komerza]
  ShopName: "Your_Shop_Name"
  APIKey: "YOUR_API_KEY"
  InviteFieldName: "Invite Link:"
  StoreId: ""                # Komerza only
```

> **First-time SellAuth users:** create a test order, then restart the bot once so it can auto-fetch your webhook secret.

On startup the bot pings your store to verify the key — a wrong key stops startup with `[AutoBuy] Invalid API Key`. See **Configuration** for SharedStock, AutoHold, Customerization and CustomMessage.

***

### OAuth Setup

Boost via OAuth2 (no invite link) and enable OAuth boosting on the redeem panel. There are **2 ways** to run the redirect — pick one.

**First (both ways):** go to [discord.com/developers/applications](https://discord.com/developers/applications/), select your bot, open **OAuth2**, and copy your **Client ID** + **Client Secret** into config.

#### Option A — Via API (recommended)

Uses the panel-hosted redirect — stable and works out of the box with the tunnel.

1. Set `OAuthViaAPI: true`.
2. On startup the bot prints the redirect:

   ```
   [WebSocket] Listening To OAuth -> https://api.woojiee.lol/boostbot/client/<BOT_ID>/oauth2
   ```
3. Add that exact URL under **OAuth2 → Redirects**. It uses your **Bot ID** (stable), so you add it once.

```yaml
OAuthSettings:
  OAuthViaAPI: true
  OAuthViaLocal:
    Enabled: false
    Port: 8081
  ClientID: "YOUR_CLIENT_ID"        # quotes optional
  ClientSecret: "YOUR_CLIENT_SECRET"
```

#### Option B — Via Local

Uses a local redirect on your own machine (a port you choose) instead of the panel.

1. Set `AuthViaLocal.Enabled: true` and a `Port` (default `8081`).
2. On startup the bot prints the redirect:

   ```
   [WebSocket] Listening To OAuth -> http://localhost:8081/oauth2
   ```
3. Add that exact URL under **OAuth2 → Redirects**.

```yaml
OAuthSettings:
  OAuthViaAPI: false
  OAuthViaLocal:
    Enabled: true
    Port: 8081
  ClientID: "YOUR_CLIENT_ID"        # quotes optional
  ClientSecret: "YOUR_CLIENT_SECRET"
```

> You can enable **both** — the bot logs and accepts both redirects. Just register whichever URL(s) you actually use on the Developer Portal.

***

### Redeem Panel Setup

Let customers redeem keys and boost from a website.

1. Enable it under `WebSiteSettings.RedeemPanelSettings` (set `Enabled: true` and `RedeemPanelSite.Enabled: true`).
2. Choose the allowed boost methods (`AllowOAuthBoosting`, `AllowInviteBoosting`).
3. (Optional) Let customers watermark by toggling fields under `WatermarkCustomization`.
4. Set your branding under `PanelCustomization` (colour, logo, discord, site).
5. Create keys with `/create-redeem-key`, `/mass-key`, or `/send-redeem-key`.
6. Share the panel link — printed on startup, or via **`/redeem-access-panel`** (owner-only).

***

### Live Stock Setup

Two independent things:

**Discord message** — set the channel + refresh under `DiscordSettings.LogsSettings.LiveStock` (`Enabled: true`, `ChannelID`, `Delay`). The message carries a **Live Stock Page** button.

**Public website** — set `WebSiteSettings.LiveStockSettings.Enabled: true` and your branding under its `PanelCustomization`. The link is printed on startup.

***

### Orders Setup

1. Set `WebSiteSettings.OrdersSettings.Enabled: true` and your branding under `PanelCustomization`.
2. Every order is saved and gets a status page at `…/boostbotv2/orders/<bot-id>/<order-id>`.
3. Look up any order in Discord with **`/fetch-order`** (download JSON / copy tokens).

***

### Token Checker Setup

Keeps dead tokens out of your stock.

1. Configure under `TokenChecker` — pick when it runs (`Startup`, `Restock`, or scheduled `Custom`) and which checks to apply under `Options` (`Invalid`, `Locked`, `Flagged`, `NoNitro`, `NoBoosts`).
2. Run it any time in Discord with **`/token-checker`**.
3. Removed tokens are sorted into `Data/Checker Output/` by reason.

***

### Adding Stock

Two ways to add Nitro tokens:

1. **Directly** — paste tokens (one per line) into `Data/1 Month Tokens.txt` / `Data/3 Month Tokens.txt`.
2. **From Discord** — **`/restock`** with a file upload, a **paste.ee** code, or a **WPaste** code.

Accepted formats: `token`, `email:pass:token`, `user:pass:token`. Send tokens to a user with **`/send-stock`**.

***

### Proxy Setup

1. Add proxies to `Data/Proxies.txt`, one per line:

   ```
   host:port
   host:port:user:pass
   user:pass@host:port
   http://user:pass@host:port
   ```
2. Set **`UseProxies: true`** in config (`false` = proxyless).

> Captcha solving **always** needs proxies, even when `UseProxies` is false.

***

*Need help? Join the* [*support server*](https://discord.waniboostz.cc)*. Full option reference: Configuration.*