La interfaz del juego, gobernada por un solo recurso

Cómo se ve dentro de un juego

Los preajustes medieval y de ciencia ficción — hojas de personaje, inventarios y misiones; formularios, cuadrículas y tarjetas de pregunta; paneles angulares y controles táctiles. Cambiar de preajuste es una línea de código.

Los seis preajustes y cómo cambiar entre ellos →

De qué se encarga por ti

Lo que más tiempo cuesta en la interfaz de un juego no es la forma de un botón: es todo lo que se desajusta de un dispositivo a otro. gohud resuelve ese desajuste en un único lugar.

Cambia el aspecto — colores y forma

Un Theme solo puede reestilizar lo que dibuja el motor. Las esquinas redondeadas son las únicas que tiene StyleBoxFlat, y el joystick, las ranuras rápidas y la marca guía los dibuja el código — así que un tema por sí solo jamás puede cambiar su forma. Por eso gohud incluye preajustes: un tema, un skin y un juego de iconos elegidos como una sola unidad.

GoUi.use_preset(GoThemePresets.MEDIEVAL_DARK)   # tema, skin e iconos a la vez

Esas cuatro son la misma pantalla de la galería. No cambia ni una línea de código — solo el nombre del preajuste. Las esquinas de los botones, la forma de los interruptores, las filas de lista y los bordes de los campos se mueven juntos.

Colección medieval

medieval_dark combina hierro y cuero con oro antiguo; medieval_light usa pergamino y tinta. Los marcos de menú llevan un remache y un pequeño ornamento en la esquina, mientras que el HUD siempre visible se mantiene discreto; 16 iconos grabados redibujan los nombres de objeto, y solo los títulos y subtítulos usan la fuente Cinzel incluida.

Ambas capturas son examples/medieval/medieval.tscn, construido con los widgets estándar. La guía medieval y cómo crear tu propio reino →

La misma pantalla en un teléfono y en un escritorio

Las capturas de la galería son un teléfono en vertical. Abajo está el mismo código a 1280×800 — el contenido se detiene en un ancho legible (480dp) y se centra, mientras el HUD se queda en las esquinas. El formulario rodea las piezas flotantes del HUD, pero no se mueve cuando ya está despejado de ellas: empujarlo de todos modos dejaría el contenido descentrado en una pantalla ancha.

La misma hoja, otro aspecto

Elige uno en Ajustes del proyecto → gohud → Theme → Preset, o asigna GoConfig.preset. Rellenar theme, skin o icons de forma explícita tiene prioridad sobre el preajuste, así que puedes tomar un preajuste y sobrescribir solo uno de ellos.

Skins — allí donde un Theme no llega

Un skin gobierna el joystick, las caras de las ranuras rápidas, el anillo de la marca guía, los chips, los esqueletos, las alertas, los separadores y los encabezados de sección. Créale una subclase y sobrescribe solo lo que quieras cambiar.

class_name MySkin extends GoSkin

func slot_box(accent: Color, lit: bool) -> StyleBox:
    var box := GoStyleBoxCut.new()
    box.bg_color = accent
    box.cut = 6.0
    box.edge_color = accent
    return box

Las tres se serializan dentro de un recurso Theme — y eso es lo que permite que un tema cambie la forma, no solo el color. GoSkinSciFi y GoSkinMedieval son las subclases incluidas.

Widgets

Las piezas, en una sola tabla. Cada una en detalle →

Esperar, avisar, contar

Formularios y listas

Formas que los juegos usan de verdad

Por encima de la pantalla

La legibilidad se mide, no se calcula a ojo

"Bonito" es cuestión de gusto; "legible" se puede medir. Un texto gris tenue se ve bien en un buen monitor y desaparece en un teléfono a la luz del día — elegir a ojo lo garantiza tarde o temprano.

python3 addons/gohud/tools/check_contrast.py

Cada par de colores y la etiqueta de cada estado de botón sobre el panel en el que se apoya se mide contra la WCAG, en los seis temas. Los colores translúcidos se componen primero sobre su fondo real — medirlos directamente da una relación mejor que la que muestra la pantalla.

Por eso los colores de texto se derivan, no se eligen: el generador toma la entrada de la paleta como punto de partida y empuja su luminosidad hasta superar el umbral en toda superficie sobre la que pueda caer. Cambia la paleta y el contraste la sigue. Las reglas y las trampas que hay detrás →