Skip to main content
User commands are available to all server members without special permissions. These commands provide basic functionality and information access.

​
Help Command

Display available commands and documentation. 
$help [category]
​
category
string
The help category to display: user, admin, or personas

​
Examples

$help

​
Response Format

When called without arguments, shows available categories: 
**OPCIONES DE AYUDA:**

`$help user` - Ver comandos de usuario
`$help admin` - Ver comandos de administrador (if admin)
Source: main.py:429-467

​
Test Spam Command

Send a test message to the spam channel to verify the spam system is working. 
$testspam

​
Behavior

  1. Checks if spam messages are configured
  2. Retrieves a random message from the pool
  3. Sends the message to the spam channel (ID: 1004171793101230151)
  4. Confirms delivery in the current channel

​
Example Output

Mensaje de prueba enviado a #spam-channel

​
Error Cases

If no spam messages are configured in the code:
**ERROR:** No hay mensajes configurados. Agrega mensajes a la lista en el código primero.
If the spam channel cannot be found:
No se encontró el canal de spam.
Source: main.py:469-483

​
Spam Status Command

View the current status of the automated spam system. 
$statusspam

​
Information Displayed

​
Estado
string
Current state: ACTIVO or INACTIVO
​
Mensajes configurados
number
Total number of spam messages in the pool
​
Mensajes restantes en ciclo
number
Messages remaining before the pool resets
​
Frecuencia
string
How often messages are sent (every 12 hours)
​
Canal
channel
The spam channel where messages are posted

​
Example Output

**Estado del Sistema de Spam:**
**ACTIVO**
Mensajes configurados: 25
Mensajes restantes en ciclo: 12
Frecuencia: Cada 12 horas
Canal: #spam-channel
Source: main.py:511-525

​
Permissions Command

View detailed permissions for the bot in the current server and channel. 
$permisos

​
Permissions Checked

The command checks the following important permissions:
  • Administrator
  • Manage Messages
  • Moderate Members (Timeout)
  • Kick Members
  • Ban Members
  • Manage Roles
  • Manage Channels
  • Use Application Commands
  • Mention @everyone
  • Manage Webhooks
  • View Channel
  • Send Messages
  • Read Message History
  • Add Reactions
  • Manage Messages
  • All other server-level permissions in context of the current channel

​
Example Output

**permisos en el servidor:**
✅ Administrador
✅ Gestionar mensajes
✅ Silenciar miembros
❌ Expulsar miembros
✅ Gestionar roles
...

**permisos en #general:**
✅ Ver canal
✅ Enviar mensajes
✅ Leer historial
...

​
Technical Details

The command uses Discord.py’s permission system: 
permisos_servidor = ctx.guild.me.guild_permissions
permisos_canal = ctx.channel.permissions_for(ctx.guild.me)
If the output exceeds Discord’s 2000 character limit, it’s automatically split into two messages. Source: main.py:557-606

​
Persona Commands

Dynamic commands that return predefined responses about server members.

​
Available Personas

$dios
# Response: "DiosGodCoperPedraza lo mejor del mundo, alabado seas"

​
How It Works

Persona commands are dynamically generated from the respuestas['personas'] dictionary: 
def crear_comando_persona(nombre):
    async def comando(ctx):
        await ctx.send(respuestas['personas'][nombre])
    return comando

# Auto-register all persona commands
for nombre in respuestas['personas'].keys():
    bot.command(name=nombre)(crear_comando_persona(nombre))
Source: main.py:144-152 (responses), main.py:609-616 (registration)

​
Adding New Personas

To add a new persona command, add an entry to the respuestas['personas'] dictionary in main.py: 
'personas': {
    'newperson': 'Your custom response here',
    # ... existing personas
}
The command will be automatically registered when the bot starts.

​
Command Availability

All user commands are available in every channel except during spam detection events.
The bot processes commands at the end of the message handler to ensure spam detection and AI responses are evaluated first.
Command processing: main.py:767

​
Next Steps

Admin Commands

Learn about administrator-only commands

AI Commands

Explore natural language AI commands

Build docs developers (and LLMs) love

Get started for freeTalk to us