kapy academy

Versiones y qué se rompe

7 min readUpdated ago 2026

Un objeto colocado conserva un enlace a la definición de la que salió, y esa definición puede cambiar por debajo. La primera fila del panel de la operación es Versión, y ahí decides si esta colocación sigue lo último que haga su autor o se queda en la publicación que tú probaste.

La versión es la primera fila del panel, por encima de todo lo que el objeto expone.
La versión es la primera fila del panel, por encima de todo lo que el objeto expone.

Elegir versión

Lo que ofrece esa fila depende de dónde venga el objeto.

Para un objeto de la tienda es un desplegable: Última, seguida de cada publicación aprobada como versión semántica, del tipo v1.2.3. Última no es una versión por sí misma. Se resuelve, cada vez que se pide el origen, a la publicación más alta que haya en ese momento.

Para un objeto local, uno tuyo, la fila es un rótulo fijo que dice Última. Los objetos locales no tienen historial de versiones. Una colocación de uno sigue siempre el último borrador que guardó su dueño, que es exactamente lo que quieres mientras estás desarrollando el objeto y exactamente lo que no puedes apagar cuando ya no lo estás.

La regla práctica: fija un objeto de la tienda a una versión explícita en cuanto la pieza donde está empiece a importar. Una publicación fijada es inmutable y se guarda en caché local, así que se construirá igual el mes que viene. Última y los borradores se piden siempre a la red y pueden cambiar sin que toques el archivo.

Recargar a mano

Cuando una colocación está en Última o en un borrador, el panel muestra una fila de acción, ↻ Actualizar a la última. Tira la copia cacheada del origen y reproduce todas las copias de la operación contra uno recién pedido.

Úsala cuando guardes un cambio en un objeto tuyo y la colocación en otro documento no se haya enterado, y cuando un origen no disponible pueda haber vuelto.

Cambiar el objeto

La versión no es lo único que puedes cambiar de una colocación. El objeto que lleva dentro se puede sustituir, y la colocación sobrevive al cambio: conserva la cara a la que está anclada y el ángulo al que la giraste.

Abre la operación desde la línea de tiempo para que salga su panel, y déjalo abierto. Entonces abre la ventana de SmartObjects y haz clic en otra tarjeta: ese clic rellena la colocación que tienes abierta en vez de empezar otra en otro sitio. No hay paso de confirmación ni aviso de deshacer. Es también la razón de que la ventana se vea más corta mientras tienes una operación abierta: todo lo que sigue enseñándote cabe en ese hueco.

Leer los estados

Cada copia de una colocación se reproduce por su cuenta e informa de su propio resultado: resuelta, fallida, pendiente o no disponible. Una copia puede estar en rojo mientras sus hermanas están bien, así que lee la lista de Copias antes de dar por rota la operación entera.

Qué te dice el panel
Mensaje Qué significa Qué hacer
Cargando el origen del objeto… Se está pidiendo la definición Espera. Acabará en una de las filas de abajo
Elige un objeto inteligente para rellenar esta colocación. La operación existe pero no tiene objeto dentro Elige uno en la ventana con la operación abierta
El origen de este objeto inteligente no está disponible; no se pueden editar los parámetros. (ámbar) No se ha podido traer la definición, así que la sección de parámetros se esconde Pulsa ↻ Actualizar a la última, o elige otra versión. Si el objeto venía de la tienda, puede que lo hayan retirado
No se pudo regenerar la colocación. (rojo) La definición cargó, pero la reproducción no dio geometría Deshaz el último cambio de parámetro o de posición, o reapunta la colocación a otra cara

Los errores que da la reconstrucción

Estos vienen de la reconstrucción, no del panel, y ocupan el mismo aviso rojo en lugar del mensaje genérico de arriba. Llegan sin traducir: el aviso pinta el texto tal y como lo devuelve la reconstrucción, así que los leerás en inglés aunque tengas la interfaz en español. Cada uno nombra una causa concreta.

Smart-object source is unavailable. La misma causa que el aviso ámbar: no se ha podido traer la definición.

Target body for smart-object placement is missing. El cuerpo al que estaba enganchada la colocación ya no existe. Se lo ha comido un booleano, o has borrado la operación que lo hacía. Apunta la colocación a un cuerpo que exista, o recupera el que quería. Trabajar con varios cuerpos explica por qué borrar una operación que fabrica cuerpos deja este tipo de agujero.

Smart-object replay failed: a TopoId could not be rebinded to the destination. Los pasos del objeto se refieren a una cara o una arista del anfitrión que ya no se reconoce, porque una operación por encima de la colocación ha cambiado la forma contra la que se construyó. Baja la colocación por debajo de ese cambio en la línea de tiempo, o vuelve a colocarla sobre la cara tal y como está ahora.

Smart-object placement must be created on a planar face. Se le ha pedido a un objeto de cadena sobre cara que se siente sobre algo curvo.

This smart-object host kind is not supported yet. El objeto se escribió contra un anclaje que esta versión no implementa. Nada de lo que cambies en tu documento lo arregla.

Error al cargar la fuente del objeto inteligente, como aviso emergente en el momento de colocar. Este sí sale en español, porque los avisos emergentes son el único sitio donde estos mensajes se traducen. La definición no llegó nunca, así que no se creó ninguna operación. No hay nada que limpiar; inténtalo otra vez.

A smart object cannot contain itself y Smart-object nesting is too deep. Estás colocando un objeto dentro del documento que lo define, o dentro de una cadena de objetos que ya es bastante larga. Saca un nivel de la cadena.

Cuando el objeto desaparece de la tienda

Una publicación retirada se cae del panel sin decir nada. Lo que ya tengas colocado sigue funcionando hasta la próxima vez que se pida su origen, y entonces informa de que no está disponible, no de que lo han quitado. El mensaje es el mismo que da un fallo de red, así que una colocación que no carga merece dos comprobaciones: prueba a actualizar, y si falla varias veces, abre la página de la tienda y mira si la publicación sigue ahí.

Este es el mejor argumento para fijar la versión. Una publicación fijada está cacheada, así que una colocación que ya ha construido una vez no queda a merced de una publicación ajena que no controlas.

Ver también

Discord