Guía de uso e
integración en tu servidor.
Aprende a incorporar a Hoshiko paso a paso, otorgar los permisos necesarios y configurar cada módulo de forma armoniosa.
Añade a Hoshiko a tu comunidad
Para que Hoshiko pueda interactuar, renderizar tarjetas Canvas y moderar el chat, solicita exclusivamente los permisos recomendados en el enlace de invitación.
Permisos requeridos por el bot
Hoshiko opera con permisos granulares estándar definidos en su integración OAuth2 (bot y applications.commands):
ViewChannelRequerido para escuchar eventos, moderar y responder a interacciones en canales autorizados.
SendMessagesPermite entregar respuestas, avisos de nivel, notificaciones y paneles informativos.
EmbedLinksNecesario para mostrar respuestas enriquecidas, tarjetas estéticas y registros de auditoría.
AttachFilesIndispensable para generar y renderizar tarjetas Canvas (rango, XP, confesiones y bienvenida).
ReadMessageHistoryPermite validar contexto reciente en comandos de utilidad y filtros de moderación.
ManageMessagesUtilizado por herramientas disciplinarias como /purge para limpiar mensajes no deseados.
ManageRolesNecesario para asignar roles de nivel (/level-roles), roles de estado y sanciones por rol.
ModerateMembersAplica aislamientos temporales (timeout nativo de Discord) con /tempmute y /mute.
KickMembersPermite ejecutar expulsiones disciplinarias con /kick cuando sea requerido.
BanMembersPermite aplicar bloqueos preventivos (/ban, /tempban, /softban, /massban).
ViewAuditLogFacilita la trazabilidad de eventos y sincronización de registros de moderación.
UseExternalEmojisMejora la legibilidad de la interfaz visual con la paleta de iconos oficiales de Hoshiko.
Primeros pasos y configuración inicial
Sigue esta secuencia para dejar el servidor listo en pocos minutos utilizando los comandos de configuración de Hoshiko.
1. Invita a Hoshiko con los permisos adecuados
Utiliza el enlace oficial con los permisos recomendados de Discord. Asegúrate de que el rol de Hoshiko esté posicionado por encima de los roles comunitarios que gestionará.
✦ Por jerarquía de Discord, Hoshiko no puede sancionar ni asignar roles a miembros con rango igual o superior al suyo.
2. Explora el comando de ayuda interactivo
Ejecuta `/help` en cualquier canal para abrir el menú central de Hoshiko y consultar categorías en tiempo real con botones interactivos.
/help3. Configura el canal de auditoría y registros
Define el canal privado donde el equipo de staff recibirá la trazabilidad de advertencias, silencios y sanciones disciplinarias.
/setup-logs canal:#mod-logs4. Activa el sistema de experiencia y roles
Inicia el asistente guiado para habilitar la acumulación de XP en chat y voz, y define recompensas automáticas por nivel.
/setup-levelsGuías de uso por categoría
Descubre cómo resolver tareas cotidianas en tu comunidad con ejemplos reales paso a paso.
Moderación y Gestión Comunitaria
Hoshiko ofrece un flujo disciplinario progresivo (advertencia, aislamiento, expulsión, softban y baneo), auditado y reversible en todo momento.
/warn usuario:@miembro motivo:Spam reiterado en canal generalRegistra una sanción formal acumulable en el historial del usuario.
/tempmute usuario:@miembro tiempo:30m motivo:Conducta disruptivaAplica un timeout nativo de Discord impidiendo chat y voz de forma temporal.
/setup-logs canal:#mod-logsEnlaza el canal donde se registrarán automáticamente todas las intervenciones.
Niveles y XP
Fomenta la participación activa premiando el tiempo en canales de voz y mensajes en el servidor con tarjetas visuales Canvas y roles.
/rankConsulta tu tarjeta personalizada de nivel, XP y barra de progreso.
/topVisualiza la tabla de los usuarios con mayor actividad reciente del servidor.
/level-roles add nivel:5 rol:@ActivoOtorga automáticamente un rol distintivo cuando el usuario alcanza el nivel 5.
Utilidades e Información
Accede a herramientas esenciales para consultar el estado del servidor, avatares en máxima resolución y estados de ausencia.
/serverinfoPresenta estadísticas generales, canales, roles y fecha de creación de la comunidad.
/userinfo usuario:@miembroFicha técnica del miembro con roles asignados, antigüedad e insignias.
/afk razon:Almorzando, vuelvo enseguida 🐾Notifica automáticamente a cualquier miembro que te mencione mientras estés ausente.
IA Conversacional y Memoria
Conversación natural con cuotas diarias equitativas de 24 horas y memoria personal bajo el control del propio usuario.
/aiAbre el panel interactivo de inteligencia artificial y consulta tu cuota diaria.
/memoryGestiona los recuerdos y preferencias que Hoshiko tiene registrados sobre ti.
/clearmemoryElimina de forma irreversible tu memoria personal guardada en el sistema.
Comunidad y Confesiones
Buzón anónimo con generación gráfica en tarjetas Canvas para dinamizar la interacción comunitaria con herramientas de filtrado.
/setup-confessions canal:#confesiones visual:trueAsigna el canal destino y activa el diseño de tarjetas visuales estéticas.
/confessEnvía una publicación al canal sin revelar la identidad del autor.
Economía
Esta sección está en construcción
Esta sección está en construcción.
Hoshiko Security
Esta sección está en construcción
Un bot independiente, pensado para proteger tu servidor. Llegará a su debido tiempo.