Complete command guide

Updated bot documentation with real syntax, required/optional parameters, operational notes, and subcommands.

Home Getting started Support Add the bot

RequiredOptionalAdmin/mod permission

The documentation below reflects the current project state: private parties, optional voice, multi-game profiles, guild presets, and manual or automatic party cleanup.

Onboarding and profile Availability LFG and matchmaking Party Account and status

Onboarding and profile

Commands to configure profiles, preset, game catalog e initial guild setup.

/profile /preset /game-add /help /setup

Availability

Weekly slots used by the match engine to understand when you can play.

/availability /availability-list /availability-remove /availability-clear

LFG and matchmaking

Looking For Group requests, browsing, closing, and match-cycle management.

/lfg-search /lfg-browse /lfg-list /lfg-close /lfg-cancel

Party

Creation of temporary spaces, optional voice channels, and manual group closing.

/party-create /party-close /rate-party

Account and status

Diagnostic, history, premium, and basic stats commands.

/me /notify /premium /history /stats /ping

Onboarding and profile

Commands to configure profiles, preset, game catalog e initial guild setup.

`/profile`

Gestisce profiles LFG multi-game, primary game, default language/timezone/region e matchmaking per title.

Onboarding and profile

No parameters.

Examples

First quick profile

/profile set game:valorant main_role:controller region:eu languages:it,en primary:true

Practical notes

The bot can save multiple profiles for the same account, one for each game or activity.
`game` is the only required field in `/profile set`; everything else is optional.
`match_enabled` applies to that single game, quindi you can keep matchmaking enabled su un titolo and disable it for another one.
`/profile defaults` updates the personal defaults used by the bot when you do not specify lingua, timezone o regione in other commands.

Subcommands

/set — Crea o aggiorna un profile per un game specifico.

Syntax: /profile set game:<gioco> [rank] [main_role] [region] [secondary_roles] [languages] [tags] [session_types] [participation_modes] [group_size] [preset] [platform] [notes] [match_enabled] [primary]

Parameter	Type	Required	Details
`game`	string	yes	Game or activity. Use autocomplete from the dynamic catalog.
`rank`	string	no	Rank or rating, if the game uses it.
`main_role`	string	no	Main role.
`region`	string	no	Region, city, or local tag, ad esempio `eu`, `online`, `ouagadougou`.
`secondary_roles`	string (csv)	no	Secondary roles separated by commas.
`languages`	string (csv)	no	Preferred languages, ad esempio `it,en,fr`.
`tags`	string (csv)	no	Free tags for matching, ad esempio `competitive,voice,casual`.
`session_types`	string (csv)	no	Preferred session types, ad esempio `ranked,campaign,oneshot`.
`participation_modes`	string (csv)	no	Participation modes, ad esempio `online,in_person,hybrid`.
`group_size`	integer	no	Preferred typical party size. • Values: 1-12
`preset`	string	no	Quick preset to apply before manual fields.
`platform`	string	no	Platform or context, ad esempio `pc`, `ps5`, `table`, `local`.
`notes`	string	no	Short profile notes.
`match_enabled`	boolean	no	Enables or disables matchmaking for this game.
`primary`	boolean	no	Makes this profile the primary profile.

Examples

Valorant ranked

/profile set game:valorant rank:gold-1 main_role:controller secondary_roles:sentinel region:eu languages:it,en tags:competitive,voice session_types:ranked participation_modes:online group_size:5 platform:pc match_enabled:true primary:true

D&D 5e local

/profile set game:dnd-5e main_role:dm region:ouagadougou languages:fr,en tags:oneshot,5e session_types:oneshot,campaign participation_modes:in_person group_size:5 primary:true

/list — Shows all profiles saved for your account.

Syntax: /profile list

No parameters.

/remove — Removes an existing profile.

Syntax: /profile remove game:<gioco>

Parameter	Type	Required	Details
`game`	string	yes	Game of the profile to delete.

/primary — Sets which profile is the primary one.

Syntax: /profile primary game:<gioco>

Parameter	Type	Required	Details
`game`	string	yes	Game to set as primary.

/match — Turns matchmaking on or off for a specific game.

Syntax: /profile match game:<gioco> enabled:<true|false>

Parameter	Type	Required	Details
`game`	string	yes	Game to update.
`enabled`	boolean	yes	New matchmaking status.

/defaults — Updates your account's default language, timezone, and region.

Syntax: /profile defaults [language] [timezone] [region]

Parameter	Type	Required	Details
`language`	string	no	Preferred bot language. • Values: en, it, fr
`timezone`	string	no	IANA timezone, ad esempio `Europe/Rome`.
`region`	string	no	Default region or location.

`/preset`

Lists, shows, creates, or deletes presets for profiles and LFG requests. Useful for servers with recurring formats.

Onboarding and profile `create` e `delete` require Manage Server

No parameters.

Examples

Vedere preset LFG Valorant

/preset list game:valorant scope:lfg

Creare preset guild

/preset create code:valorant_ranked_eu name:"Valorant Ranked EU" description:"Stack competitivo serale" scope:both game:valorant mode:DIGITAL main_role:controller session_types:ranked participation_modes:online required_players:5 region:eu

Practical notes

Built-in presets are always readable; guild presets are added on top of them.
I subcomandi `create` e `delete` only work inside a server e solo con permesso `Manage Server`.
Many fields di `/preset create` reuse the same semantics as `/profile set` e `/lfg-search`.

Subcommands

/list — Lists presets compatible with a game and a scope.

Syntax: /preset list [game] [scope]

Parameter	Type	Required	Details
`game`	string	no	Game or activity da filtrare.
`scope`	string	no	Where you want to use the preset. • Values: profile, lfg, both

/show — Shows the details of a specific preset.

Syntax: /preset show preset:<id> [game] [scope]

Parameter	Type	Required	Details
`preset`	string	yes	Preset ID.
`game`	string	no	Game or activity del contesto.
`scope`	string	no	Usage context. • Values: profile, lfg, both

/create — Crea o aggiorna un preset personalizzato della guild.

Syntax: /preset create code:<id> name:<nome> description:<testo> scope:<profile|lfg|both> [game] [mode] [tags] [main_role] [secondary_roles] [languages] [profile_tags] [session_types] [participation_modes] [group_size] [platform] [region] [matchmaking_enabled] [primary] [profile_notes] [role_needed] [required_players] [lfg_tags] [lfg_notes]

Parameter	Type	Required	Details
`code`	string	yes	ID univoco del preset.
`name`	string	yes	Nome leggibile del preset.
`description`	string	yes	Descrizione breve mostrata in lista.
`scope`	string	yes	Dove applicare il preset. • Values: profile, lfg, both
`game`	string	no	Game or activity di riferimento.
`mode`	string	no	Categoria generale del game. • Values: DIGITAL, TABLETOP_RPG, BOARD_GAME, OFFLINE, OTHER
`tags`	string (csv)	no	Tag generali del preset.
`main_role`	string	no	Ruolo principale profile.
`secondary_roles`	string (csv)	no	Ruoli secondari profile.
`languages`	string (csv)	no	Lingue profile.
`profile_tags`	string (csv)	no	Tag profile.
`session_types`	string (csv)	no	Sessioni preferite.
`participation_modes`	string (csv)	no	Participation modes.
`group_size`	integer	no	Party tipico del profile. • Values: 1-40
`platform`	string	no	Piattaforma o supporto.
`region`	string	no	Regione o luogo.
`matchmaking_enabled`	boolean	no	Valore default per il profile.
`primary`	boolean	no	Rende il profile primario di default.
`profile_notes`	string	no	Note del profile applicate dal preset.
`role_needed`	string	no	Ruolo cercato di default per l'LFG.
`required_players`	integer	no	Numero giocatori richiesti di default. • Values: 1-40
`lfg_tags`	string (csv)	no	Session tags LFG.
`lfg_notes`	string	no	Note della request LFG.

/delete — Elimina un preset personalizzato della guild.

Syntax: /preset delete preset:<id>

Parameter	Type	Required	Details
`preset`	string	yes	ID del preset guild da rimuovere.

`/game-add`

Aggiunge o aggiorna un game/activity nel catalogo dinamico usato da autocomplete, ruoli, rank e preset.

Onboarding and profile Richiede Manage Channels

Syntax: /game-add name:<nome> [code] [mode] [roles] [ranks] [tags] [supports_presence]

Parameter	Type	Required	Details
`name`	string	yes	Nome del game o activity.
`code`	string	no	Codice slug opzionale, ad esempio `monster-hunter-wilds`.
`mode`	string	no	Categoria generale. • Values: DIGITAL, TABLETOP_RPG, BOARD_GAME, OFFLINE, OTHER
`roles`	string (csv)	no	Ruoli disponibili separati da virgola.
`ranks`	string (csv)	no	Rank disponibili separati da virgola.
`tags`	string (csv)	no	Tag utili per preset e suggerimenti.
`supports_presence`	boolean	no	Indica se il game può essere osservato via Discord Presence.

Examples

Nuovo game digitale

/game-add name:"Monster Hunter Wilds" code:monster-hunter-wilds mode:DIGITAL roles:dps,tank,healer tags:coop,boss supports_presence:true

`/help`

Mostra una guida rapida ai comandi principali e i link utili del progetto.

Onboarding and profile

Syntax: /help

No parameters.

`/setup`

Controlla configurazione base della guild: channel LFG, categoria party, ruoli premium e permessi chiave.

Onboarding and profile Richiede Manage Server

Syntax: /setup

No parameters.

Practical notes

Da lanciare appena inviti il bot nel server pilota.
Se `autoCreateThreads` è attivo, verifica anche i permessi per thread private nel channel LFG.

Availability

Weekly slots used by the match engine to understand when you can play.

`/availability`

Salva o aggiorna una fascia oraria settimanale nella timezone local dell'user, con eventuale scope su un game specifico.

Availability

Syntax: /availability weekday:<0-6> start_hour:<0-23> end_hour:<1-24> [timezone] [game]

Parameter	Type	Required	Details
`weekday`	integer	yes	Day of the week. • Values: 0 Domenica … 6 Sabato
`start_hour`	integer	yes	Ora local di inizio slot. • Values: 0-23
`end_hour`	integer	yes	Ora local di fine slot. • Values: 1-24
`timezone`	string	no	IANA timezone. Se omessa, il bot usa i default personali/local quando disponibili.
`game`	string	no	Limits the slot to a specific game.

Examples

Generic slot

/availability weekday:5 start_hour:21 end_hour:24 timezone:Europe/Rome

Slot only for Valorant

/availability weekday:6 start_hour:20 end_hour:23 timezone:Europe/Rome game:valorant

Practical notes

Lo slot viene salvato nella timezone local, ma il motore LFG normalizza internamente in UTC.
Slots with `game` set are considered only for that title.

`/availability-list`

Shows all saved slots with their `slot_id`.

Availability

Syntax: /availability-list

No parameters.

`/availability-remove`

Removes a specific slot using its identifier.

Availability

Syntax: /availability-remove slot_id:<id>

Parameter	Type	Required	Details
`slot_id`	string	yes	ID obtained from `/availability-list`.

`/availability-clear`

Clears all availability slots saved by your account.

Availability

Syntax: /availability-clear

No parameters.

LFG and matchmaking

Looking For Group requests, browsing, closing, and match-cycle management.

`/lfg-search`

Creates a Looking For Group request, starts matchmaking, sends invites, and automatically creates the party when the group is full.

LFG and matchmaking

Syntax: /lfg-search game:<gioco> [hour] [role_needed] [region] [weekday] [timezone] [required_players] [preset] [rank_min] [rank_max] [session_type] [participation_mode] [tags] [title] [notes] [voice_channel] [force_new] [premium_only]

Parameter	Type	Required	Details
`game`	string	yes	Game or activity for which you want to create the request.
`hour`	integer	no	Ora local 0-23. If omitted, the request becomes flexible/immediate. • Values: 0-23
`role_needed`	string	no	Role you are looking for, if the game supports it.
`region`	string	no	Region, city, or location tag. If omitted, it tries to use profile defaults.
`weekday`	integer	no	Giorno local della sessione. • Values: 0 Domenica … 6 Sabato
`timezone`	string	no	IANA timezone della request. • Default: Default user o local Discord quando disponibile
`required_players`	integer	no	Number of required players. • Values: 1-8
`preset`	string	no	Quick LFG preset applied before manual fields.
`rank_min`	string	no	Minimum allowed rank.
`rank_max`	string	no	Maximum allowed rank.
`session_type`	string	no	Session type, ad esempio `ranked`, `campaign`, `oneshot`.
`participation_mode`	string	no	Participation modes, ad esempio `online`, `in_person`, `hybrid`.
`tags`	string (csv)	no	Session tags come `oneshot`, `commander`, `lan`, `beginner_friendly`.
`title`	string	no	Readable title for the party thread/channel.
`notes`	string	no	Short notes visible in the party summary.
`voice_channel`	boolean	no	Also creates a private voice channel when the party is formed.
`force_new`	boolean	no	Forza una nuova request anche se esistono già requests compatibili aperte.
`premium_only`	boolean	no	Limits the request to premium profiles.

Examples

Valorant ranked evening

/lfg-search game:valorant hour:21 weekday:6 timezone:Europe/Rome required_players:5 role_needed:controller region:eu session_type:ranked participation_mode:online tags:competitive,voice title:"Valorant Ranked Gold EU" voice_channel:true

Immediate flexible request

/lfg-search game:monster-hunter-wilds region:eu required_players:3 tags:coop,boss title:"MH Wilds adesso"

Practical notes

If a configured LFG channel exists in the guild, the command must be run there.
Invites are sent via DM when possible, with server fallback based on guild configuration.
Prima di creare una nuova request, `/lfg-search` controlla se esistono già requests compatibili aperte e propone di unirsi a quelle per ridurre i duplicati. Usa `force_new:true` solo se vuoi davvero una request separata.
When the group is full il bot prova prima a creare un thread private; se non può, crea un channel testuale private. In both cases, the space is intended only for party members.
Se `voice_channel:true`, also creates a private voice channel in the party category.

`/lfg-browse`

Shows the best open LFG requests and lets you apply to one of them.

LFG and matchmaking

Syntax: /lfg-browse game:<gioco> [role_needed] [region] [session_type] [participation_mode]

Parameter	Type	Required	Details
`game`	string	yes	Game or activity to search for.
`role_needed`	string	no	Filters by required role.
`region`	string	no	Filters by region or location.
`session_type`	string	no	Filters by session type.
`participation_mode`	string	no	Filters by participation mode.

Examples

Richieste Valorant ranked

/lfg-browse game:valorant session_type:ranked region:eu

`/lfg-list`

Lists your recent requests with status, accepted candidates, and useful identifiers.

LFG and matchmaking

Syntax: /lfg-list

No parameters.

Practical notes

Use this command to retrieve `request_id` to pass to `/lfg-close` o `/lfg-cancel`.

`/lfg-close`

Closes an open request and stops sending new invites.

LFG and matchmaking

Syntax: /lfg-close [request_id]

Parameter	Type	Required	Details
`request_id`	string	no	ID of the request to close. If omitted, the bot tries to close the creator's first open request in the server.

`/lfg-cancel`

Cancels an open request and discards pending invites.

LFG and matchmaking

Syntax: /lfg-cancel [request_id]

Parameter	Type	Required	Details
`request_id`	string	no	ID of the request to cancel. If omitted, the bot tries to use the creator's first open request in the server.

Party

Creation of temporary spaces, optional voice channels, and manual group closing.

`/party-create`

Manually creates a private party with a dedicated text channel and an optional voice channel.

Party

Syntax: /party-create game:<gioco> members:<id1,id2,...> [title] [voice_channel]

Parameter	Type	Required	Details
`game`	string	yes	Game or activity del party.
`members`	string (csv)	yes	List of Discord user IDs separated by commas. The creator is added automatically.
`title`	string	no	Readable title for the party.
`voice_channel`	boolean	no	Also creates a private voice channel.

Examples

Manual party with voice

/party-create game:valorant members:123456789012345678,234567890123456789 title:"Stack ranked serale" voice_channel:true

Practical notes

Unlike parties created by `/lfg-search`, qui a private text channel is created directly, not a thread.
Il party still has an automatic backend expiration if it is not closed manually.

`/party-close`

Closes an active party, removes linked temporary spaces, and also closes the voice channel if present.

Party Può farlo il creatore del party oppure un moderatore con Manage Channels

Syntax: /party-close [party_id]

Parameter	Type	Required	Details
`party_id`	string	no	ID del party. Se omesso e il comando è lanciato dentro il thread/channel del party, il bot prova a risolverlo da lì.

Practical notes

Se esegui il comando dentro il channel del party, spesso non serve specificare l'ID.
I channels vocali temporanei associati vengono ripuliti automaticamente in closing.

`/rate-party`

Valuta un altro membro del party con punteggio da 1 a 5 e commento opzionale.

Party

Syntax: /rate-party party_id:<id> user:<@utente> rating:<1-5> [comment]

Parameter	Type	Required	Details
`party_id`	string	yes	ID del party da valutare.
`user`	user	yes	Utente da valutare.
`rating`	integer	yes	Punteggio assegnato. • Values: 1-5
`comment`	string	no	Commento opzionale.

Account and status

Diagnostic, history, premium, and basic stats commands.

`/me`

Riepilogo rapido di profiles, disponibilità e stato notifiche del tuo account.

Account and status

Syntax: /me

No parameters.

`/notify`

Attiva o disattiva le notifiche LFG sul tuo account.

Account and status

Syntax: /notify enabled:<true|false>

Parameter	Type	Required	Details
`enabled`	boolean	yes	Stato desiderato delle notifiche.

`/premium`

Mostra lo stato premium calcolato in base ai ruoli premium configurati nella guild.

Account and status

Syntax: /premium

No parameters.

`/history`

Cronologia di compatibilità con gli ultimi compagni di game registrati.

Account and status

Syntax: /history

No parameters.

`/stats`

Statistiche base del bot sul server corrente.

Account and status

Syntax: /stats

No parameters.

`/ping`

Verifica immediata che il bot sia online e risponda ai comandi.

Account and status

Syntax: /ping

No parameters.

Recommended flow for new testers

Invita il bot nel server con scope `bot` + `applications.commands`.
Prova subito `/help` o `/ping` per verificare che i comandi slash siano visibili e il bot risponda.
Per gli admin: esegui subito `/setup` per controllare channel LFG, categoria party, ruoli premium e permessi.
Crea almeno un profile con `/profile set` oppure usa `/preset list` per partire più veloce.
Salva almeno uno slot con `/availability` e verifica il riepilogo con `/me`.
Prova `/lfg-search` con un secondo user reale: se trova una request compatibile già aperta ti proporrà di unirti; usa `/lfg-browse` per sfogliare manualmente le requests aperte.
When the group is full, entra nello spazio private creato dal bot e chiudilo con `/party-close` a fine test.