Repository navigation
Releases
Releases · X4yii/x4ui
X4UI r1.0b6
title: "X4UI Framework r1.0b6"
date: 2026-11-14
project: "X4UI"
version: "r1.0b6"
X4UI r1.0b6
[ES]
Compatibilidad Dual Oficial (Forge 1.12.2 + CleanroomMC)
- Soporte oficial Java 8 (Forge 1.12.2 + LWJGL 2) y Java 25 (CleanroomMC + LWJGL 3):
PlatformBridgeimplementado como Multi-Release JAR (META-INF/versions/21/) para usarCleanery virtual threads en JVMs modernas con fallback seguro en Java 8. - Abstracciones de Entrada y Gráficos:
KeyCodesdesacopla constantes de teclado deorg.lwjgl.input.Keyboard.UIInputnormaliza deltas de rueda del mouse (LWJGL 2±120y LWJGL 3/GLFW) y protege coordenadas del mouse antedisplayWidth == 0/displayHeight == 0.IGraphicsincorporaclearDepthBuffer()y carga de texturas BGRA sin llamadas directas aGL11/GL12en componentes.
Framework Flexible Servidor ↔ Cliente (Con o Sin Container)
- Nuevo
UINetwork+ScreenRegistry+PacketHandshake: Registro y apertura remota de pantallas desde servidor (openScreen), cierre remoto (closeScreen), toasts (sendToast), handshake automático y modo server-optional (isServerSupported(),hasClient(player)). - RPC Request–Response (
PacketGuiRpc+RpcResult): Consultas asíncronas cliente → servidor desdeGuiBaseScreen/GuiBaseContainerconrequest(...), timeout configurable, cancelación automática al cerrar la pantalla yNO_SERVER_SUPPORTen servidores sinx4ui. - Estado por Pantalla y Lotes (
UIStateBus.Scope.SCREEN+PacketStateBatch):syncedState(key, valor)se limpia automáticamente enonGuiClosed();UIStateBus.scopedKey(ns, key)yclearNamespace(ns)evitan colisiones. - Canales Multi-Jugador (
UIChannels+ClientSessionTracker): Suscripción automática por canal (openChannelScreen),broadcastState,broadcastBatchybroadcastToastcon desuscripción al cerrar pantalla o desconectarse. - Seguridad en Red (
ActionGuard+ Rate-Limiting): Guardas componibles (opLevel,withinDistance,withinEntityDistance,require) y cooldown por jugador/acción (50mspor defecto).
Diseño Minimalista y Motor de Layout
- Tema sólido minimalista por defecto: Paleta oscura limpia en
DefaultThemey variantes deGuiButton. - Primitivas de
GuiPanelyFlexAlign:GuiPanel.row,GuiPanel.column,GuiPanel.card,GuiPanel.spacer(),FlexAlign(START,CENTER,END,STRETCH),createCenteredWindowyGuiScrollPanel.vertical. - Correcciones de Layout: Fix de
percentWidthrespecto a padding y reserva automática de barra enGuiScrollPanel.
Multimedia, Seguridad y Limpieza
- FFmpeg en el OS del usuario (
MediaManager): Descubrimiento automático deffmpegen Linux, macOS y Windows 10/11 (en lugar de descargarlo en.minecraft/), con fallback automático a JCodec cuando no está disponible. - Manejo de errores en
GuiVideo: Estado de error visible con diagnóstico, barra de estado, limpieza segura de recursos y recuperación ante fallos de red o códec. - Seguridad y Sincronización:
SecurityUtilspara validación SSRF y path traversal;StateContainerListeneratómico de 32-bit; migración de logs a Log4j2; eliminación total de shims@Deprecated.
[/ES]
[EN]
Official Dual Runtime Support (Forge 1.12.2 + CleanroomMC)
- Official Java 8 (Forge 1.12.2 + LWJGL 2) & Java 25 (CleanroomMC + LWJGL 3) support:
PlatformBridgeimplemented as a Multi-Release JAR (META-INF/versions/21/) usingCleanerand virtual threads on modern JVMs with safe Java 8 fallbacks. - Input & Graphics Abstractions:
KeyCodesdecouples key constants fromorg.lwjgl.input.Keyboard.UIInputnormalizes mouse wheel deltas (LWJGL 2±120and LWJGL 3/GLFW) and guards mouse coordinates againstdisplayWidth == 0/displayHeight == 0.IGraphicsaddsclearDepthBuffer()and BGRA texture upload without directGL11/GL12calls in components.
Flexible Server ↔ Client Framework (With or Without Container)
- New
UINetwork+ScreenRegistry+PacketHandshake: Remote screen registration and opening (openScreen), remote closing (closeScreen), toast notifications (sendToast), automatic handshake, and server-optional mode (isServerSupported(),hasClient(player)). - Request–Response RPC (
PacketGuiRpc+RpcResult): Asynchronous client → server queries fromGuiBaseScreen/GuiBaseContainerviarequest(...)with configurable timeout, automatic cancellation on screen close, andNO_SERVER_SUPPORTon vanilla/client-only servers. - Screen-Scoped State & Batching (
UIStateBus.Scope.SCREEN+PacketStateBatch):syncedState(key, initialValue)is automatically cleared inonGuiClosed();UIStateBus.scopedKey(ns, key)andclearNamespace(ns)prevent key collisions. - Multi-Player Channels (
UIChannels+ClientSessionTracker): Automatic channel subscription (openChannelScreen),broadcastState,broadcastBatch, andbroadcastToastwith cleanup on screen close or disconnect. - Network Security (
ActionGuard+ Rate-Limiting): Composable guards (opLevel,withinDistance,withinEntityDistance,require) and per-player/action cooldown (50msdefault).
Minimalist Design & Layout Engine
- Solid minimalist default theme: Clean dark palette in
DefaultThemeandGuiButtonvariants. GuiPanel&FlexAlignprimitives:GuiPanel.row,GuiPanel.column,GuiPanel.card,GuiPanel.spacer(),FlexAlign(START,CENTER,END,STRETCH),createCenteredWindow, andGuiScrollPanel.vertical.- Layout fixes: Fixed
percentWidthbox-model padding calculation and automatic scrollbar width reservation inGuiScrollPanel.
Media, Security & Cleanup
- OS-level FFmpeg discovery (
MediaManager): Automatically locatesffmpegon Linux, macOS, and Windows 10/11 (instead of bundling inside.minecraft/), with automatic fallback to JCodec when unavailable. GuiVideoerror handling: Visible error state with diagnostics, status bar, safe resource cleanup, and graceful recovery on network or codec failures.- Security & Sync:
SecurityUtilsfor SSRF and path traversal protection; atomic 32-bitStateContainerListener; Log4j2 logger migration; complete removal of@Deprecatedshims.
[/EN]
X4UI r1.0b5
Changelog r1.0b5
date: 2026-09-10
[ES]
Abstracción Gráfica (IGraphics)
- Capa Gráfica Inmediata: Introducción de
IGraphicsyGLGraphics. Desacopla el renderizado de componentes de llamadas directas a OpenGL y LWJGL. - Pila de Estados: Gestión jerárquica de transformaciones matriciales, opacidad global (
pushAlpha/popAlpha), tinte de color (pushColorTint/popColorTint), tipografía activa y recorte por tijera (pushClip/popClip) mediantesave()yrestore(). - Primitivas de Dibujo: Métodos para rectángulos planos y redondeados, bordes, líneas, círculos y gradientes.
Sistema de Tipografía (IFont, FontRegistry)
- Abstracción
IFont: Interfaz unificada de renderizado y métricas de texto independiente deFontRenderer. - Motor
TrueTypeFont: Rasterización acelerada por hardware para fuentes vectoriales (.ttf/.otf) y del sistema con anti-aliasing y soporte completo de códigos de formato vanilla (§0-§f). FontRegistry: Registro centralizado para carga, resolución y recarga dinámica de fuentes ante eventos de recursos (F3 + T).- Integración: Soporte de fuentes personalizadas propagado mediante
IGraphics.setFont()yGuiComponent.withFont().
Arquitectura de Componentes y Ciclo de Vida (GuiComponent)
- Ciclo de Vida Estandarizado: Introducción de hooks
onAttached(),onDetached(),onDestroy()y método de actualización por fotogramaupdate(float deltaTime). - Dimensionamiento y Posición Porcentual: Métodos
withPercentWidth(),withPercentHeight()ywithPercentPosition()calculados dinámicamente respecto al contenedor padre. - API Fluida Directa: Configuración encadenable de posición, tamaño, márgenes, padding, capas visuales (
withLayer), tipografía y temas directamente enGuiComponent. - Gestión de Estados Reactivos: Desvinculación automática de escuchadores de
State<T>al destruir componentes para prevenir retención de memoria.
Componentes Visuales
GuiImage(9-Slice): Soporte nativo para escalado de bordes 9-slice medianteNineSliceConfig.GuiSprite: Motor de animación 2D basado en fuentes de fotogramas (SpriteSheetSource,SequenceSource), control de FPS y modos de reproducción (LoopMode).GuiSlider: Reestructuración modular tipada (GuiSliderInt,GuiSliderFloat,GuiSliderDouble) con soporte para orientación horizontal y vertical.GuiTextInput: Desplazamiento horizontal para textos largos, selección por arrastre de ratón y atajos de teclado para navegación y borrado por palabras (Ctrl+Backspace,Ctrl+Delete).
Superposiciones en GUI (GuiOverlayManager)
- Inyección no Intrusiva: Pipeline para acoplar componentes e interfaces a pantallas vanilla (
GuiContainer) o de otros mods sin sustituir la clase de pantalla original. - Acoplamiento (
OverlayDockManager): Anclaje a bordes de contenedor (ContainerAnchor) con apilamiento dinámico entre paneles.
Integración con JEI (Just Enough Items)
- Compatibilidad JEI: Registro automático de rectángulos de exclusión para contenedores y superposiciones activas de X4UI, evitando solapamiento con la interfaz de JEI.
- Interacción: Soporte para atajos de consulta de recetas (
R) y usos (U) sobre componentesGuiSlot.
Buses y Registros Globales
UIStateBus: Bus centralizado para comunicación desacoplada y reactiva entre interfaces y módulos independientes.ThemeRegistry: Registro centralizado para registrar, consultar y alternar instancias deITheme.
Arquitectura de Red y Sidedness
- Aislamiento por Proxies (@SidedProxy): Separación estricta en
ClientProxyyCommonProxy, garantizando cero carga de clases gráficas o multimedia en servidores dedicados. - Conexión Server-Optional (@NetworkCheckHandler): Compatibilidad cliente-servidor asimétrica que permite conectar clientes con X4UI a servidores sin el mod instalado.
Multimedia y Reproducción de Video/Audio Zero-Copy
- Streaming de Video Zero-Copy (FFmpeg): Decodificación y volcado directo de fotogramas desde pipes del sistema operativo hacia buffers directos fuera del heap (
DirectByteBuffer) mediante canales NIO (ReadableByteChannel). - Eliminación de Asignaciones en Heap: Supresión de arrays
byte[]intermedios, llamadasasIntBuffer()yDynamicTexture, garantizando cero consumo de heap de Java durante la reproducción en régimen permanente. - Renderizado Directo OpenGL: Carga directa a texturas OpenGL con
glTexSubImage2Dutilizando punteros nativos de memoria directa. - Eliminación de Ruido VRAM: Pestillo de sincronización de primer fotograma (
hasUploadedFirstFrame) que evita mostrar memoria gráfica no inicializada al pulsar reproducir. - Audio Sincronizado OpenAL: Motor
OpenALAudioSinky decodificadorFFmpegAudioDecoderpara transmisión estéreo PCM a 48 kHz con control de ganancia, muteo y reloj maestro de sincronización A/V. - Controles de Reproducción (
IVideoControlsLayout): Interfaz modular para superposiciones de control sobreGuiVideo. Implementación estándarDefaultVideoControlsLayoutcon botones de Play/Pause, barra de progreso interactiva (scrubbing/arrastre con ratón, pista amortiguada y tooltip de tiempo), estampas temporales (00:15 / 02:45), botón de muteo y desvanecimiento suave (auto-hide fade) tras 2.5s de inactividad. - Pipeline Unificado de Medios (
MediaPipeline): Descarga secuencial en segundo plano (1 a 1) y optimización mediante FFmpeg oficial fijado enx4ui/bin/(sin consultas a variables de entornoPATH). Recodificación universal a la especificación estricta de JCodec:H.264 Baseline Level 3.1(sin B-frames, entropía rápida CAVLC,yuv420p, dimensiones paresscale/pad <= 720p), audio AAC a 48 kHz y contenedor MP4 conmooval inicio (+faststart). Garantiza que si FFmpeg falla o no está disponible en runtime, el fallbackJCodecVideoDecoderpueda reproducir el video fluidamente sin incompatibilidades de códec. - Descubrimiento Declarativo de Medios: Detección automática en
preInitmediante manifiestosassets/<modid>/x4ui/media.jsony registro por lotes víaMediaRegistry.registerMedia(), eliminando el registro tedioso uno a uno. - Integración con Forge SplashScreen (
ProgressManager): Barra de progreso nativa durante la faseloadCompletede Forge para descarga y optimización con timeout de seguridad de 35 segundos para garantizar un arranque fiable. - Carga Dinámica In-Game: Soporte para URLs solicitadas en tiempo de ejecución con indicador visual de progreso y spinner animado dentro de
GuiVideosin congelar el hilo principal de Minecraft.
Motor de Layouts Flexbox No Destructivo (hugContent)
- Comportamiento No Destructivo por Defecto:
FlexLayoutya no colapsa ni muta destructivamente las dimensiones fijas o porcentuales de los contenedores padre (parent.setWidth/setHeight). - Propiedad
hugContent: Introducción dehugContent(boolean)(desactivado por defecto). Al activarse, ajusta automáticamente el tamaño del contenedor padre a las dimensiones acumuladas de sus hijos visibles. - Integración en Paneles: Métodos fluidos
setHugContent()ywithHugContent()enGuiPanel. El panel de contenido interno deGuiScrollPanel(contentPanel) ahora activahugContent(true)de forma nativa para abrazar la altura real del contenido scrolleable. - Ajuste Fino de Espaciado: Corrección en el cálculo de márgenes y espaciado que elimina el
gapsobrante posterior al último elemento visible del flujo flex.
Optimización Gráfica y VRAM en Video
- Caché de Textura OpenGL (
lastUploadedPts): Eliminación de transferencias masivas e innecesarias de memoria fuera del heap a la GPU víaglTexSubImage2Da 60/144 Hz cuando el fotograma decodificado no ha cambiado, reduciendo el consumo de ancho de banda PCIe a solo la tasa de cuadros del video (~30 fps). - Consumo y Liberación de Búfer: Integración de
popFrame()enDirectMemoryVideoDecoderpara prevenir acumulación o estancamiento de fotogramas en el búfer directo. - Salto Temporal FFmpeg (
seek): Soporte funcional para reposicionamiento temporal mediante-ssy recálculo de índice de fotogramas enFFmpegProcessDecoder.
Ciclo de Vida y Eventos (Core Engine)
- Registro en el Bus de Forge: Suscripción explícita a
MinecraftForge.EVENT_BUSenClientProxy.init(), garantizando el ciclo por cuadro deGuiAnimator.update()enRenderTickEventy la limpieza preventiva de animaciones y estados de sesión (UIStateBus.clearSessionStates()) al desconectarse del servidor. - Propagación Dinámica de Dimensiones:
GuiLabelyGuiMarkdownahora utilizan los setterssetWidth()ysetHeight()en lugar de mutar campos directos, invalidando y recalculando automáticamente el layout del contenedor padre (parent.requestLayout()) ante cambios de texto.
Seguridad, Red y Sandboxing de Recursos
- Aislamiento por Mod ID: Sandboxing estricto de caché bajo
.minecraft/x4ui/cache/<modid>/para prevenir colisiones o sobreescrituras entre diferentes mods consumidores. - Resiliencia HTTP: Incorporación de cabecera
User-Agent: Mozilla/5.0..., resolución automática de redirecciones HTTP (códigos 301, 302, 307) y timeouts de seguridad enDownloadManager. - Caché Unificada de Imágenes: Redirección de descargas de
GuiImage.setUrl()hacia la estructura canónica.minecraft/x4ui/cache/images/.
[/ES]
[EN]
Graphics Abstraction (IGraphics)
- Immediate Graphics Layer: Introduced
IGraphicsandGLGraphics, decoupling component rendering from direct OpenGL and LWJGL calls. - State Stack: Hierarchical management for matrix transformations, global alpha (
pushAlpha/popAlpha), color tint (pushColorTint/popColorTint), active font, and scissor clipping (pushClip/popClip) viasave()andrestore(). - Drawing Primitives: Built-in methods for flat and rounded rectangles, bo...
X4UI Beta r1.0b4
Changelog r1.0b4
date: 2026-09-03
[ES]
Arquitectura y Seguridad (Client/Server)
- Separación Estricta Cliente/Servidor: Reestructuración de la jerarquía de paquetes. Interfaces en
api.client.*, implementaciones enimpl.client.*. PrevieneClassNotFoundExceptionen Servidores Dedicados. - State<T>: Reubicado en
com.x4yi.x4ui.commonpara uso seguro en servidores. EmployaCopyOnWriteArrayListy deduplicación de valores porObjects.equals(). - NetworkSyncHelper: Permite vincular propiedades de
Container(víaIContainerListener) a objetosState<Integer>,State<Boolean>yState<Float>con escala configurable.
Assets y Multimedia
- RemoteResourceManager: Sistema de descarga asíncrona de recursos multimedia (imágenes, audio, vídeo) desde URLs HTTP/HTTPS. Caché local aislada por Mod ID con hash SHA-256.
- DownloadManager: Singleton con executor de 2 hilos. Transferencias NIO zero-copy en subprocesos de fondo sin penalizar rendimiento.
- Motor de Audio (OpenAL):
OpenALAudioSinkpara reproducción de audio con 8 buffers streaming y tracking de tiempo de reproducción por muestra. Integrado al ciclo de vida de la GUI. - GuiVideo - Decoder Dual: FFmpegProcessDecoder (nativo) como decodificador primario. JCodecVideoDecoder (pure-Java) como respaldo automático para Android (PojavLauncher) y sistemas sin ejecución de procesos.
- GuiImage/GuiVideo: Soporte para canal alfa (
setAlpha()) y tintes de color (setColor(r, g, b)).
Interfaz y Componentes
- Rediseño de la API Pública: Métodos renombrados para desvinculación de Mojang:
update()→tick(float),drawSelf()→renderSelf(int, int, float),mouseClicked→onMouseClick. - Sistema de Layout Optimizado: Flags
requestLayout()yrequestRender()para evitar recálculos costosos al mutar propiedades puramente visuales. - Insets: Clase inmutable para padding/margin con soporte asimétrico:
new Insets(top, right, bottom, left). - ITheme / DefaultTheme: Sistema de temas inyectable por componente. Estilos no son globales.
DefaultTheme提供 tema oscuro con colores Material Design. - GuiBuilder<T>: API fluent para construcción declarativa de componentes con chainable setters.
- Tooltips Nativos: Sistema de tooltips reescrito utilizando
GuiPaneldirectamente. Resolución por cadena de padres. Soporte para texto y componentes personalizados. - GuiDropdown<T>: Selector genérico con popup, enlace reactivo a
State<T>, y renderizado fuera de scissor. - GuiVirtualList<T>: Lista virtualizada que solo instancía componentes visibles en el viewport. Ventana/reciclaje automático al hacer scroll.
Layout y Eventos
- FlexLayout: Motor de layout tipo CSS Flexbox. Direcciones VERTICAL, HORIZONTAL, ABSOLUTE. Soporte para
gap,flexWrap,paddingymargin. - Propagación de Eventos: Iteración en orden inverso de render (componente de mayor capa primero). Retorno
truedetiene la propagación. - Gestión de Foco: Modelo de foco único almacenado en el componente raíz.
requestFocus(),clearFocus(),isFocused(). - Sistema de Capas: Componente
layerentero para orden Z. Los hijos se renderizan en orden ascendente de capa.
Multimedia y Decodificación
- API IMediaService: Servicio inyectable para pre-carga temprana (
preload) y evaluación perezosa (streamAsync) de medios. Reemplaza accesos estáticos rígidos para mayor escalabilidad. - DirectMemoryVideoDecoder (Zero-Copy): Decodificador de vídeo que mapea la salida en crudo de FFmpeg directamente a la memoria nativa (
DirectByteBuffer). Evita la instanciación de fotogramas en el Heap de Java, logrando 0 MB de overhead para el Garbage Collector y permitiendo resoluciones de hasta 1280x720 sin colapsar la RAM de Minecraft. - JCodecVideoDecoder: Decodificador pure-Java usando
H264Decoderde JCodec. Demuxing MP4, decodificación de NALs H.264, conversión YUV420 a ARGB. Fallback automático para Android (PojavLauncher). - GuiVideo - Optimización de GPU: Lógica de omisión de renderizado. Solo se envía la textura a OpenGL cuando el tiempo del fotograma (PTS) difiere del anterior, reduciendo drásticamente el ancho de banda del PCIe.
- MediaPlayer: Orquestador de reproducción con reloj maestro de audio y fallback a reloj del sistema.
Estado de Desarrollo
- GuiModelRender, GuiVideo, Sincronización Servidor-Cliente: Estos componentes se encuentran en una fase muy temprana de desarrollo. Su API es inestable y puede cambiar sin previo aviso en futuras versiones.
[/ES]
[EN]
Architecture & Security (Client/Server)
- Strict Client/Server Separation: Refactored package hierarchy. Interfaces in
api.client.*, implementations inimpl.client.*. PreventsClassNotFoundExceptionon Dedicated Servers. - State<T>: Relocated to
com.x4yi.x4ui.commonfor safe server-side usage. UsesCopyOnWriteArrayListand value deduplication viaObjects.equals(). - NetworkSyncHelper: Binds
Containerproperties (viaIContainerListener) toState<Integer>,State<Boolean>, andState<Float>objects with configurable scale.
Assets & Multimedia
- RemoteResourceManager: Asynchronous media downloading from HTTP/HTTPS URLs. Local cache isolated by Mod ID with SHA-256 hashing.
- DownloadManager: Singleton with 2-thread executor pool. NIO zero-copy transfers on background threads without impacting game performance.
- Audio Engine (OpenAL):
OpenALAudioSinkfor audio playback with 8-buffer streaming and per-sample playback time tracking. Integrated with GUI lifecycle. - GuiVideo - Dual Decoder: FFmpegProcessDecoder (native) as primary decoder. JCodecVideoDecoder (pure-Java) as automatic fallback for Android (PojavLauncher) and systems without process execution.
- GuiImage/GuiVideo: Alpha channel support (
setAlpha()) and color tinting (setColor(r, g, b)).
Interface & Components
- Public API Redesign: Renamed methods for Mojang decoupling:
update()→tick(float),drawSelf()→renderSelf(int, int, float),mouseClicked→onMouseClick. - Optimized Layout System:
requestLayout()andrequestRender()flags to avoid expensive recalculations when mutating purely visual properties. - Insets: Immutable class for padding/margin with asymmetric support:
new Insets(top, right, bottom, left). - ITheme / DefaultTheme: Injectable theming system per component. Styles are no longer global.
DefaultThemeprovides a dark theme with Material Design colors. - GuiBuilder<T>: Fluent API for declarative component construction with chainable setters.
- Native Tooltips: Tooltip system rewritten using
GuiPaneldirectly. Resolution via parent chain. Support for text and custom component tooltips. - GuiDropdown<T>: Generic selector with popup, reactive binding to
State<T>, and rendering outside scissor bounds. - GuiVirtualList<T>: Virtualized list that only instantiates components visible in the viewport. Windowing/recycling during scroll.
Layout & Events
- FlexLayout: CSS Flexbox-like layout engine. VERTICAL, HORIZONTAL, ABSOLUTE directions. Supports
gap,flexWrap,padding, andmargin. - Event Propagation: Reverse render order iteration (highest-layer component first). Returning
truestops propagation. - Focus Management: Single-focus model stored on root component.
requestFocus(),clearFocus(),isFocused(). - Layer System: Integer
layerproperty for Z-ordering. Children render in ascending layer order.
Multimedia & Decoding
- IMediaService API: Injectable service for ahead-of-time preloading (
preload) and lazy evaluation (streamAsync) of media assets. Replaces rigid static registries for better scalability. - DirectMemoryVideoDecoder (Zero-Copy): Video decoder that maps FFmpeg's raw output directly into native memory (
DirectByteBuffer). Bypasses Java Heap frame instantiation, achieving 0 MB GC overhead and supporting up to 1280x720 resolutions without crashing Minecraft's RAM limit. - JCodecVideoDecoder: Pure-Java decoder using JCodec's
H264Decoder. MP4 demuxing, H.264 NAL decoding, YUV420 to ARGB conversion. Automatic fallback for Android (PojavLauncher). - GuiVideo - GPU Optimization: Render-skipping logic. The texture is only dispatched to OpenGL when the frame time (PTS) differs from the previous one, drastically reducing PCIe bandwidth usage.
- MediaPlayer: Playback orchestrator with audio master clock and system clock fallback.
Development Status
- GuiModelRender, GuiVideo, Server-Client Sync: These components are in a very early stage of development. Their API is unstable and may change without notice in future versions.
[/EN]
X4UI r1.0b3a
X4UI r1.0b3a
date: 2026-08-28
[ES]
Bug Fixes
- Sliders: Corregido un bug donde hacer click en el campo de texto de un slider antes del primer frame renderizado no permitía editar el valor. Adicionalmente se ha solucionado el problema de pérdida de foco y escritura cuando existen múltiples sliders en pantalla (ahora sólo puede haber un campo de texto activo globalmente).
- Scroll Panels (Estructural): Se arregló un bug severo en
GuiScrollPaneldonde los eventos de teclado (keyTyped) y el arrastre prolongado del ratón (mouseClickMoveymouseReleased) nunca se propagaban a los hijos del panel interno debido a una lista de renderizado vacía. Esto soluciona por completo la imposibilidad de usar el teclado en los campos de texto o arrastrar correctamente los sliders fuera de los márgenes del scroll.
[/ES]
[EN]
Bug Fixes
- Sliders: Fixed a bug where clicking a slider's text field before the first rendered frame prevented value editing. Additionally, resolved an issue where multiple slider text fields could be focused simultaneously, causing typing input to be redirected to off-screen sliders. Focus is now managed globally.
- Scroll Panels (Structural): Fixed a severe bug in
GuiScrollPanelwhere keyboard events (keyTyped) and prolonged mouse dragging (mouseClickMoveandmouseReleased) were never propagated to the internal panel's children due to an empty render list. This completely resolves the inability to use the keyboard in text fields or drag sliders correctly outside the scroll margins.
[/EN]
X4UI r1.0b3
X4UI r1.0b3
[ES]
Resumen de Cambios
Actualización de la arquitectura interna de renderizado y eventos, introduciendo soporte nativo de Z-Index, interpolaciones basadas en DeltaTime, y gestión segura de recortes OpenGL anidados, además de una gran cantidad de nuevos componentes interactivos.
Arquitectura y Núcleo
- Soporte Z-Index: Implementada la propiedad
layerpara componentes, proporcionando un ordenamiento determinista para el renderizado y la propagación de eventos (bubbling). - Animaciones DeltaTime: Integrada lógica de DeltaTime en todo el framework para lograr animaciones e interpolaciones independientes de los FPS.
- Seguridad de Memoria: Implementado
FontWidthCachecon política de limpieza LRU para mitigar fugas de memoria durante el análisis de textos complejos (ej. Markdown). - Recorte OpenGL Anidado: Implementado
ScissorHelperpara gestionar de manera robusta el uso deGL_SCISSOR_TESTen componentes anidados. - Construcción Fluida: Añadida la clase de utilidad
GuiBuilderque proporciona una API fluida (Fluent API) para facilitar la construcción de interfaces. - Reactividad: Integrado un sistema de gestión de estado reactivo (
State).
Componentes y Funcionalidades
- Arrastrar y Soltar (Drag & Drop): Añadida capacidad de arrastre nativa a
GuiComponentcon límites configurables (DragConstraint.NONE,DragConstraint.PARENT_BOUNDS). - Tooltips Integrados: Añadido soporte nativo de renderizado de Tooltips en
GuiBaseScreenyGuiBaseContainermediantesetTooltip(). - Diseños FlexWrap: Añadida la funcionalidad
flexWrapaGuiPanelpara el ajuste automático y multilínea de elementos en diseños horizontales y verticales. - Nuevos Componentes:
GuiDropdownpara menús desplegables.GuiImageyGuiSpritepara la renderización flexible de texturas.GuiTextInputpara campos de entrada de texto avanzados.GuiSlotpara gestionar inventarios y stacks de ítems dentro del DOM.GuiSlidery sus variantes (GuiSliderDouble,GuiSliderFloat,GuiSliderInt).GuiModelRenderpara soporte de renderizado de entidades 3D e ítems.GuiVideopara reproducción de vídeo in-game.
Mejoras y Correcciones
- Refactorización de GuiScrollPanel:
- Migración a
ScissorHelperpara la resolución adecuada de recortes anidados. - Implementado descarte de componentes (culling) para omitir la renderización y procesamiento de eventos de elementos fuera del área visible.
- Resueltos los problemas de jerarquía de propagación de eventos, permitiendo que los paneles de scroll anidados funcionen correctamente y de manera independiente.
- Migración a
- Solucionada la fuga de memoria en
GuiBaseContainercausada por la adición duplicada de áreas enjeiRecipeAreasal redimensionar la ventana. - Refactorizado
GuiMarkdownpara utilizarFontWidthCache, mejorando notablemente el rendimiento. - Estandarizadas las animaciones en
GuiButton,GuiToggleyGuiScrollPanelpara escalar con DeltaTime en lugar de ticks en crudo. - Expuestos los métodos
getGuiLeft()ygetGuiTop()enGuiBaseContainer. - Reestructurada y completada la documentación técnica en el directorio
Docs/(Disponible en inglés y español).
[/ES]
[EN]
Changelog Summary
Core rendering and event architecture update, introducing native Z-Index support, DeltaTime-based interpolations, and safe management of nested OpenGL clipping, along with a massive batch of new interactive components.
Architecture & Core
- Z-Index Support: Implemented the
layerproperty for components, providing deterministic sorting for rendering and event bubbling priorities. - DeltaTime Animations: Integrated DeltaTime logic throughout the framework for FPS-independent animations and transitions.
- Memory Safety: Implemented
FontWidthCacheincorporating an LRU eviction policy to mitigate memory leaks during intensive text parsing tasks (e.g. Markdown rendering). - Nested OpenGL Clipping: Implemented
ScissorHelperto robustly manage nestedGL_SCISSOR_TESTapplications. - Fluent Construction: Added
GuiBuilderutility class providing a fluent API to streamline interface construction. - Reactivity: Integrated a reactive
Statemanagement system.
Components & Features
- Drag & Drop: Added native drag-and-drop capability to
GuiComponentwith flexible boundaries (DragConstraint.NONE,DragConstraint.PARENT_BOUNDS). - Native Tooltips: Added internal Tooltip rendering support to
GuiBaseScreenandGuiBaseContainerviasetTooltip(). - FlexWrap Layouts: Added
flexWrapfunctionality toGuiPanelfor automatic multi-line wrapping of elements in horizontal and vertical configurations. - New Components:
GuiDropdownfor standard dropdown menu structures.GuiImageandGuiSpritecomponents for flexible texture and sprite rendering.GuiTextInputfor advanced text input fields.GuiSlotcomponent to integrate and manage item stacks and inventories within the DOM.GuiSliderarchitecture with specific implementations (GuiSliderDouble,GuiSliderFloat,GuiSliderInt).GuiModelRenderto support 3D entity and item rendering directly inside the user interface.GuiVideofor in-game video playback support.
Fixes & Improvements
- GuiScrollPanel Refactor:
- Migrated from raw GL calls to
ScissorHelperfor proper nested clipping resolution. - Implemented strict component culling to skip rendering and event processing for elements outside the visible viewport.
- Resolved event bubbling hierarchy issues, enabling nested scroll panels to function correctly independently of parent containers.
- Migrated from raw GL calls to
- Resolved memory leak in
GuiBaseContainercaused by duplicate instances appending tojeiRecipeAreasupon window resize. - Refactored
GuiMarkdownto utilizeFontWidthCachefor significantly improved parsing and rendering performance. - Standardized animations in
GuiButton,GuiToggle, andGuiScrollPanelto scale consistently with DeltaTime instead of raw ticks. - Exposed
getGuiLeft()andgetGuiTop()withinGuiBaseContainerfor external utility consumption. - Restructured and populated the
Docs/directory with comprehensive technical documentation in English (en-us) and Spanish (es-latam).
[/EN]
X4UI r1.0b2
X4UI r1.0b2
[ES]
Cambios
- Añadidos métodos
getHeight()ygetWidth()enGuiComponentpara permitir acceso externo a sus atributos de dimensión que estaban protegidos, facilitando la interpolación y creación de animaciones personalizadas desde implementaciones externas.