Expansión en profundidad y experiencia del agente — 2026-09-21
El código fuente actual contiene 5.488 declaraciones de herramientas. La tabla de
compatibilidad expone 5.016 herramientas en UE 4.27 y 5.488 en UE 5.8. La cobertura de
smoke creció de 2.800 a 5.016 declaraciones cubiertas, y quedan 480 SmokeSkip (antes 1.701).
Ocho kits recibieron una pasada completa en profundidad (nuevas clases temáticas, más herramientas
tipadas, más recetas); números de UE 5.8:
niagara: 149 → 327 (edición de stack/módulos, entradas enlazadas/dinámicas/de data interface,
event handlers, simulation stages, schemas tipados de renderers, escalabilidad, diff/validate).
ai (+ nuevo kit statetree): 160 → 257 en ai, más 52 en el nuevo kit statetree (que
ahora se encarga de la creación de State Trees, antes un marcador vacío ai.st_*): ciclos
completos de Blackboard/Behavior Tree, configuraciones de percepción, Smart Objects con
reserva/liberación de slots en PIE.
sequencer: 50 → 256 (tracks/secciones/claves tipadas por clase de track,
bindings/possessables/spawnables, cortes de cámara, carpetas, marcadores).
pcg: 152 → 234 (settings por tipo de nodo, parámetros e instancias de grafos, selectores de
atributos, inspección de datos, generación asíncrona).
landscape (+ nuevo kit water): 82 → 148 en landscape, más un nuevo kit water con 22
herramientas (los water bodies salieron de landscape a su propio kit): edit layers, splines,
grass, importación/exportación de weightmaps, operaciones de esculpido.
foliage: 110 → 184 (spawner procedural, datos personalizados por instancia, foliage
particionado de World Partition).
rig (Control Rig): 25 → 112 (jerarquía de huesos/controles/nulls, units del grafo, rigs
modulares, recetas FK/IK).
Experiencia del agente: checkpoints con rollback (edit.checkpoint_rollback), lotes atómicos
(edit.call_many con rollback completo si algo falla), imágenes _preview en las llamadas que
construyen contenido visual y una biblioteca de 19 workflows de principio a fin expuestos como
prompts MCP (consulta la página Workflows).
Carga segura: el plugin ahora funciona en proyectos sin los plugins opcionales del motor; los kits
que dependen de ellos (Niagara, PCG, StateTree, Water, Control Rig, Chaos Vehicles...) se cargan
de forma diferida y solo se activan cuando el plugin necesario está habilitado; lo comprueba
Tools/check_plugin_gating.py.
Regla de cero fallbacks silenciosos: un campo, parámetro o tipo que el motor en ejecución no
admite devuelve un error que indica el motor mínimo; nada se omite ni se adivina en silencio.
Correcciones de este ciclo de integración:
landscape: la creación de landscapes ahora funciona en 4.27, spline_apply edita el edit
layer correcto, se corrigieron remove_edit_layer y replace_layer_info en 4.27, la creación
con escala se admite a partir de 5.2 y el contenido de las capas se vuelca después de cada edición.
metasound: se corrigió una colisión de nombres en build_transient y se ajustó el resultado
que devuelven add-input/add-output/add-variable.
niagara: se corrigió la detección de wait_compile en 5.5+ y se reordenó el smoke de escalabilidad.
paper: se corrigió el formato del vector que devuelve sprite_find_alpha_bounds y se eliminó
un crash en flipbook_duplicate_keyframe.
model: se corrigió un crash en compact_material_ids.
umg: el mapa de GUIDs de widgets ahora se mantiene sincronizado correctamente en 5.6+.
vehicle: las herramientas de runtime ahora se niegan a ejecutarse sin una simulación
física/mecánica activa, y el vehículo de prueba ahora recibe una curva de torque.
camera: el smoke test ahora usa el selector class:.
anim: los linked anim layers ahora resuelven FunctionReference correctamente en 5.1+, y se
eliminaron todos los fallbacks en favor de búsquedas exactas de grafo/pin/state machine con
errores explícitos.
sequencer: la sección de corte de cámara ahora se crea en el camera cut track real, y se
corrigió el smoke del byte track.
asset: delete, delete_many y delete_folder ahora son NonUndoable, y eliminar y volver a
crear el mismo asset en una misma sesión ahora funciona (se limpia el historial de deshacer y las
referencias de World Partition).
edit: call_many y run_workflow atómicos ahora rechazan de entrada las herramientas
NonUndoable, y checkpoint_rollback informa complete: false después de una llamada NonUndoable.
nav: build ahora libera el bloqueo de build de navegación posterior a la carga de 5.8.
actor: rename/move_folder devuelven correctamente E_CONFLICT, y delete_folder vuelve a
eliminar la carpeta.
foliage: se añadió compatibilidad con los actores de foliage de World Partition a partir de 5.0.
data: se corrigió acquire_registry_item para que informe SmokeSkip.
workflows: se corrigieron los workflows day_night, impact_effect, orbit_shot y
terrain_with_foliage, y check_workflows ahora rechaza pasos principales NonUndoable.
herramientas: se añadieron smoke_per_kit.py y check_plugin_gating.py, y se corrigió la carga
de los kits que dependen de plugins (el error "module 'UeaKitAnim' could not be loaded" en
proyectos sin los plugins opcionales del motor).
Resultados de build y self-test: los builds pasan en UE 5.8 y 4.27. UE 5.8: 5.488 herramientas; self-test completo con 4.678 aprobadas y 0 fallidas, PIE con 301 aprobadas y 0 fallidas, barrido por kit de 55 kits sin crashes, 19/19 workflows y la integración de navegación aprobada. UE 4.27: 4.326 herramientas; self-test completo con 3.681 aprobadas y 0 fallidas, PIE con 253 aprobadas y 0 fallidas, barrido por kit de 50 kits sin crashes y 17 workflows aprobados (2 requieren UE 5). Los proyectos sin los plugins opcionales cargan sin errores de módulos (5.8: 5.030 herramientas activas; 4.27: 4.326).
Se implementaron los 23 dominios de la hoja de ruta: Niagara, AI, Navigation, PCG, Landscape, Foliage, Sequencer, Control Rig, GAS, Rendering, Lighting, Camera, World Partition, Physics, Audio, Data, Gameplay Tags, Networking, Project, Build, Debug, Tests e Import/Export.
Los kits grandes usan clases temáticas con schemas e implementaciones dedicados, además de shims de compatibilidad centralizados.
Totales validados: 2.727 herramientas en UE 4.27 y 3.020 herramientas en UE 5.8.
Builds completos aprobados en UE 4.27.2 y UE 5.8.2.
Corregido durante la validación: creación/compilación segura de Niagara, el controlador de jerarquía de Control Rig, fixtures de AI y Sequencer, schemas de UHT y ramas de API 4.27/5.x.
skel (158 herramientas, 153 en 4.27): huesos y huesos virtuales del esqueleto, sockets,
grupos de slots/curvas/blend profiles, modos de retarget, LODs/secciones/morph targets/pesos de
skin de skeletal meshes, fusión y exportación de mallas, physics assets (cuerpos, formas,
restricciones, perfiles), cloth.
anim (380 herramientas, 295 en 4.27): curvas/notifies/sync markers/root motion/compresión/
edición de fotogramas de animation sequences, montages/composites/blend spaces/pose assets,
grafos de anim Blueprint (nodos, state machines, transiciones, capas, bindings), IK
Rig/Retargeter (5.x), Pose Search/Chooser (5.4+), reproducción en PIE, auditorías por lotes.
umg (252 herramientas, 212 en 4.27): árbol/slots/propiedades de widget Blueprints,
animaciones de widgets, bindings/eventos, estilos y fuentes, Common UI (5.x), MVVM (5.1+),
instancias en PIE, render a PNG, ediciones por lotes.
Infraestructura: regla de orden de clases del self-test documentada en KIT_AUTHORING; el ciclo PIE
ahora también cubre anim y umg.
Total: de 2.314 herramientas en 4.27 a 2.540 en 5.8 (tabla en Compatibilidad).
1.3.0 — 2026-09-16 (kits component, material y mesh)
component (121 herramientas): componentes SCS (plantilla de Blueprint) y componentes de
instancia en actores del nivel, setters tipados por clase, transformaciones, propiedades de
física/colisión/renderizado, copia y sincronización entre ambos mundos, rig de prueba.
material (252 herramientas, 236 en 4.27): materiales, nodos de expresión del grafo, material
functions, material instances, material layers (5.x), 25 recetas que generan materiales completos
en una sola llamada.
mesh (155 herramientas, 123 en 4.27): importación de static meshes y configuración de build,
cadena de LODs, colisión, sockets, canales UV, fusión de mallas, Nanite en 5.x.
Total: de 1.654 herramientas en 4.27 a 1.750 en 5.8 (tabla en Compatibilidad).
Correcciones: los setters de parámetros de material instances ya no confían en el retorno siempre
falso del motor en SetMaterialInstance*ParameterValue; la caché de parámetros del material se
actualiza tras editar el grafo; level.repair_build_data_ids y reparación de GUIDs de build data
antes de los builds de iluminación/reflexiones; correcciones en 4.27 para las entradas de switch de
feature level/calidad del material.
1.2.0 — 2026-09-15 (World Building: kits level, actor y asset)
level (192 herramientas, 175 en 4.27): mapas y subniveles, capas, world settings, entorno
(sol, sky light, atmósfera, niebla, nubes, reflection captures, presets), post-proceso (volúmenes y
todos los grupos de configuración), splines y spline meshes, volúmenes de gameplay, build de
iluminación y Lightmass, navegación (build, agentes, nav links, consultas de rutas), World
Partition / data layers / level instances (5.x).
actor (197 herramientas, 196 en 4.27): consultas, spawn desde clases, Blueprints y assets,
transformaciones y alineación, propiedades y componentes en actores del nivel, attachment, carpetas
del outliner, grupos, selección, actores de malla (static, skeletal, instanced), decals, texto,
cámaras, ediciones masivas, exportación/importación de layouts, conversión a Blueprint, fusión de mallas.
asset (215 herramientas): las 90 herramientas de asset/importación salieron de edit a su
propio kit y ganaron 124 nuevas: colecciones, consultas profundas al asset registry y grafos de
dependencias, organización y nomenclatura masivas, paquetes y disco, control de versiones por
archivo, data tables / curvas / string tables / data assets, importación avanzada (FBX, texturas,
audio, glTF, Interchange).
Total: de 1.173 herramientas en 4.27 a 1.221 en 5.8 (tabla en Compatibilidad).
Self-test: 967 herramientas tienen argumentos de smoke; UE 5.8.2: 931 aprobadas, 0 fallidas; ciclo
PIE limpio. Bugs que detectó el self-test y que se corrigieron en esta versión: brush volumes creados
sin UModel (crash), fix_redirectors abría una ventana modal (el editor se colgaba), tracks de
timeline sin orden de visualización (crash en 4.27), actores creados sin componente raíz,
duplicación de mapas en 4.27.
Infraestructura: Tools/build_plugin.ps1, Tools/smoke_cycle.sh y Tools/check_smoke.py;
playbook y especificaciones por kit en Docs/dev/.
1.1.0 — 2026-09-15 (infraestructura para escalar)
Modo adaptativo (predeterminado):tools/list empieza con el núcleo (67 herramientas);
edit.recommend_kits, edit.enable_kits, edit.disable_kits y edit.list_active_kits activan
kits por sesión y emiten tools/list_changed. edit.search_tools, edit.get_tool_schema y
tools/call lo ven todo.
Metadatos por herramienta: riesgo 0–5 (MaxAutoRisk + "_confirm": true), plugins
necesarios, requisitos de PIE/mundo, dryRun, rango de motores, publicados en annotations.uea.
Envoltorio de respuesta:tool, engine, durationMs, transaction y changedAssets en
cada respuesta; claves en lowerCamelCase a cualquier profundidad.
Self-test:edit.self_test + Tools/uea_smoke.py --full (553 herramientas tienen argumentos
de smoke; UE 5.8.2: 513 aprobadas, 0 fallidas, 40 omitidas porque necesitan PIE; UE 4.27.2: 496
aprobadas, 0 fallidas).
El ciclo PIE (play.start → self-test → play.stop) se ejecuta en ambos motores sin crashes.
Herramientas que esperan fotogramas (play.start/stop, start_simulate, toggle_simulate,
tap_key, set_axis, mouse_delta, advance_frames, run_test(s), live_coding_compile) se
ejecutan fuera del game thread y nunca hacen tick del motor (los ticks anidados hacían fallar el
editor en 5.x).
Correcciones de runtime detectadas por el self-test: descubrimiento de kits después de que todos los
módulos se hayan cargado, lectura del log mientras el editor lo mantiene abierto, timelines creados
por la ruta propia del motor, nombre conservado por bp.set_component_class, bp.add_spawn_node
(orden de creación de pines), nodos direccionables por título además de por id.
Puerto predeterminado 9321 (http://127.0.0.1:9321/uea-mcp).
edit: 35 → 334 herramientas (prefijos edit., asset., import., object., play., view.,
console., render., log., settings., project., plugin.): assets, registry y
dependencias, factories, propiedades por reflexión en cualquier objeto, llamadas a funciones por
nombre, consola/cvars, viewport y selección, niveles, configuración/escalabilidad, plugins, tests de
automatización, Live Coding, control de versiones, llamadas por lotes (edit.call_many).
bp: 42 → 242 herramientas: creación completa de grafos (nodos tipados, pines, timelines, layout,
build_graph), miembros (variables locales, parámetros, macros, interfaces), clase/CDO,
diagnósticos de compilación, comparación, enums y structs, SCS/componentes, Gameplay Tags,
depurador (breakpoints, watches).
input: 23 → 126 herramientas: todos los modificadores/triggers tipados, configuración de
acciones/contextos, configuración de Player Mappable/configuración de usuario (5.3+),
InputSettings heredado, inyección y consultas en PIE, eventos de input en Blueprints, migración
de heredado → Enhanced.
Total: de 673 herramientas en 4.27 a 702 en 5.8 (tabla en Compatibilidad).