Changelog / Historial de cambios

All notable changes to CursorFX will be documented in this file. Todos los cambios notables de CursorFX serán documentados en este archivo.

[2.4.3] - 2026-02-05

Added / Añadido

New Trail Textures / Nuevas Texturas de Estela

• Plus (+): Cross/plus shape trail particle
• Crosshair: Targeting crosshair trail particle

• Cruz (+): Partícula de estela en forma de cruz
• Mira: Partícula de estela en forma de punto de mira

Fixed / Corregido

Ring Lag Fix / Corrección de Lag del Anillo

• Instant ring tracking: Ring now follows cursor at full framerate (before Hz throttle) instead of lagging behind
• Settings persistence: Fixed issue where settings would reset after /reload

• Seguimiento instantáneo del anillo: El anillo ahora sigue al cursor a la tasa completa de cuadros en vez de retrasarse
• Persistencia de configuración: Corregido problema donde la configuración se reiniciaba después de /reload

Improved / Mejorado

UI/UX Professional Overhaul / Mejora Profesional de Interfaz

• Clearer labels: Renamed technical options for clarity — "Ring Alpha" → "Ring Opacity", "Trail Count" → "Trail Length", "Sparkle Alpha" → "Sparkle Opacity", "Pulse Amount" → "Pulse Intensity", "GCD Texture Texture" → "GCD Swipe Style", "Active Background Alpha" → "Ring Background Dim", and more
• Slider tooltips: Every slider now shows a descriptive tooltip on hover explaining what it controls
• Consistent naming: All opacity/transparency settings use "Opacity" instead of the technical term "Alpha"
• Bilingual tooltips: All new tooltips include Spanish translations

• Etiquetas más claras: Se renombraron opciones técnicas para mayor claridad — "Ring Alpha" → "Ring Opacity", "Trail Count" → "Trail Length", "Sparkle Alpha" → "Sparkle Opacity", "Pulse Amount" → "Pulse Intensity", "GCD Texture Texture" → "GCD Swipe Style", "Active Background Alpha" → "Ring Background Dim", y más
• Tooltips en sliders: Cada slider ahora muestra un tooltip descriptivo al pasar el cursor explicando qué controla
• Nombres consistentes: Todas las opciones de opacidad/transparencia usan "Opacity" en vez del término técnico "Alpha"
• Tooltips bilingües: Todos los nuevos tooltips incluyen traducción al español

[2.4.2] - 2026-02-05

Improved / Mejorado

Visual Quality & Anti-Aliasing / Calidad Visual y Anti-Aliasing

• Sub-pixel rendering: All textures (ring, GCD segments, trail, sparkles, click effects) now use SetSnapToPixelGrid(false) and SetTexelSnappingBias(0) to eliminate pixelation and jittery edges
• Smoother GCD ring: Increased segment count from 60 to 72 for smoother arc progression with slightly larger segment coverage
• Consistent smooth textures: Applied to both CursorFX.lua and Modules/Ring.lua for uniform quality

• Renderizado sub-pixel: Todas las texturas (anillo, segmentos GCD, estela, destellos, efectos de clic) ahora usan SetSnapToPixelGrid(false) y SetTexelSnappingBias(0) para eliminar pixelado y bordes irregulares
• Anillo GCD más suave: Incremento de segmentos de 60 a 72 para progresión de arco más fluida con mayor cobertura de segmentos
• Texturas suaves consistentes: Aplicado tanto en CursorFX.lua como en Modules/Ring.lua para calidad uniforme

Optimized / Optimizado

Performance / Rendimiento

• Cached DB lookups: onUpdate now caches db.ring, db.trail, db.perf, and db.sparkles as locals to reduce hash table lookups per frame
• Sparkle table reuse: Pre-allocated state tables for sparkles instead of creating new tables every spawn, reducing garbage collection pressure
• Shared GCD mode flag: Computed isGcdMode once per frame instead of repeating the check multiple times

• Cacheo de DB: onUpdate ahora cachea db.ring, db.trail, db.perf y db.sparkles como locales para reducir búsquedas en tabla hash por frame
• Reutilización de tablas de destellos: Tablas de estado pre-asignadas para destellos en lugar de crear nuevas tablas en cada spawn, reduciendo presión del recolector de basura
• Flag GCD compartido: Se calcula isGcdMode una vez por frame en lugar de repetir la comprobación múltiples veces

[2.4.1] - 2026-02-04

Added / Añadido

Enhanced Profile System / Sistema de Perfiles Mejorado

• Global & Character Profiles: Profiles can now be saved as global (all characters) or character-specific (only current character)
• Character Name Suffix: Option to automatically append character name to profile (e.g., "Heal - Synderi")
• Profile Indicators: Profiles show [G] for global or [P] for personal in dropdown menus
• Automation Integration: Zone and Spec preset dropdowns now show both global and character-specific profiles

Sistema de Perfiles Mejorado

• Perfiles Globales y de Personaje: Los perfiles ahora pueden guardarse como globales (todos los personajes) o específicos del personaje (solo el personaje actual)
• Sufijo de Nombre de Personaje: Opción para añadir automáticamente el nombre del personaje al perfil (ej: "Heal - Synderi")
• Indicadores de Perfil: Los perfiles muestran [G] para global o [P] para personal en los menús desplegables
• Integración con Automatización: Los dropdowns de presets por zona y especialización ahora muestran perfiles globales y específicos del personaje

Fixed / Corregido

• Character Profile Bug: Fixed issue where character-specific settings were shared between different characters
• Profile Initialization: Characters with "Character Profile" enabled but no saved settings now correctly initialize with defaults instead of using another character's configuration

• Bug de Perfil de Personaje: Corregido problema donde la configuración específica del personaje se compartía entre diferentes personajes
• Inicialización de Perfil: Los personajes con "Perfil de Personaje" activado pero sin configuración guardada ahora se inicializan correctamente con valores por defecto en lugar de usar la configuración de otro personaje

[2.4.0] - 2026-02-04

Added / Añadido

3D Model Effects / Efectos de Modelo 3D

• 3D FX Tab: New tab for 3D model effects that follow the cursor
• 50+ 3D Models: Arcane orbs, fire effects, nature spirits, shadow effects, healing auras, and more
• Model Categories: Organized by type (Arcane, Fire, Frost, Nature, Shadow, Holy, Particles)
• Customizable Scale: Adjust the size of 3D models
• Alpha Control: Adjust transparency of 3D effects
• Combat Only Mode: Option to show 3D effects only during combat
• Fade When Idle: 3D model fades out when cursor is stationary
• Exclusivity System: 3D effects automatically disable trail and sparkles for performance

Efectos de Modelo 3D

• Pestaña 3D FX: Nueva pestaña para efectos de modelo 3D que siguen al cursor
• 50+ Modelos 3D: Orbes arcanos, efectos de fuego, espíritus de naturaleza, efectos de sombra, auras de sanación, y más
• Categorías de Modelos: Organizados por tipo (Arcano, Fuego, Escarcha, Naturaleza, Sombra, Sagrado, Partículas)
• Escala Personalizable: Ajusta el tamaño de los modelos 3D
• Control de Alfa: Ajusta la transparencia de los efectos 3D
• Modo Solo Combate: Opción para mostrar efectos 3D solo durante combate
• Desvanecer en Reposo: El modelo 3D se desvanece cuando el cursor está quieto
• Sistema de Exclusividad: Los efectos 3D desactivan automáticamente estela y destellos para mejor rendimiento

Fixed / Corregido

• 3D Model Initialization: Models now display correctly on first login without requiring /reload
• SetCustomCamera: Critical fix for 3D model rendering - models now appear immediately
• Delayed Loading: Improved frame readiness detection for reliable model loading
• Event Handling: Proper initialization using PLAYER_ENTERING_WORLD and LOADING_SCREEN_DISABLED events

• Inicialización de Modelos 3D: Los modelos ahora se muestran correctamente en el primer login sin necesidad de /reload
• SetCustomCamera: Corrección crítica para renderizado de modelos 3D - los modelos aparecen inmediatamente
• Carga Diferida: Mejor detección de preparación del frame para carga confiable de modelos
• Manejo de Eventos: Inicialización correcta usando eventos PLAYER_ENTERING_WORLD y LOADING_SCREEN_DISABLED

Changed / Cambiado

Modular Architecture / Arquitectura Modular

• Core System: New modular architecture with separated concerns
  • Core/Init.lua - Addon namespace and module system
  • Core/Constants.lua - Centralized constants, textures, colors
  • Core/Utils.lua - Shared utility functions
  • Core/Database.lua - SavedVariables management and profiles
  • Core/EventManager.lua - Centralized event handling
• Presets Module: Themes moved to Presets/Themes.lua for easier customization
• Architecture Documentation: Added ARCHITECTURE.md with complete project documentation

Arquitectura Modular

• Sistema Core: Nueva arquitectura modular con responsabilidades separadas
  • Core/Init.lua - Namespace del addon y sistema de módulos
  • Core/Constants.lua - Constantes centralizadas, texturas, colores
  • Core/Utils.lua - Funciones utilitarias compartidas
  • Core/Database.lua - Manejo de SavedVariables y perfiles
  • Core/EventManager.lua - Manejo centralizado de eventos
• Módulo de Presets: Temas movidos a Presets/Themes.lua para fácil personalización
• Documentación de Arquitectura: Añadido ARCHITECTURE.md con documentación completa

[2.3.0] - 2026-02-01

Added / Añadido

New Theme System / Nuevo Sistema de Temas

• 18 Visual Themes: Color-coded buttons for instant style switching
  • Reset, Class Color, Default, Dark, Light, Neon, Fire, Frost, Nature, Shadow, Golden, Blood, Arcane, Minimal, Trail Only, Sparkles, Full FX, Comet
• Class Color Theme: Dedicated theme that automatically uses your class color for all effects (ring, trail, sparkles)
• Current Theme Indicator: Shows which theme is currently applied below the theme buttons
• Reset Button: Instantly restore default configuration without reloading UI

Nuevo Sistema de Temas

• 18 Temas Visuales: Botones con colores para cambiar de estilo instantáneamente
  • Reiniciar, Color de Clase, Default, Oscuro, Claro, Neón, Fuego, Escarcha, Naturaleza, Sombra, Dorado, Sangre, Arcano, Minimal, Solo Estela, Destellos, FX Completo, Cometa
• Tema Color de Clase: Tema dedicado que usa automáticamente el color de tu clase para todos los efectos (círculo, estela, destellos)
• Indicador de Tema Actual: Muestra qué tema está aplicado debajo de los botones de tema
• Botón Reiniciar: Restaura instantáneamente la configuración por defecto sin recargar la UI

Changed / Cambiado

• Simplified color system: Removed Color Mode dropdown, replaced with dedicated "Class Color" theme
• Ring tab options: Now depend only on ring type (Fixed/GCD), not on color mode
• Target Highlight layout: Style dropdown and sliders now on separate lines for better visibility
• Color buttons: Always accessible, no longer blocked by color mode selection

• Sistema de color simplificado: Eliminado dropdown Modo de Color, reemplazado por tema "Color de Clase"
• Opciones de pestaña Círculo: Ahora dependen solo del tipo de círculo (Fijo/GCD), no del modo de color
• Layout de Resaltar Objetivo: Dropdown de estilo y sliders ahora en líneas separadas para mejor visibilidad
• Botones de color: Siempre accesibles, ya no bloqueados por selección de modo de color

Fixed / Corregido

• Target Highlight controls: Style dropdown and sliders no longer overlap
• GCD/Cast options: Correctly shown only when using GCD ring types (GCD Clean or GCD Texture)

• Controles de Resaltar Objetivo: Dropdown de estilo y sliders ya no se solapan
• Opciones GCD/Cast: Se muestran correctamente solo con tipos de círculo GCD (GCD Limpio o GCD Textura)

[2.2.0] - 2026-01-30

Added / Añadido

• Help tooltips for all checkboxes in General, Ring, Trail, and Sparkles tabs (excluding Automation)
• Immediate preset application when toggling Zone/Spec presets checkboxes
• Per-class spec presets - Each class now has its own spec preset configuration
• User-saved profiles in Zone/Spec preset dropdowns

• Tooltips de ayuda para todos los checkboxes en las pestañas General, Círculo, Estela y Destellos (excepto Automatización)
• Aplicación inmediata de presets al activar/desactivar checkboxes de Zone/Spec presets
• Presets de spec por clase - Cada clase tiene su propia configuración de presets por especialización
• Perfiles guardados en los dropdowns de presets de Zona/Spec

Fixed / Corregido

• Preset saving - Zone and Spec presets now persist correctly between sessions
• Dropdown visual selection - Selected items now display correctly in all dropdowns
• Preset priority system - Spec presets properly override Zone presets and Quick Config

• Guardado de presets - Los presets de Zona y Spec ahora persisten correctamente entre sesiones
• Selección visual de dropdowns - Los items seleccionados ahora se muestran correctamente
• Sistema de prioridad de presets - Los presets de Spec tienen prioridad sobre Zone y Config Rápida

Changed / Cambiado

• Priority system / Sistema de prioridad:
  1. General toggles / Interruptores generales (always respected / siempre respetados)
  2. Spec Presets / Presets por Spec (highest priority / mayor prioridad)
  3. Zone Presets / Presets por Zona (if spec not active / si spec no está activo)
  4. Quick Config preset / Preset de Config Rápida (base)

[2.1.0] - 2026-01-30

Added / Añadido

• Click Effect: Visual feedback when clicking (expanding ring animation)
• Keybind Toggle: Hotkey support to toggle addon on/off (Key Bindings > Addons > Cursor FX)
• Auto-hide Options: Hide effects in combat or out of combat
• Low Health Warning: Cursor changes to red when health is below 30%
• Aggro Warning: Cursor changes color when you have threat
• Target Highlight: Circle around current target's nameplate (color based on reaction)
• Zone Presets: Automatically change preset based on zone type (raid, dungeon, arena, battleground, world)
• Spec Presets: Automatically change preset when switching specialization
• Modern UI Theme: Redesigned options panel with cyan accent colors, hover effects, and improved layout

• Efecto de Clic: Retroalimentación visual al hacer clic (animación de anillo expansivo)
• Tecla de Acceso Rápido: Soporte de tecla para activar/desactivar el addon (Asignaciones de Teclas > Addons > Cursor FX)
• Opciones de Auto-ocultar: Ocultar efectos en combate o fuera de combate
• Aviso de Vida Baja: El cursor cambia a rojo cuando la vida está por debajo del 30%
• Aviso de Aggro: El cursor cambia de color cuando tienes amenaza
• Resaltar Objetivo: Círculo alrededor de la placa del objetivo actual (color basado en reacción)
• Presets por Zona: Cambiar preset automáticamente según el tipo de zona (raid, mazmorra, arena, campo de batalla, mundo)
• Presets por Especialización: Cambiar preset automáticamente al cambiar de especialización
• Tema UI Moderno: Panel de opciones rediseñado con colores cyan, efectos hover y diseño mejorado

[2.0.0] - 2026-01-29

Added / Añadido

New Presets / Nuevos Preajustes

• Neon Glow / Neón brillante: Bright green neon effect with pulse / Efecto neón verde brillante con pulso
• Fire Trail / Estela de fuego: Warm orange/red fire effect / Efecto de fuego naranja/rojo cálido
• Frost / Escarcha: Cool blue/white ice effect / Efecto de hielo azul/blanco frío
• Shadow / Sombra: Purple shadow effect with skull sparkles / Efecto sombra púrpura con destellos de calavera
• Golden / Dorado: Elegant gold effect with diamond sparkles / Efecto dorado elegante con destellos de diamante
• Blood / Sangre: Deep red effect with pulse / Efecto rojo profundo con pulso

Combat Features / Funciones de combate

• Combat Pulse / Pulso de combate: Visual pulse effect when entering combat (toggleable) / Efecto de pulso visual al entrar en combate (activable)

Ring Improvements / Mejoras del círculo

• 6 New Ring Textures / 6 Nuevas texturas de círculo: Diamond, Star, Skull, Cross, Moon, Triangle / Diamante, Estrella, Calavera, Cruz, Luna, Triángulo
• Total of 8 ring textures now available / Total de 8 texturas de círculo disponibles

Sparkles Improvements / Mejoras de destellos

• Sparkle Size / Tamaño de destellos: Adjustable sparkle size / Tamaño de destellos ajustable
• Sparkles Per Tick / Destellos por tick: Control how many sparkles spawn per tick / Controla cuántos destellos aparecen por tick
• Sparkle Lifetime / Duración de destellos: Adjustable sparkle duration / Duración de destellos ajustable
• Sparkle Alpha / Opacidad de destellos: Adjustable sparkle opacity / Opacidad de destellos ajustable

Minimap Button / Botón de minimapa

• Quick access to options panel (left-click) / Acceso rápido al panel de opciones (clic izquierdo)
• Toggle addon on/off (right-click) / Activar/desactivar addon (clic derecho)
• Draggable around the minimap / Arrastrable alrededor del minimapa
• Option to hide the button in settings / Opción para ocultar el botón en ajustes

Profiles System / Sistema de perfiles

• Save Profiles / Guardar perfiles: Save your current configuration with a custom name
• Load Profiles / Cargar perfiles: Load previously saved configurations
• Delete Profiles / Eliminar perfiles: Remove unwanted profiles

Import/Export / Importar/Exportar

• Export Configuration / Exportar configuración: Copy your configuration as a shareable string
• Import Configuration / Importar configuración: Paste a configuration string to apply settings

Changed / Cambiado

• Updated TOC version to 2.0.0 / Versión TOC actualizada a 2.0.0
• Improved addon title with cyan color in addon list / Título del addon mejorado con color cian
• Enhanced Notes description in TOC / Descripción de notas mejorada en TOC
• Added IconTexture for addon icon display / Añadido IconTexture para mostrar icono del addon

Fixed / Corregido

• Fixed StaticPopup EditBox compatibility for Retail WoW / Corregida compatibilidad de EditBox en StaticPopup
• Fixed UI control overlapping issues in Ring tab / Corregidos problemas de solapamiento de controles
• Improved dynamic control positioning based on ring mode / Mejorado posicionamiento dinámico de controles

[1.1.0] - Previous Version / Versión anterior

Features / Características

• Basic ring with Fixed, GCD Clean, and GCD Texture modes / Círculo básico con modos Fijo, GCD Limpio y GCD Textura
• Cursor trail with multiple textures / Estela del cursor con múltiples texturas
• Idle sparkles / Destellos en reposo
• Class color and custom color modes / Modos de color de clase y color personalizado
• Combat coloring / Color en combate
• 3 presets: Classic Cyan, Minimal (Class Color), Spark Trail Only / 3 preajustes: Cian clásico, Minimalista, Solo estela
• In-game options panel / Panel de opciones en el juego
• /cfx command / Comando /cfx
• English and Spanish localization / Localización en inglés y español