Trucos de Actor

Con el Parche 1.4.0, ahora los modders pueden usar trucos de actor para crear y manipular actores sobre la marcha mientras tienen ejecutado un mapa de prueba en el editor. Esto es útil para probar ideas rápidamente sin tener que configurar datos o ejecutar disparadores.

Los trucos también se pueden usar para modificar e inspeccionar casi cualquier actor mientras está abierto un mapa de prueba, lo cual puede ser útil para depurar problemas de actor en ejecución.

Los trucos se usan para enviar varios mensajes de volcado habilitados recientemente, como VolcadoAnimDB, VolcadoAnexo, VolcadoPropAnfitrión, VolcadoRef y VolcadoTextura. Estos mensajes les permiten a los modders inspeccionar algunos de los aspectos internos de ciertos actores con el juego funcionando, lo cual sirve como una herramienta de depuración adicional.

Conceptos sobre los trucos de actor

Nombre de referencia

El término “Nombre de referencia” es lo mismo que “Nombre de referencia de actor” en menos palabras: esto es un identificador particular de un tipo de variable de sistema conocido como la referencia de actor. Una referencia de actor se puede resolver en un actor específico, dependiendo de: 1) el significado del nombre de referencia y 2) el contexto en el que se usó. Los nombres de referencia se pueden usar en muchos trucos según se especifique. Su disponibilidad puede variar, según el contexto en el que se usen:

  • D - desde los (D)atos de actor
  • I - desde las funciones relacionadas con el actor en los d(I)sparadores
  • T - mediante los (T)rucos de actor

Los nombres de referencia disponibles actualmente son:

  • ::HoverTarget

T

El actor bajo el cursor del mouse.

  • ::LastCreated

DIT

Desde los disparadores, esto resuelve al último actor creado exitosamente mediante una función de disparador (pero no a través de ninguno de los otros medios, como ser mediante un mensaje en datos como resultado de un llamado de disparador). Desde cualquier otro punto, también incluye actores creados explícitamente mediante el mensaje Crear (esto es, Crear AlgúnActor). La idea es maximizar la consistencia en todas las distintas variaciones del mecanismo LastCreated ) en los disparadores mientras se sigue intentando adherirse a la regla de menor sorpresa en todos los demás lugares.

  • ::LastCreatedActual

DIT

El último actor creado exitosamente por el usuario mediante cualquier medio. Incluye actores creados por el mensaje Crear, creaciones de pedidos de actor o actores creados internamente por el sistema (como cuando CActorAcción crea squibs).

  • ::Main

DIT

El actor “principal” del alcance ::User.

    • Accesorio

El CActorAccesorio.

    • Unidad

El CActorUnidad.

    • El resto

El primer actor creado en el alcance.

  • ::PortraitGame

DIT

El actor principal para la ventana de retrato del juego, ahora mismo, sin importar lo que se seleccione.

  • ::PortraitGameSelf

DIT

El retrato del actor principal en este alcance de actor. Sirve para enviar mensajes desde cualquier actor en el alcance de una unidad a su actor de retrato. No devuelve nada si el retrato es para una unidad que no sea la actual.

  • ::Self

D

El actor que recibe un evento.

  • ::User

IT

Contiene los resultados del truco ActorFrom más reciente.

  • ::global.<RefName>

DIT

Una referencia de actor desde la tabla de referencia global.

  • ::scope.<RefName>

DIT

Una referencia de actor desde la tabla de referencia del alcance que la contiene.

  • ::actor.<RefName>

DIT

Una referencia de actor desde la tabla de referencia del actor que la contiene.

  • TargetKey

IT

El actor representado por la tecla desde el alcance ::User. Sólo devuelve el primero cuando hay múltiples resultados en el conjunto de resultados.


Nombre de referencia de ramas

Algunos trucos (como ActorEnviarA) soportan “nombre de referencia de ramas”, los cuales le permiten al usuario enviar mensajes de nombres de referencia que “le pertenecen” a un actor en particular (o sea, el truco requiere un actor para poder evaluar el nombre de referencia).

  • ::Creator

DIT

El creador del actor ::User.

  • Hosts

Un actor anfitrión es uno del cual un actor hereda datos, como orientación, propiedades alojadas, etc.

    • ::Host

DIT

El anfitrión principal. Se usa para orientación y propiedades alojadas.

    • ::HostImpact

DIT

Se usa para posicionar el punto de impacto de un rayo.

    • ::HostLaunch

DIT

Se usa para posicionar el punto de inicio de un rayo.

    • ::HostReturn

DIT

El anfitrión que usa un tentáculo como objetivo de su viaje de regreso.

    • ::Supporter

DIT

Se usa para conectar el tiempo de vida de un actor a un actor “sustentador” (típicamente se hace para configurar eventos que le dicen a un actor que muera cuando su actor sustentador haya muerto).


Nombre de referencia de alcance

Algunos trucos funcionan con alcances de actor. Hay variables de nombres de referencia de alcance que son similares a sus contrapartes de actor, excepto que evalúan los alcances de actor en lugar de los actores mismos.

  • ::Actor

IT

El alcance del actor ::User.

  • ::LastCreated

IT

El último alcance creado exitosamente por el usuario mediante un truco o código de cliente. Irrelevante desde los datos, ya que los datos no crean alcances.

  • ::PortraitGame

IT

El alcance de la ventana de retrato del juego.

  • ::Selection

T

El alcance de la unidad seleccionada. Devuelve un único alcance aun si se seleccionan múltiples unidades.

  • ::User

IT

Contiene el resultado del truco ActorScopeFrom más reciente. Se configura automáticamente con el valor ::ÚltimoCreado cuando esa referencia está poblada con un nuevo alcance de actor válido.


Teclas de contenido

Crea mensajes que utilizan entre 1 y 3 teclas de contenido. Esto le permite a los disparadores y trucos crear una variedad de instancias de actor más fácilmente, mediante los mismos datos que se ingresan pero con parámetros de “contenido” diferentes. Por ejemplo:

ActorCreateAt Model Hydralisk
ActorCreateAt Model Marine

Ambos trucos crean un CActorModel llamado “Modelo”. El primero lo crea con el activo “Hidralisco” y el segundo con el activo “Marine”. Los distintos tipos de actores soportan diferentes estilos de parámetro de creación diferentes según el caso. A continuación, hay una lista de actores que soportan parámetros de contenido y el orden en el que están especificados.


CActorBeam ModelLink RefLaunch RefImpact
  • ModeloEnlace – el nombre de la entrada Datosdemodelo usada para el rayo.
  • ReferenciaIniciar – el nombre de referencia usado para poblar el ::HostLaunch.
  • ReferenciaImpacto – el nombre de referencia usado para poblar el ::HostImpact.

CActorList RefName
  • NombreReferencia – el nombre de referencia de la fuente desde la que se puebla la lista.

CActorModel
  • ModeloEnlace – el nombre de la entrada Datosdemodelo a usarse para el modelo.
  • Variación – el número de variación específica para el modelo, si así se desea (si no, se elige aleatoriamente).

CActorSound
  • SonidoEnlace – el nombre del sonido a usarse.

CActorSplat
  • ModeloEnlace – el nombre de la entrada Datosdemodelo a usarse para el rayo.

Uso de los trucos de actor

El usuario puede ingresar trucos de actor en la línea de conversación con el mapa ejecutado desde el editor.

La salida va al registro Alert.txt, el cual se puede encontrar en el directorio del usuario “StarCraft II/GameLogs”. El registro Alert.txt tiene una marca de fecha y hora preañadida a su nombre de archivo; un ejemplo real tiene un nombre como este:"2011-08-08 10.30.05 Alerts.txt".

Actualmente no se soportan atajos, pero podrían agregarse en el futuro.

Lista de trucos de actor

En la sintaxis dada para cada comando, un parámetro rodeado por llaves {} denota un parámetro opcional. En la ejecución exitosa de algunos de estos trucos, se configuran dos variables globales, los valores “::User actor” y “::User scope”, sobre los que pueden actuar otros trucos. Los trucos que eliminan a los actores y a los alcances excluyen a esos actores y alcances que interrumpen a las unidades y efectos activos en el momento.

ActorCreateAt

Crea un actor en la ubicación especificada. Configura el ::User actor a este actor y el ::User scope a este alcance.

Este truco sirve para crear un actor en un mapa de prueba directamente, para poder observar sus propiedades e interactuar con él, sin tener que esperar a que el mapa se encuentre con una situación que crearía a dicho actor normalmente. Las coordenadas le permiten al usuario posicionar los actores precisamente para pruebas de combate y similares.


Sintaxis:
ActorCreateAtx,y actorNombre {contenidoNombre} {contenido2Nombre} {contenido3Nombre}


Ejemplos:

ActorCreateAt 50,50 Modelo Obrero ActorCreateAt 50,50 NexoFiguraPlana

Mensajes de Vuelco de Actor

El usuario puede enviar mensajes de volcado de actores a actores para obtener de ellos información de depuración útil.


AliasDump

Sintaxis:
AliasDump

Muestra todos los alias del actor asociadas con el actor en ese momento.


AnimDumpDB

Sintaxis:
AnimDumpDB

Muestra todas las animaciones disponibles para el modelo asociadas con el actor en ese momento. Muestra la duración de cada animación y si es una animación en bucle.


AttachDump

Sintaxis:
AttachDump

Muestra todos los puntos de anexión que existen en el modelo asociados con el actor en ese momento. También muestra las teclas de anexión y los volúmenes de anexión del objetivo especificados por el usuario, asociados con cada punto de anexión.


HostedPropDump

Sintaxis:
HostedPropDump IncludeChildren PropType

Muestra toda la información asociada con el PropAnfitrionada especificada si existe en el actor. Si el parámetro IncluirSecundario es 1, muestra la información para esa propiedad para el actor objetivo junto con todos sus secundarios.

Ejemplos:

HostedPropDump 0 TintColor
HostedPropDump 1 TeamColor


HostedPropDumpAll

Sintaxis:
HostedPropDumpAll IncludeChildren

Muestra toda la información asociada con todas las propiedades anfitrionadas que existen en el actor. Si el parámetro IncluirSecundario es 1, hace lo mismo también para todos los secundarios del actor objetivo.


RefDump

Sintaxis:
RefDump RefName

Muestra la información de depuración en el actor especificado por el NombreReferencia. Actualmente, esto funciona únicamente para referencias de actor en tablas de referencia del sistema, lo que significa que las referencias del formato ::actor.someUserRef, ::scope.someUserRef y ::global.someUserRef.


Ejemplos:

RefDump ::actor.someUserRef


RefTableDump

Sintaxis:
RefDump RefTableType

Muestra la información de depuración en todas las referencias de actor en una tabla de referencias dada. El parámetro TablaReferenciaTipo detecta mayúsculas y espera los símbolos Actor, Alcance o Global.


Ejemplos:

RefDumpAll Actor


TextureDump

Sintaxis:
TextureDump

Muestra todas las texturas que usa el modelo asociadas con el actor objetivo en ese momento. Indica cuáles están asociadas con casilleros de texturas y si fueron intercambiadas y reemplazadas por otras texturas dinámicas.


TextureDumpDB

Sintaxis:
TextureDumpDB

Muestra todas las texturas disponibles para intercambio dinámico de texturas en el modelo asociado con el actor objetivo.

Cargando comentarios…

Ocurrió un error al cargar los comentarios.