Empieza aquí
Primeros pasos
Instalarlo toma un minuto. Necesitas el permiso Gestionar servidor en el servidor al que lo añades.
- 1 Añade Guaca Invítalo y deja todos los permisos.
- 2 Sube su rol Encima de cada rol que entrega.
- 3 Qué recibes Valores por defecto, una tienda inicial, nada ruidoso.
- 4 Tu primera hora Ocho cosas que vale la pena configurar.
1. Añade Guaca a tu servidor
Pulsa el botón, elige tu servidor y deja marcados todos los permisos. Discord registra los comandos de barra al mismo tiempo.
Los permisos que pide
Guaca nunca pide Administrador. Cada permiso corresponde a algo que hace:
| Permiso | Para qué |
|---|---|
| Ver canales | Para ver los canales donde responde y vigila. |
| Enviar mensajes | Bienvenidas, subidas de nivel, sorteos, starboard, anuncios. |
| Insertar enlaces | Respuestas enriquecidas y botones con enlace. |
| Adjuntar archivos | Las cartas, las tarjetas de granja y los banners de bienvenida y anuncios son imágenes adjuntas. |
| Leer el historial de mensajes | La purga, y el starboard releyendo un mensaje para contar sus reacciones. |
| Mencionar @everyone, @here y todos los roles | Solo para los anuncios que configures para avisar a @everyone, @here o a un rol. |
| Usar emojis externos | Emojis personalizados en las respuestas, como los símbolos de tragamonedas que elige el servidor. |
| Añadir reacciones | Reacciones automáticas en los canales que elijas. |
| Conectar | El XP de voz cuenta minutos en un canal. Nunca habla. |
| Gestionar roles | Los objetos de la tienda, las recompensas de nivel, los colores, los menús de roles y los roles de torneo otorgan roles. |
| Gestionar mensajes | La purga, y el automod borrando un mensaje que detectó. |
| Aislar temporalmente a miembros | Los silencios, la acción de moderación real menos destructiva. |
| Expulsar miembros | /expulsar, y la escalada del automod configurada para expulsar. |
| Banear miembros | /banear y /desbanear, y la escalada del automod configurada para banear. |
2. Sube el rol de Guaca
Discord solo deja que un bot dé, quite o modere roles por debajo del suyo. En Ajustes del servidor → Roles, arrastra el rol de Guaca por encima de:
- cada rol que entregue un objeto de la tienda, una recompensa de nivel, un color, un menú de roles o un torneo;
- el rol más alto de cualquiera a quien los moderadores deban poder advertir, silenciar, expulsar o banear con Guaca.
Los comandos de moderación y los menús de roles lo comprueban y te avisan cuando un rol está fuera de alcance. Si Discord rechaza un rol comprado en la tienda, Guaca lo intenta unas cuantas veces más, así que subir el rol poco después todavía lo entrega.
Los permisos de canal también cuentan. Donde Guaca deba publicar necesita Enviar mensajes e Insertar enlaces; Adjuntar archivos para banners y tarjetas; Leer el historial de mensajes en los canales que vigila el starboard; Añadir reacciones donde configures reacciones automáticas.
Ajustes del servidor → Roles
- Admin encima de Guaca: no puede tocar este rol
- Guaca APP el rol de Guaca
- Miembros gente a la que Guaca puede silenciar o banear
- Verde Aguacate un objeto de la tienda
- Veterano recompensa del nivel 10
- Jugadores un botón del menú de roles
- @everyone
3. Qué pasa cuando entra
- No publica nada. Tu servidor recibe los ajustes por defecto, y todo módulo ruidoso empieza apagado.
- Cada miembro empieza con 500 en el banco la primera vez que lo usa (Panel → Servidor → saldo inicial).
- La tienda recibe dos objetos iniciales: un Protector de Racha (3.000) que salva un
/diarioperdido, y una Ficha Extra (400) que limpia tus enfriamientos de juegos al usarla con/usar. Puedes renombrarlos, cambiarles el precio o borrarlos. - Los juegos, los comandos de ingresos y los niveles están encendidos; el automod tiene filtros preparados pero está apagado.
4. Tu primera hora
- Elige los canales de economía.
/configurar canal-agregar #canalpara cada uno, o Panel → Servidor. Mientras no añadas ninguno, los comandos de economía y los juegos funcionan en todos los canales. Qué comandos abarca. - Configura el reloj del servidor. Panel → Servidor → zona horaria. Decide cuándo se reinicia
/diario, qué día cae un cumpleaños, cuándo cambia el día de las granjas y las horas que escribes para los anuncios. - Elige un canal de registro de moderación.
/configurar registro #canal. Cada caso de moderación se publica ahí. - Da la bienvenida.
/configurar bienvenida #canal, o Panel → Moderación para la imagen de bienvenida. - Llena la tienda. Panel → Objetos. Ya hay dos objetos iniciales. Cómo funcionan los objetos.
- Añade recompensas de nivel y un canal de avisos. Panel → Niveles. Cómo funcionan los niveles.
- Enciende el automod.
/automod encender, y luego/automod verpara revisar los filtros. Qué detecta cada filtro. - Extras opcionales: el starboard (
/configurar starboard), los cumpleaños (/configurar canal-cumpleanos), el XP de voz y el dinero por chatear (Panel → Niveles), y las granjas.
El panel
Entra con Discord en bot.aguacatech.io/dashboard. Verás cada servidor donde eres dueño o tienes Gestionar servidor, y Guaca es miembro.
- El acceso se calcula al entrar. Si alguien gana o pierde Gestionar servidor, debe salir y volver a entrar para que el panel lo note.
- Sacar a Guaca de un servidor cierra su panel para todos. Los datos se conservan: vuelve a añadir a Guaca y entra de nuevo para seguir donde lo dejaste.
Quién puede usar cada comando
Cada comando trae un permiso de Discord por defecto: /banear requiere Banear miembros, /configurar requiere Gestionar servidor, /saldo no requiere nada. La referencia de comandos los lista todos.
Para cambiar quién ve un comando, o en qué canales, usa Ajustes del servidor → Integraciones → Guaca. Ese es todo el sistema de permisos: Guaca no mantiene otro propio. La única excepción es /torneo, cuyos subcomandos de organizador comprueban Gestionar servidor o Administrador por sí mismos.
Solución de problemas
“Ese comando solo funciona en #canal”
El servidor tiene una lista de canales de economía, y la respuesta nombra esos canales. Usa el comando en uno de ellos. Los admins pueden revisar la lista con /configurar canales.
No se entregó un rol
Casi siempre es el orden de roles: el rol está por encima del de Guaca. Sube el rol de Guaca. Comprueba también que no sea un rol que Discord gestiona, como el de booster o el de otro bot.
Falta un comando en el selector
Discord oculta los comandos para los que no tienes permiso. Revisa Ajustes del servidor → Integraciones → Guaca por si hay restricciones para tu rol o el canal. Un bot recién añadido también puede necesitar reiniciar la app (Ctrl+R) antes de que aparezcan sus comandos.
Un anuncio no avisó a nadie
Guaca necesita Mencionar @everyone, @here y todos los roles en ese canal. /anuncio lista muestra los anuncios que fallaron y por qué.
El automod no hace nada
Empieza apagado: usa /automod encender. Además ignora los canales y roles exentos (Panel → Moderación), y necesita Gestionar mensajes para borrar lo que detecta.