Getting started

Recommended path to test the bot with a few real users and verify threads, parties, and voice.

1. Invite and verify

  • Apri il link di invito e scegli il server Discord corretto.
  • Autorizza il bot e assicurati che lo scope `applications.commands` sia incluso.
  • Verifica che il bot sia online e prova subito `/ping`.
  • Se il bot deve essere usato fuori dalla guild di test o vuoi pubblicarlo su directory come Top.gg, usa slash command globali con `npm run deploy:commands:global` oppure `DISCORD_COMMAND_SCOPE=global`.
  • Se i comandi non compaiono, rilancia `npm run deploy:commands` oppure attendi la propagazione Discord.
  • Per ricevere inviti private, abilita i DM dal server oppure prepara un channel LFG dedicato come fallback.

2. Configure the guild

  • As an admin, run /setup and fix any warnings.
  • If you want automatic private threads, configure a text LFG channel with the right permissions.
  • If you want temporary channels in a dedicated category, configure the party category.

3. Prepare the testers

  • Each tester saves at least one profile with /profile set.
  • Each tester saves at least one availability slot with /availability.
  • Check the summary with /me and enable DMs if you want to test private invites.

Minimum 2-account scenario

  • Account A crea un profile con `/profile set` e almeno uno slot con `/availability`.
  • Account B fa la stessa cosa con lo stesso game e una disponibilità compatibile.
  • Account A lancia `/lfg-search` con `title` e, se vuoi testare il voice, `voice_channel:true`.
  • Se esiste già una request compatibile aperta, il bot proporrà di unirsi a quella invece di crearne una duplicata; usa `force_new:true` solo per testare il ramo di creazione forzata.
  • Account B riceve la DM o usa `/lfg-browse` per candidarsi; quando accetta, verifica che il party venga creato.
  • Entrambi gli account controllano visibilità del thread/channel e del voice, poi chiudono con `/party-close`.

Beta checklist

  • Invita il bot in un solo server pilota prima del rollout più ampio.
  • Conferma che i tester abbiano i DM attivi oppure definisci un channel LFG dedicato.
  • Controlla i permessi per channels, thread, cronologia e categoria party.
  • Esegui `/ping`, `/profile set`, `/availability` e `/lfg-search` con almeno due users reali.
  • Tieni aperti i log del bot, del web server e del worker cleanup durante i primi test live.

Common mistakes to avoid

After the first successful test

Open Top.gg