---

📢 EnderAnnounce2 - Wiki

Un plugin ligero y potente de anuncios para Minecraft con soporte completo de colores, anuncios automáticos y formatos personalizables.

---

📋 Tabla de Contenidos

1. 🎯 Características
2. ⚡ Instalación Rápida
3. 🎮 Comandos
4. 🔧 Configuración
5. 🎨 Formatos de Colores
6. ⏰ Anuncios Automáticos
7. 🔒 Permisos
8. 📖 Ejemplos Prácticos
9. ❓ Preguntas Frecuentes
10. 🆘 Soporte

---

🎯 Características

✨ Formatos de Colores Avanzados

• Colores Legacy: &a, &b, &c, etc.
• Colores Hex: &#ff0000, #00ff00, etc.
• MiniMessage: <red>, <gradient:#ff0000:#00ff00>, <rainbow>, etc.

🚀 Sistema de Anuncios Predefinidos

• Anuncios configurables desde el archivo de configuración
• Formatos únicos y personalizables para cada anuncio
• Placeholders dinámicos ({player})

⏱️ Anuncios Automáticos

• Temporizadores personalizables por anuncio
• Sistema inteligente (solo envía si hay jugadores online)
• Control total desde la configuración

🎵 Sistema de Sonidos

• Sonidos personalizables por anuncio
• Volumen y tono ajustables
• Compatible con todos los sonidos de Minecraft

🔧 Configuración Flexible

• Archivo de configuración intuitivo
• Recarga en caliente sin reiniciar el servidor
• Mensajes completamente personalizables

---

⚡ Instalación Rápida

📥 Paso 1: Descargar

1. Descarga el archivo EnderAnnounce2.jar
2. Asegúrate de tener Java 8+ y Minecraft 1.16.5+

📁 Paso 2: Instalar

1. Coloca el archivo JAR en la carpeta plugins/ de tu servidor
2. Reinicia o recarga el servidor
3. Se generará automáticamente el archivo config.yml

⚙️ Paso 3: Configurar

1. Edita plugins/EnderAnnounce2/config.yml según tus necesidades
2. Ejecuta /announceconfig reload para aplicar cambios

---

🎮 Comandos

👥 Para Jugadores

/announce <nombre>

Envía un anuncio predefinido a todos los jugadores online.

Ejemplos:

/announce bienvenida    → Envía anuncio de bienvenida
/announce reglas        → Envía anuncio de reglas
/announce list          → Lista todos los anuncios disponibles

🔧 Para Administradores

/announceconfig <opción>

Gestiona la configuración del plugin.

Opciones disponibles:

/announceconfig reload          → Recarga la configuración
/announceconfig toggle          → Activa/desactiva el plugin
/announceconfig list            → Lista anuncios disponibles
/announceconfig auto status     → Ver estado de anuncios automáticos
/announceconfig auto toggle     → Activar/desactivar anuncios automáticos

---

🔧 Configuración

📄 Estructura del config.yml

# Configuración general
settings:
  enabled: true                    # Habilitar/deshabilitar plugin
  play_sound: true                 # Sonidos globales
  
  # Sistema de anuncios automáticos
  auto_announcements:
    enabled: true                  # Habilitar anuncios automáticos
    debug: false                   # Logs de depuración

# Anuncios predefinidos
announcements:
  nombre_anuncio:
    format: |                      # Formato del anuncio (multilinea)
      <gradient:#ff6b6b:#4ecdc4>Texto decorativo
      <white>{message}
    sound:                         # Configuración de sonido
      enabled: true
      type: "entity.experience_orb.pickup"
      volume: 1.0
      pitch: 1.0
    auto:                         # Configuración automática
      enabled: true               # ¿Envío automático?
      interval: 300               # Intervalo en segundos

# Mensajes del sistema
messages:
  no_permission: "<red>¡Sin permisos!"
  config_reloaded: "<green>¡Configuración recargada!"
  # ... más mensajes

🎨 Anuncios Predefinidos Incluidos

Nombre	Descripción	Automático	Intervalo
bienvenida	Mensaje de bienvenida	✅	5 minutos
reglas	Reglas del servidor	✅	30 minutos
tienda	Promoción de tienda	✅	15 minutos
mantenimiento	Avisos de mantenimiento	❌	Solo manual
evento	Anuncios de eventos	❌	Solo manual
reinicio	Avisos de reinicio	❌	Solo manual

---

🎨 Formatos de Colores

🟦 Colores Legacy (Tradicionales)

&0 - Negro          &8 - Gris oscuro
&1 - Azul oscuro    &9 - Azul
&2 - Verde oscuro   &a - Verde
&3 - Aqua oscuro    &b - Aqua
&4 - Rojo oscuro    &c - Rojo
&5 - Púrpura        &d - Rosa
&6 - Dorado         &e - Amarillo
&7 - Gris           &f - Blanco

&l - Negrita        &m - Tachado
&o - Cursiva        &k - Obfuscado
&n - Subrayado      &r - Reset

Ejemplo:

/announce &a¡Bienvenido! &c¡Ten cuidado!

🌈 Colores Hex (Personalizados)

&#ff0000 - Rojo puro
&#00ff00 - Verde puro
&#0000ff - Azul puro
&#ffff00 - Amarillo puro
&#ff8c00 - Naranja
&#8a2be2 - Violeta

Ejemplo:

/announce &#ff6b6b¡Mensaje con color hex personalizado!

✨ MiniMessage (Avanzado)

Colores básicos:

<red>, <green>, <blue>, <yellow>, <white>, <black>
<dark_red>, <dark_green>, <dark_blue>, etc.

Formatos:

<bold>Negrita</bold>
<italic>Cursiva</italic>
<underlined>Subrayado</underlined>
<strikethrough>Tachado</strikethrough>
<obfuscated>Obfuscado</obfuscated>

Efectos especiales:

<gradient:#ff0000:#00ff00>Texto con gradiente</gradient>
<rainbow>Texto arcoíris</rainbow>
<click:run_command:/help>Texto clickeable</click>
<hover:show_text:'Información'>Texto con hover</hover>

Ejemplos avanzados:

format: |
  <gradient:#ff6b6b:#4ecdc4><bold>ANUNCIO</bold></gradient>
  <rainbow>¡Texto arcoíris increíble!</rainbow>
  <click:run_command:/help><green>Haz clic para ayuda</green></click>

---

⏰ Anuncios Automáticos

🔄 Configuración de Temporizadores

Cada anuncio puede configurarse para enviarse automáticamente:

announcements:
  mi_anuncio:
    format: "Mi mensaje"
    auto:
      enabled: true          # Activar envío automático
      interval: 600          # Cada 10 minutos (en segundos)

⏱️ Intervalos Recomendados

Tipo de Anuncio	Intervalo Sugerido	Segundos
Bienvenida	5-10 minutos	300-600
Reglas	20-30 minutos	1200-1800
Tienda/Donaciones	10-15 minutos	600-900
Eventos	Solo manual	-
Mantenimiento	Solo manual	-

📊 Monitoreo de Anuncios Automáticos

# Ver estado actual
/announceconfig auto status

# Resultado:
═══ Estado de Anuncios Automáticos ═══
Sistema: Habilitado
Anuncios activos: 3
Anuncios automáticos activos:
- bienvenida cada 5m 0s
- reglas cada 30m 0s
- tienda cada 15m 0s

🎛️ Control de Anuncios Automáticos

# Activar/desactivar sistema completo
/announceconfig auto toggle

# Recargar configuración y temporizadores
/announceconfig reload

---

🔒 Permisos

👥 Permisos Principales

Permiso	Descripción	Por Defecto
enderannounce.announce	Enviar anuncios	OP
enderannounce.admin	Configurar plugin	OP
enderannounce.*	Todos los permisos	OP

📖 Ejemplos Prácticos

🎯 Ejemplo 1: Anuncio de Bienvenida Básico

announcements:
  bienvenida_simple:
    format: |
      <green>¡Bienvenido al servidor!
      <yellow>Disfruta tu estancia
    sound:
      enabled: true
      type: "entity.player.levelup"
      volume: 0.8
      pitch: 1.2
    auto:
      enabled: true
      interval: 300  # 5 minutos

🚨 Ejemplo 2: Anuncio de Emergencia

announcements:
  emergencia:
    format: |
      <gradient:#ff4757:#ffa502>⚠️ ATENCIÓN ⚠️</gradient>
      <red><bold>REINICIO DE EMERGENCIA EN 2 MINUTOS</bold>
      <yellow>Guarda tu progreso inmediatamente
      <gradient:#ffa502:#ff4757>⚠️ ATENCIÓN ⚠️</gradient>
    sound:
      enabled: true
      type: "entity.wither.spawn"
      volume: 1.0
      pitch: 0.8
    auto:
      enabled: false  # Solo manual

🎉 Ejemplo 3: Anuncio de Evento Festivo

announcements:
  evento_navidad:
    format: |
      <rainbow>🎄 ════════════════════════════════════ 🎄</rainbow>
      <gold><bold>¡EVENTO ESPECIAL DE NAVIDAD!</bold>
      <white>¡Regalos especiales disponibles!
      <green>Usa <yellow>/evento navidad</yellow> para participar
      <red>¡Solo por tiempo limitado!
      <rainbow>🎁 ════════════════════════════════════ 🎁</rainbow>
    sound:
      enabled: true
      type: "entity.firework_rocket.blast"
      volume: 1.0
      pitch: 1.0
    auto:
      enabled: true
      interval: 900  # 15 minutos durante el evento

🏪 Ejemplo 4: Promoción de Tienda

announcements:
  tienda_vip:
    format: |
      <gradient:#f39c12:#e67e22>💎 TIENDA VIP 💎</gradient>
      <white>¡Mejora tu experiencia de juego!
      <yellow>• Rangos VIP disponibles
      <yellow>• Kits exclusivos
      <yellow>• Beneficios únicos
      <aqua>Visita: <gold>/tienda</gold> o <gold>/vip</gold>
      <gradient:#e67e22:#f39c12>💰 ¡Apoya el servidor! 💰</gradient>
    sound:
      enabled: true
      type: "entity.villager.yes"
      volume: 0.7
      pitch: 1.1
    auto:
      enabled: true
      interval: 1200  # 20 minutos

---

❓ Preguntas Frecuentes

🤔 ¿Cómo agrego un nuevo anuncio?

1. Abre plugins/EnderAnnounce2/config.yml
2. Agrega una nueva sección bajo announcements:
3. Ejecuta /announceconfig reload

Ejemplo:

announcements:
  mi_nuevo_anuncio:
    format: "<green>Mi mensaje personalizado"
    sound:
      enabled: true
      type: "entity.experience_orb.pickup"
      volume: 1.0
      pitch: 1.0
    auto:
      enabled: false

🤔 ¿Cómo desactivo un anuncio automático específico?

Cambia auto.enabled a false en el anuncio correspondiente:

announcements:
  mi_anuncio:
    auto:
      enabled: false  # ← Cambia esto
      interval: 300

🤔 ¿Los colores funcionan en todas las versiones?

Formato	1.16.5+	1.20+	Limitaciones
Legacy (&a)	✅	✅	Ninguna
Hex (&#ff0000)	✅	✅	Ninguna
MiniMessage básico	✅	✅	Ninguna
MiniMessage avanzado	⚠️	✅	Algunas características

🤔 ¿Cómo cambio el intervalo de tiempo?

El intervalo se configura en segundos:

auto:
  interval: 1800  # 30 minutos
  # 60 = 1 minuto
  # 300 = 5 minutos  
  # 600 = 10 minutos
  # 1800 = 30 minutos
  # 3600 = 1 hora

🤔 ¿Puedo usar emojis en los anuncios?

¡Sí! Los emojis funcionan perfectamente:

format: |
  🎉 ¡Bienvenido! 🎉
  🎮 ¡Disfruta el juego! 🎮
  ⭐ ¡Eres increíble! ⭐

🆘 Soporte

📝 Antes de Reportar un Problema

1. Verifica la versión:

   • ¿Estás usando Minecraft 1.16.5 - 1.21.x?
   • ¿Tienes Java 8 o superior?

2. Revisa la configuración:

   • ¿Está bien formateado el YAML?
   • ¿Has recargado después de cambios?

3. Consulta los logs:

   • Revisa logs/latest.log en busca de errores
   • Activa debug: true para más información

🐛 Problemas Comunes y Soluciones

❌ "Plugin no funciona"

# Verifica que el plugin esté cargado
/plugins

# Si aparece en rojo, revisa los logs:
# logs/latest.log

❌ "Los colores no se muestran"

# Asegúrate de usar el formato correcto:
# ✅ Correcto:
format: "<red>Texto rojo"

# ❌ Incorrecto:
format: "\\<red\\>Texto rojo"

❌ "Los anuncios automáticos no se envían"

# Verifica la configuración:
settings:
  auto_announcements:
    enabled: true  # ← Debe estar en true

announcements:
  mi_anuncio:
    auto:
      enabled: true  # ← Debe estar en true
      interval: 300  # ← Mayor que 0

📜 Información Adicional

🔄 Actualizaciones

• ✅ Compatibilidad garantizada 1.16.5 - 1.21.x
• ✅ Actualizaciones automáticas de configuración
• ✅ Backward compatibility mantenida

📊 Rendimiento

• ⚡ Ultra ligero (<1MB RAM)
• ⚡ Sin lag en el servidor
• ⚡ Carga asíncrona de configuración

🔐 Seguridad

• 🛡️ Validación de permisos
• 🛡️ Prevención de spam
• 🛡️ Configuración segura por defecto

---

¡Gracias por usar EnderAnnounce2! Un plugin hecho con ❤️ para la comunidad de Minecraft.