gohud

Tres capas

← Temas

Un preajuste agrupa las tres. Los campos que dejes vacíos recurren a los valores predeterminados.

CapaDecideCómo se cambia
Theme Colores, tamaños, escala de texto y la forma de todo lo que dibuja el motor — paneles de botón, campos de entrada, pestañas, gráficos de los interruptores Escribe un .tres, o genera uno con tools/make_theme.py
GoSkin La forma de todo lo que dibuja el código — el joystick, las caras de las ranuras rápidas, el anillo de la marca guía, los chips, los esqueletos, los separadores, los encabezados de sección Créale una subclase y sobrescribe solo los métodos que te importen
GoIconSet Iconos por nombre — 84 dibujos predeterminados, o los 16 dibujos grabados del juego medieval por encima de ellos. Un paquete de texturas o una fuente de iconos; el código que los llama es idéntico en ambos casos Proporciona un juego completo, o sobrescribe solo unos pocos nombres
Por qué un Theme por sí solo no basta. Redondeada es la única esquina que tiene StyleBoxFlat — pon el radio a cero y obtienes un ángulo recto; no hay nada intermedio. Esquinas cortadas en diagonal, un único borde engrosado, un resplandor exterior: el motor no dibuja ninguno de ellos. Y el joystick y la marca guía se dibujan en _draw(), donde un tema no llega en absoluto.

Cómo elegir uno

GoUi.use_preset(GoThemePresets.SCIFI_DARK)

Esa única línea cambia el tema, el skin y los iconos. Desde el editor, usa Ajustes del proyecto → Gohud → Theme → Preset; desde un recurso de configuración, GoConfig.preset.

Cómo conservar un campo propio

GoUi.use_preset(GoThemePresets.SCIFI_DARK)
GoUi.config.icons = my_icons     # tus iconos, y del preajuste todo lo demás

Asignar theme, skin o icons de forma explícita tiene prioridad sobre el preajuste.

Los seis preajustes incluidos

PreajustePanelesSkin · iconos
default_dark · default_lightPaneles StyleBoxFlat redondeados sobre una escala graduada de sombras; los botones primarios se elevan y se hunden al pulsarlosGoSkin · 84 iconos predeterminados
scifi_dark · scifi_lightPaneles GoStyleBoxCut achaflanados con borde de neón y resplandor; marcas de foco GoStyleBoxBracketGoSkinSciFi — joystick hexagonal · iconos predeterminados
medieval_dark · medieval_lightMarcos GoStyleBoxMedieval forjados — hierro y cuero, o pergamino — con remaches y ornamentos de esquina en los menúsGoSkinMedieval · 16 iconos grabados por encima de los predeterminados

Medieval: hierro, cuero y pergamino

medieval_dark combina hierro y cuero oscuros con oro antiguo. medieval_light usa pergamino y tinta. Ambos usan GoSkinMedieval, los widgets existentes y 16 iconos originales con detalles de grabado; los iconos de navegación recurren al juego original.

GoUi.use_preset(GoThemePresets.MEDIEVAL_DARK)
# O bien: GoUi.use_preset(GoThemePresets.MEDIEVAL_LIGHT)

Elige el preajuste antes de crear tu interfaz. Las sobrescrituras explícitas de GoConfig.theme, skin o icons siguen teniendo prioridad. Abre res://addons/gohud/examples/medieval/medieval.tscn y pulsa F6 para ver una hoja de personaje, un zurrón y un diario de misiones en funcionamiento. Sus botones alternan las variantes y abren el detalle de los objetos.

Interfaces medievales de hierro para personaje, inventario y misiones
Hierro y cuero
Interfaces medievales de pergamino para personaje, inventario y misiones
Pergamino y tinta

Los marcos de menú llevan un remache y un pequeño ornamento de esquina; el HUD siempre visible mantiene un borde discreto. La vida, el maná y la resistencia usan rellenos rojo, azul y oliva. Cinzel se limita a títulos y subtítulos; el texto del cuerpo conserva la fuente del proyecto anfitrión o la predeterminada. La fuente incluida trae su licencia en assets/fonts/cinzel/OFL.txt.

El juego grabado redibuja bag, book, box, coin, crown, flag, heart, key, map, potion, shield, star, sword y user, y añade scroll y seal. Cualquier otro nombre recurre al juego predeterminado, así que close y settings conservan sus dibujos predeterminados en todos los preajustes. Cinzel cubre el alfabeto latino; dale a los encabezados localizados una fuente propia a través de shape.fonts.

Qué verifica la batería de pruebas en ambas variantes. Que el skin medieval queda seleccionado; que los paneles de menú y de HUD son marcos forjados, con el ornamento solo en los menús; que los títulos usan Cinzel mientras el texto del cuerpo conserva la fuente heredada; que los iconos grabados se importan como DPITexture; que una ranura rápida real usa el skin; que cambiar los dials de un skin copiado llega a la ranura sin tocar el preajuste; y que al volver atrás se restaura la geometría predeterminada y la de ciencia ficción.

Crea un reino propio

python3 addons/gohud/tools/new_theme.py kingdom --from medieval_dark
# Edita themes/palettes/kingdom.json y luego:
python3 addons/gohud/tools/make_theme.py kingdom
godot --headless --path . --import
# En GDScript, antes de crear los widgets:
GoUi.use_preset(&"kingdom")

Los temas JSON pueden heredar de otros temas JSON. Los valores omitidos conservan los del padre; la herencia circular se rechaza. El preajuste generado conserva el juego de iconos de su padre.

AjusteEfecto
shape.material0: hierro · 1: cuero · 2: pergamino. Controla las marcas de la superficie.
shape.grain_alphaOpacidad de la textura. Usa 0 para una superficie limpia.
shape.ornament_scale · shape.bevel_strengthTamaño del ornamento de esquina del menú e intensidad del realce biselado.
shape.fontsAsigna los roles de título, subtítulo, leyenda, cuerpo y botón a archivos de fuente res:// locales del add-on. Los roles omitidos conservan su fuente heredada.
skin.dialsRadio de las ranuras rápidas, visibilidad de los remaches, grano y realce. La tabla completa de más abajo enumera cada dial.