Componentes Visuales

Elementos creados simplemente para mostrar información en pantalla.

GuiLabel

Dibuja un texto simple de una sola línea.

Uso

No necesitas decirle el ancho exacto; el texto calcula su propio tamaño automáticamente.

GuiLabel cordY = new GuiLabel(0, 0, "Coordenada Y: 64", 0xFF00FF00); // Texto verde
cordY.setCentered(true);

Si usas setCentered(true), el texto se dibujará centrado horizontalmente desde la coordenada que le diste.

GuiSprite

Dibuja imágenes (texturas).

Bordes Inteligentes (9-Slice)

Normalmente, si estiras una imagen en Minecraft, los bordes se deforman y se ven borrosos o alargados. GuiSprite soluciona esto permitiéndote definir esquinas estáticas.

ResourceLocation textura = new ResourceLocation("mimod", "textures/gui/panel_maquina.png");
GuiSprite fondo = new GuiSprite(x, y, anchoMenu, altoMenu, textura, 256, 256);
fondo.setSliceSize(8); // Mantener 8 píxeles de los bordes sin estirar

Esto estirará solo el centro de la imagen, manteniendo los bordes perfectos sin importar de qué tamaño sea el menú.

GuiModelRender

Dibuja un modelo 3D (como un jugador o un mob) o un ítem en pantalla.

Controles

GuiModelRender mr = new GuiModelRender(x, y, ancho, alto);
// Muestra a un Creeper o la entidad que necesites
mr.setEntity(new EntityCreeper(Minecraft.getMinecraft().world)); 
mr.setScale(30f); // Tamaño del modelo en el menú
mr.setAllowDragRotation(true); // Permite al usuario rotarlo con el ratón
mr.setLookAtCursor(true); // Hace que la cabeza del modelo siga al ratón

Este componente se encarga de todo de manera segura: la iluminación, la rotación, y evita que se rompa el cuello del modelo real cuando cierras el menú.

GuiSlot

Es un puente especial que sirve para que puedas usar Slots reales de Minecraft dentro de un menú de X4UI.

Normalmente los slots son difíciles de mover en Vanilla, pero si metes un GuiSlot dentro de un GuiPanel, X4UI se encargará de mover el slot real a las coordenadas exactas de la pantalla para que funcione perfectamente con tu layout.

GuiImage

Muestra una imagen desde un ResourceLocation o la descarga desde una URL con caché en disco.

Uso

// Desde un ResourceLocation
GuiImage img = new GuiImage(x, y, 64, 64);
img.setResource(new ResourceLocation("mimod", "textures/gui/logo.png"));

// Desde una URL (se almacena en caché automáticamente)
GuiImage avatar = new GuiImage(x, y, 32, 32);
avatar.setUrl("https://ejemplo.com/avatar.png");

// Con mapeo UV (mostrar una porción de la textura)
GuiImage crop = new GuiImage(x, y, 16, 16);
crop.setResource(texture);
crop.setUV(0.0f, 0.0f, 0.5f, 0.5f); // Cuarto superior izquierdo

GuiVideo

Un componente de reproductor de video simulado. Extiende GuiImage y muestra una superposición de play/pause con una barra de progreso. Actualmente es un placeholder para soporte de video real en el futuro.

Uso

GuiVideo video = new GuiVideo(x, y, 200, 150);
video.setVideoUrl("https://ejemplo.com/intro.mp4");
video.play();

// El toggle play/pause al hacer clic es automático

Visual Components

Elements created simply to display information on the screen.

GuiLabel

Draws a simple single-line text.

Usage

You don’t need to specify the exact width; the text calculates its own size automatically.

GuiLabel cordY = new GuiLabel(0, 0, "Y Coordinate: 64", 0xFF00FF00); // Green text
cordY.setCentered(true);

If you use setCentered(true), the text will be drawn horizontally centered from the coordinate you provided.

GuiSprite

Draws images (textures).

Smart Borders (9-Slice)

Normally, if you stretch an image in Minecraft, the borders get deformed and look blurry or stretched out. GuiSprite solves this by letting you define static corners.

ResourceLocation texture = new ResourceLocation("mymod", "textures/gui/machine_panel.png");
GuiSprite background = new GuiSprite(x, y, menuWidth, menuHeight, texture, 256, 256);
background.setSliceSize(8); // Keep 8 pixels of the borders unstretched

This will only stretch the center of the image, keeping the borders perfect no matter what size the menu is.

GuiModelRender

Draws a 3D model (like a player or a mob) or an item on the screen.

Controls

GuiModelRender mr = new GuiModelRender(x, y, width, height);
// Shows a Creeper or whatever entity you need
mr.setEntity(new EntityCreeper(Minecraft.getMinecraft().world)); 
mr.setScale(30f); // Model size in the menu
mr.setAllowDragRotation(true); // Allows the user to rotate it with the mouse
mr.setLookAtCursor(true); // Makes the model's head follow the mouse

This component safely handles everything: lighting, rotation, and prevents breaking the real model’s neck when you close the menu.

GuiSlot

A special bridge that lets you use real Minecraft Slots inside an X4UI menu.

Normally, slots are hard to move in Vanilla, but if you put a GuiSlot inside a GuiPanel, X4UI will take care of moving the real slot to the exact screen coordinates so it works perfectly with your layout.

GuiImage

Displays an image from a ResourceLocation or downloads it from a URL with disk caching.

Usage

// From a ResourceLocation
GuiImage img = new GuiImage(x, y, 64, 64);
img.setResource(new ResourceLocation("mymod", "textures/gui/logo.png"));

// From a URL (automatically cached to disk)
GuiImage avatar = new GuiImage(x, y, 32, 32);
avatar.setUrl("https://example.com/avatar.png");

// With UV mapping (show a portion of the texture)
GuiImage crop = new GuiImage(x, y, 16, 16);
crop.setResource(texture);
crop.setUV(0.0f, 0.0f, 0.5f, 0.5f); // Top-left quarter

GuiVideo

A mock video player component. It extends GuiImage and shows a play/pause overlay with a progress bar. Currently a placeholder for future real video support.

Usage

GuiVideo video = new GuiVideo(x, y, 200, 150);
video.setVideoUrl("https://example.com/intro.mp4");
video.play();

// Toggle play/pause on click is automatic