Referencia de comandos

Cada tabla que creas tiene su propio comando de barra, con el nombre de la tabla y estos subcomandos. Sustituye <table> por el nombre del comando de tu tabla, por ejemplo /inventory.

Referencia rápida

/<table> addEscritura
/<table> queryLectura
/<table> updateEscritura
/<table> deleteAdmin
/<table> viewLectura
/<table> leaderboardLectura
/<table> saved-viewLectura
/<table> bulk-updateAdmin
/<table> bulk-deleteAdmin

/<table> add

Escritura

Añade una fila nueva. Cada tabla tiene su propio comando con el nombre de la tabla, y cada columna se convierte en una opción. Las columnas obligatorias aparecen primero y hay que rellenarlas; las opcionales se pueden omitir.

Sintaxis

/<table> add <column>:<value> <column>:<value> ...

Ejemplo

/inventory add item:Diamond Sword quantity:3 rarity:Epic
  • •El usuario de Discord que ejecutó el comando se guarda con la fila.
  • •El bot responde con una confirmación y los valores guardados.
  • •Cada plan tiene un límite de filas por tabla (100 en Free). El bot te avisa cuando una tabla está llena.

/<table> query

Lectura

Busca en una tabla. Cada columna es un filtro opcional; si no usas ninguno, se listan las filas.

Sintaxis

/<table> query [<column>:<value> ...] [limit:<1-25>]

Ejemplo

/inventory query rarity:Epic limit:10
  • •Las columnas de texto coinciden cuando el valor contiene lo que escribiste. Los demás tipos de columna deben coincidir exactamente.
  • •Muestra 10 resultados por defecto, hasta 25.

/<table> update

Escritura

Cambia una fila existente. Elige la fila en la lista de autocompletado y luego indica solo las columnas que quieres cambiar.

Sintaxis

/<table> update row:<row> <column>:<new_value> ...

Ejemplo

/inventory update row:Health Potion quantity:9
  • •Las columnas que no indiques conservan su valor actual.
  • •En tablas con columnas de número, la opción _mode decide si los números se establecen, se suman o se restan.

/<table> delete

Admin

Elimina una sola fila. Antes, el bot te pide que confirmes con un botón.

Sintaxis

/<table> delete row:<row>

Ejemplo

/inventory delete row:Rope
  • •Las filas eliminadas desaparecen de la tabla al instante y se borran de forma permanente pasados 30 días.

/<table> view

Lectura

Muestra todas las columnas de una fila en un solo embed.

Sintaxis

/<table> view row:<row>

Ejemplo

/inventory view row:Diamond Sword
  • •También muestra quién creó la fila, cuándo se creó y cuándo se actualizó por última vez.

/<table> leaderboard

Lectura

Clasifica las filas por una columna de número, de mayor a menor. Los tres primeros reciben medalla.

Sintaxis

/<table> leaderboard column:<number_column> [limit:<1-25>]

Ejemplo

/xp leaderboard column:XP limit:10
  • •Solo se añade a tablas con al menos una columna de número.
  • •Muestra 10 puestos por defecto, hasta 25.
  • •Cada puntuación aparece junto a la primera columna de texto o de miembro de la fila.

/<table> saved-view

Lectura

Ejecuta una vista guardada que configuraste para la tabla en el panel.

Sintaxis

/<table> saved-view name:<view> [limit:<1-25>]

Ejemplo

/inventory saved-view name:Epic items
  • •Solo se añade a tablas con al menos una vista guardada.

/<table> bulk-update

Admin

Cambia una columna en todas las filas donde otra columna coincide con un valor. Solo en los planes Pro y Max.

Sintaxis

/<table> bulk-update filter:<column> value:<match> set-column:<column> set-value:<new_value>

Ejemplo

/inventory bulk-update filter:item value:Rope set-column:rarity set-value:Common
  • •El bot muestra cuántas filas coinciden y te pide confirmación antes de cambiar nada.

/<table> bulk-delete

Admin

Elimina todas las filas donde una columna coincide con un valor. Solo en los planes Pro y Max.

Sintaxis

/<table> bulk-delete filter:<column> value:<match>

Ejemplo

/inventory bulk-delete filter:rarity value:Common
  • •El bot muestra cuántas filas coinciden y te pide confirmación antes de eliminar.

Comportamiento general de los comandos

  • Errores efímeros: los errores de permisos y de validación solo los ve quien ejecutó el comando (mensajes efímeros), así los canales quedan limpios.
  • Autocompletado: las columnas de opción muestran sus opciones como una lista para elegir. Las opciones de fila y de vista guardada sugieren coincidencias mientras escribes.
  • Límites de uso: los comandos están limitados a 5 por usuario cada 10 segundos para evitar abusos. Es muy por encima del uso normal.
  • Embeds: todas las respuestas usan embeds de Discord con un formato limpio. Los datos se muestran en tablas o en pares clave-valor según el comando.
  • Permisos: mientras no asignes roles a una tabla, cualquier miembro puede ejecutar todos sus comandos. Cuando los asignas, solo los miembros con alguno de esos roles pueden usar la tabla: Lectura permite query, view, leaderboard y saved-view; Escritura añade add y update; Admin añade delete y los comandos masivos. Los administradores de Discord siempre pueden ejecutarlo todo.
  • Comandos globales: /help muestra las tablas de tu servidor, /ping comprueba que el bot está en línea y /delete-my-data elimina las filas que creaste en todos los servidores.