====== Laelith Discord Bot Commands ======

This document provides comprehensive documentation for all available commands in the Laelith Discord bot called "Lamb".

===== Common Commands =====

==== /ai - LaelithGPT AI Assistant ====

**Description:** Talk to LaelithGPT, an AI assistant with access to Laelith world knowledge.

**Restrictions:** Can only be used in the designated AI channel.

**Options:**
  * ''question'' (required, string): Your question or prompt to LaelithGPT
  * ''sources'' (optional, boolean): List the document sources used for the answer
  * ''content'' (optional, boolean): Search in the base content (default: true)
  * ''scenario'' (optional, boolean): Search in the scenarios
  * ''secret'' (optional, boolean): Search in the secrets
  * ''refs'' (optional, boolean): List the references

**Usage Examples:**
<code>
/ai question:"What are the terraces of Laelith?"
/ai question:"Tell me about Evarilion Bombogarogan" sources:true
/ai question:"What happened to Evarilion Bombogarogan?" scenario:true
</code>

**Notes:**
  * Responses are split into chunks if they exceed Discord's message length limit
  * The bot will indicate the question (Q:) and answer (A:) format
  * Sources and references are appended if requested: (S:) and (R:)

----

==== /names - Character Name Generator ====

**Description:** Generate random character names based on various criteria.

**Options:**
  * ''species'' (optional, string): Character species (e.g., human, elf, felys, etc.)
  * ''gender'' (optional, string): Character gender (male or female)
  * ''origin'' (optional, string): Character origin (e.g., Laelith, Grand duchy of Agramor, Azilian March, etc.)
  * ''lang'' (optional, string): Language for names (''en'' or ''fr'')
  * ''count'' (optional, string): Number of names to generate

**Usage Examples:**
<code>
/names species:elf gender:female
/names origin:"Grand duchy of Agramor" count:5
/names species:human gender:male lang:fr
</code>

**Notes:**
  * All parameters are optional; the generator will work with any combination
  * Results are formatted with the criteria used for generation
  * Multiple names are displayed line by line

----

==== /translate - Laelith Glossary Translator ====

**Description:** Translate French text into English using the Laelith glossary and terminology.

**Options:**
  * ''text'' (required, string): The French text to translate into English
  * ''hints'' (optional, boolean): Give the NLP hints text

**Usage Examples:**
<code>
/translate text:"Bonjour, comment allez-vous?"
/translate text:"La terrasse de la Chaussée du lac" hints:true
</code>

**Notes:**
  * Specialized for Laelith world terminology and context
  * Shows original French (FR:) and English translation (EN:)
  * Hints provide additional NLP processing information when requested

----

==== /link - Account Linking ====

**Description:** Link your Discord account to your Laelith account.

**Options:** None

**Usage:**
<code>
/link
</code>

**Notes:**
  * Generates a unique linking code
  * Provides a private link to complete the account linking process
  * Response is ephemeral (only visible to the user)


===== Technical Commands =====

==== /ping - Connection Test ====

**Description:** Simple connectivity test command.

**Options:** None

**Usage:**
<code>
/ping
</code>

**Response:** "Pong!"

**Notes:**
  * Used to verify bot responsiveness
  * Response is ephemeral (only visible to the user)

----

==== /server - Server Information ====

**Description:** Display information about the current Discord server.

**Options:** None

**Usage:**
<code>
/server
</code>

**Response:** Shows server name and total member count

**Notes:**
  * Response is ephemeral (only visible to the user)

----

==== /user - User Information ====

**Description:** Display information about the user who invoked the command.

**Options:** None

**Usage:**
<code>
/user
</code>

**Response:** Shows user tag and user ID

**Notes:**
  * Response is ephemeral (only visible to the user)
  * Useful for debugging and user identification