EasyUIBuilder: Crea interfaces Bedrock sin escribir JSON

""EasyUIBuilder" es una pequeña herramienta de software diseñada para crear formularios UI JSON más rápidamente en Minecraft Bedrock Edition!"<\/p> Refaltor77\/EasyUIBuilder · github.com<\/a><\/cite> <\/blockquote>

⭐ 104 estrellas<\/span>💻 PHP<\/span>📄 MIT<\/span><\/div> <\/div>

Si alguna vez has intentado crear una interfaz personalizada para un addon de Minecraft Bedrock o un paquete de recursos, conoces la frustración. Los archivos JSON UI son poderosos, pero también son verbosos, fáciles de romper y tediosos de escribir a mano. EasyUIBuilder resuelve este problema permitiéndote generar UIs JSON de Minecraft Bedrock usando una API PHP fluida en lugar de codificar JSON desde cero.<\/p>

Qué hace EasyUIBuilder<\/h2>

EasyUIBuilder es una librería PHP (bajo licencia MIT, 104 estrellas en GitHub) que elimina la frustración de crear archivos JSON UI de Minecraft Bedrock Edition. En lugar de escribir o editar JSON manualmente, escribes código PHP legible y encadenable que genera definiciones UI válidas automáticamente.<\/p>

Seamos claros sobre lo que esto significa en la práctica. No estás reemplazando el sistema UI de Minecraft. Estás escribiendo una capa de código encima que genera los archivos JSON que tu addon necesita. Piénsalo como usar un framework CSS en lugar de escribir todos tus estilos a mano. La salida es JSON estándar compatible con Bedrock, pero nunca tienes que tocarlo directamente.<\/p>

Esto importa porque Bedrock UI JSON es complejo. Un botón simple necesita declaraciones de vinculación, definiciones de control, animaciones, cálculos de desplazamiento y especificaciones de color. Encadena cinco botones y tendrás cientos de líneas de JSON. EasyUIBuilder reduce eso a un puñado de líneas de código legibles y reutilizables.<\/p>

---

Por qué usarías esto (casos de uso)<\/h2>

Los desarrolladores de addons que construyen cualquier cosa con UIs personalizadas se benefician más. Esto incluye pantallas de gestión de inventario, sistemas de tienda, paneles de configuración y menús de juego. Si tu addon necesita que los jugadores vean o interactúen con algo más allá de comandos de chat básicos, estás construyendo una UI.<\/p>

Pero no son solo addons. Los administradores de servidores que crean herramientas de servidor, plugins de lanzador o paneles de gestión pueden usar EasyUIBuilder para generar los componentes UI que necesitan sin luchar contra JSON sin procesar. Si estás distribuyendo tu addon en servidores usando herramientas como nuestro DNS gratuito de Minecraft<\/a> o gestionando el acceso de jugadores con un Creador de lista blanca<\/a>, las UIs personalizadas suelen venir después.<\/p>

La mayor ventaja es para los equipos. Cuando las definiciones de UI viven como código en lugar de JSON, se integran con control de versiones, revisiones de código y pruebas automatizadas. Tu equipo puede refactorizar, documentar y colaborar en UI sin fusionar manualmente objetos JSON anidados.<\/p>

---

Comenzar: Instalación y configuración<\/h2>

Necesitarás PHP 8.0 o superior. Si estás gestionando dependencias de PHP con Composer (deberías hacerlo), la instalación es una línea:<\/p>

bash<\/span><\/div>

composer require refaltor\/easy-ui-builder<\/code><\/pre><\/div>

Sin dependencias del sistema, sin herramientas externas. Después de eso, importas la librería en tu código y comienzas a construir UIs. El hola mundo más rápido se ve así:<\/p>

php<\/span><\/div>
use refaltor\\ui\\builders\\Root;
use refaltor\\ui\\elements\\Label;
use refaltor\\ui\\colors\\BasicColor;

$root = Root::create("my_namespace");
$root->addElement(
 Label::create("hello", "Hola Minecraft!")
 ->setFontSize(Label::FONT_EXTRA_LARGE)
 ->setShadow()
 ->setColor(BasicColor::yellow())
);
$root->generateAndSaveJson("ui\/my_screen.json");<\/code><\/pre><\/div>

Ese código crea un elemento de texto etiquetado, lo colorea de amarillo con una sombra y escribe el archivo JSON en tu paquete de recursos. No se requiere edición manual de JSON.<\/p>


Características clave que importan<\/h2>

API Fluida<\/h3>

Cada elemento soporta encadenamiento de métodos. Creas un elemento y llamas métodos como ->setColor(), ->setSize(), ->setVisible() y así sucesivamente. Se lee como una oración y no tienes que preocuparte por la sintaxis JSON. La librería maneja comillas, llaves, anidación y validación.<\/p>

Animaciones y vinculaciones<\/h3>

Las UIs de Bedrock pueden animar (desvanecimiento, deslizamiento, cambios de color) y vincularse a variables (mostrar este elemento cuando la salud del jugador es baja). EasyUIBuilder incluye más de 30 funciones de suavizado de animación y un sistema de vinculación completo para diseños específicos de plataforma y visibilidad condicional. Declaras esto en código en lugar de estructuras JSON sin procesar.<\/p>

Validación automática<\/h3>

La librería valida el JSON generado contra el esquema de UI de Bedrock automáticamente. Y esto detecta errores temprano en lugar de permitir que fallen silenciosamente en tiempo de ejecución. Si intentas establecer un valor de color inválido o una propiedad requerida faltante, la librería te lo dice antes de escribir el archivo.<\/p>

Utilidades de color<\/h3>

Colores predefinidos, conversión RGB, colores aleatorios, colores complementarios y generación de pasteles están todo integrado. No más buscar códigos hexadecimales o hacer matemáticas de color en tu cabeza.<\/p>

Componentes de utilidad<\/h3>

Elementos comunes como botones de cierre y representaciones de jugadores vienen pregenerados. Mira, no reinventas la rueda para patrones que cada addon necesita.<\/p>


Errores comunes y consejos<\/h2>

Una cosa que sorprende a los usuarios nuevos: la salida es JSON, no objetos PHP. Llamas ->generateAndSaveJson() y escribe en disco. No estás manipulando la UI en tiempo de ejecución en el código de tu addon. La librería es una herramienta de tiempo de construcción que genera los archivos que tu addon consume.<\/p>

La sintaxis del sistema de vinculación toma un minuto para entender. Hay vinculaciones globales, vinculaciones de vista, vinculaciones de colección y vinculaciones de visibilidad. Cada tipo sirve un propósito diferente. El README cubre esto y vale la pena leer esas secciones cuidadosamente antes de tu primer panel complejo.<\/p>

Los suavizados de animación tienen nombres específicos (exponential_in, cubic_out, elastic_loop, etc.). Si codificas nombres de animación, fallarán silenciosamente si cometes un error tipográfico. Usar los métodos de clase constante es más seguro.<\/p>

Las rutas de archivo son relativas a dónde se ejecuta tu script PHP. Si estás automatizando compilaciones de UI en una tubería CI\/CD, obtén el directorio de trabajo correcto o tus archivos terminarán en lugares inesperados.<\/p>


Cómo se ven las alternativas<\/h2>

Podrías escribir el JSON a mano. Eso funciona, pero es más lento y propenso a errores. Estás gestionando sangría, comillas y reglas de sintaxis manualmente. Para UIs complejas con múltiples pantallas, te encontrarás copiando y pegando bloques grandes y luego editando cuidadosamente cada uno. Es el flujo de trabajo que EasyUIBuilder fue construido para reemplazar.<\/p>

Algunos desarrolladores usan editores de texto con validación de esquema JSON. Eso ayuda a detectar algunos errores, pero aún estás escribiendo mucho código estándar. Los marcos de definición de UI para otros juegos (Unity, Unreal) ofrecen enfoques de generación de código similares, y EasyUIBuilder trae esa conveniencia a Minecraft Bedrock.<\/p>

Para UIs simples únicas, la codificación manual no es un desastre. Si estás construyendo un addon serio o manteniendo múltiples pantallas en un proyecto, la generación de código se amortiza rápidamente.<\/p>


Antes de que te sumerjas<\/h2>

Esta herramienta asume que ya entiendes conceptos de UI de Minecraft Bedrock: pantallas, paneles, botones, vinculaciones y la estructura general de lo que intentas construir. No es un diseñador visual. Aún necesitas saber qué elementos existen y cómo funcionan. Lo que te ahorra es escribir la sintaxis JSON y gestionar las partes repetitivas.<\/p>

Si estás construyendo un servidor con múltiples addons o distribuyendo herramientas que necesitan interfaces personalizadas, agregar un paso de compilación que genere UIs desde código vale el tiempo de configuración. Obtienes control de versiones, colaboración en equipo y menos errores de sintaxis.<\/p>Refaltor77\/EasyUIBuilder<\/a> - MIT, ⭐104


A dónde ir desde aquí<\/p>

Lee el código fuente en GitHub<\/a> (documentación, ejemplos y seguimiento de problemas)<\/li>
Explora problemas abiertos<\/a> para ver en qué está trabajando la comunidad<\/li>
Consulta versiones recientes<\/a> para la última compilación o registro de cambios<\/li>
<\/ul>
<\/div>