Plugin avanzado de chat para Paper/Folia con formato enriquecido, mensajes privados, filtros, minijuegos, anuncios, placeholders, emojis y reacciones visuales.
Plataforma
Paper 1.21.11+ / 26.2+
Compatibilidad
Paper y Folia
Dependencias Opcionales
PlaceholderAPI
Placeholders y expansión
MiniPlaceholders
Tags MiniMessage externos como FancyTags
LuckPerms
Prefix/rango y hover
Vault
Economía y recompensas
EssentialsDiscord
Bridge opcional del chat hacia Discord
Internas
bStats
Métricas
Comandos
Lista de todos los comandos disponibles separados por su funcionalidad.
Comandos Principales
/axochat help
axochat.admin
Muestra ayuda del plugin
/axochat reload
axochat.admin
Recarga configuraciones y módulos
/axochat version
axochat.admin
Muestra la versión cargada
/clear
axochat.clear
Limpia el chat global
/channel <canal>
axochat.channel
Cambia el canal activo del jugador
/games start/stop
axochat.games.*
Inicia o detiene un minijuego
Comandos de Módulos
Módulos del Sistema
Controlables desde config.yml -> modules.*.
Estructura y Configuraciones
Antes de editar
AxoChat usa MiniMessage para colores y componentes, PlaceholderAPI para placeholders con porcentaje y MiniPlaceholders para tags externos. Después de guardar cambios usa /axochat reload. Si cambias dependencias externas, reinicia el servidor.
Formato de Chat
El formato principal está en config.yml -> Chat.Format. Usa %message% o {message} para insertar el texto del jugador.
Chat:
Format: "%luckperms_prefix% &7%player_name%: &r&7{message}"
Groups:
admin:
Format: "<red><bold>%player_name%</bold></red> <dark_gray>»</dark_gray> <white>%message%</white>"
Placeholders útiles: %player_name%, %player_displayname%, %message%, {message}, %prefix%, %rank% y placeholders de PlaceholderAPI.
Hover con Click
El hover se muestra al pasar el mouse por el nombre. Si envuelves las líneas con <click:...>, AxoChat aplica ese click al nombre visible.
hover-chat:
enabled: true
lines:
- "<click:suggest_command:'/msg %player_name% '>"
- "<gold><bold>%player_name%</bold></gold>"
- "<gray>Rango:</gray> <white>%axochat_rank%</white>"
- "<gray>Click para escribirle un mensaje privado.</gray></click>"
Usa suggest_command para dejar /msg jugador escrito en el chat. Usa run_command solo si quieres ejecutar un comando completo inmediatamente.
Reacciones
Cada reacción define trigger, permiso, icono de chat, textura, partícula, sonido y animación.
chat-reactions:
enabled: true
cooldown-seconds: 3
reactions:
like:
permission: "axochat.reaction.like"
triggers:
- ":like:"
- "👍"
Seguridad MiniMessage
AxoChat permite configurar formatos como admin, pero filtra tags peligrosos cuando los jugadores escriben en el chat.
chat:
allow-minimessage: true
require-minimessage-permission: true
minimessage-permission: "axochat.minimessage"
minimessage-security:
enabled: true
rules:
hover:
allow: true
permission: "axochat.minimessage.hover"
run_command:
allow: false
permission: "axochat.minimessage.run_command"
run_command debe quedar restringido. Para botones seguros usa suggest_command cuando sea posible.
MiniPlaceholders y FancyTags
Si tienes MiniPlaceholders y FancyTags instalados, puedes usar tags como <fancytags_tag:admin> directamente en formatos y hovers.
Chat:
Format: "<fancytags_tag:admin> %player_name% <gray>»</gray> <white>%message%</white>"
hover-chat:
lines:
- "<fancytags_tag:admin> <gold>%player_name%</gold>"
- "<gray>Rango:</gray> <white>%axochat_rank%</white>"
Si el tag aparece literal, revisa que MiniPlaceholders cargue antes que AxoChat y que la expansión de FancyTags esté activa.
Mensajes Privados y Mutes
AxoChat puede respetar mutes externos usando placeholders. Esto evita que un jugador muteado escriba por /msg.
private-messages:
respect-external-mutes:
enabled: true
bypass-permission: "axochat.msg.mutebypass"
placeholders:
- "%justbans_is_muted%"
muted-values:
- "yes"
- "true"
- "muted"
- "1"
El hover no aparece
Verifica que modules.hover-messages esté en true, que hover-chat.enabled esté activo y que el jugador tenga axochat.hover.
El click no funciona
El click se aplica al nombre visible, no al tooltip. Cierra el tag con </click> y usa suggest_command para comandos incompletos como /msg.
Los placeholders salen literales
Instala PlaceholderAPI para %...%. Instala MiniPlaceholders para <tag:valor>. Después reinicia el servidor y ejecuta /axochat reload.