Full Setup Guide

1) Discord Setup (Admin)

1. Invite the bot to your server. Administrators must run /setup to configure.
2. Run /setup and assign the Level channel and Shop channel.
3. Verify setup status is complete before testing economy or packs.
4. Only use shop commands in the configured shop channel.
5. Only use leveling commands in the configured level channel.

If setup is incomplete, several commands are intentionally blocked for safety.

2) Web Dashboard Setup

1. Login with Discord from the web login page.
2. Select your server in the sidebar and click Load Selected Server.
3. Use Main Dashboard view for channels, cards, packs, and user economy.
4. Use Bot Game Configuration view for pack size, drop rates, pity, Babanuki values, and rarity embed styles.
5. Create cards with name, rarity, image URL, and optional description.
6. Manage users economy values (level, souls, xp) in the users table.

All dashboard values are server-scoped. Editing one server does not overwrite another.

3) Pack Configuration Logic

• Single-pack mode: one active pack behaves like a unique pack flow.
• Multi-pack mode: keep at least 2 rarities to avoid invalid setup warnings.
• Shop buttons are generated from the packs saved in MongoDB for that guild.
• Pack purchase cost and image are read from each configured pack type.
• Pack size, drop thresholds, and pity are configurable in Bot Game Configuration.

4) Card and Inventory Logic

• Cards are tied to guildId, so each server has its own card pool.
• Inventory tracks copies by cardId and amount.
• Inventory view now uses slider cards, one image per unique card with quantity xN.
• Deleting a card can trigger cleanup from affected users inventories.
• Use direct image URLs (Imgur direct links recommended).

5) Babanuki Duel Config

• Both players need at least the configured minimum unique cards to draft the duel deck.
• Turn flow is button-driven, with hidden steal choices.
• When a card is stolen, name and image are shown in result embeds.
• If reward phase is ignored for 5 minutes, reward is lost and channel closes.
• Surrender penalty is 500 Souls or random-card transfer if Souls are unavailable.

6) Daily Admin Checklist

1. Check setup channels are still valid.
2. Verify packs are active and priced correctly.
3. Review card image links for broken URLs.
4. Audit suspicious economy values in user table.
5. Test one /shop purchase after major config changes.